Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/app/api-keys.mdx
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
---
title: API Keys
title: API Keys in the console
description: Creating, scoping, and revoking S3 access keys from the Fil One console.
---

**API Keys** in the left sidebar is where you create the S3 credentials your tools and code use.
**API Keys** in the sidebar is where you create the S3 credentials your tools and code use.

This page covers the console specifically. For what each permission allows, how signing works, and security guidance, see [API Keys](/security/api-keys) and [Authentication](/security/authentication).

Expand Down
8 changes: 4 additions & 4 deletions docs/app/billing.mdx
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
---
title: Billing
title: Billing in the console
description: Reading the Fil One billing page, adding a payment method, and finding your invoices.
---

Billing is a page of its own, at `/billing`. Open it from **Billing** in the **Organization** group of the left sidebar (see [Where to find the organization's pages](/app/organization#where-to-find-the-organizations-pages)).
Billing is a page of its own, at `/billing`. Open it from **Billing** in the **Organization** group of the sidebar (see [Where to find the organization's pages](/app/organization#where-to-find-the-organizations-pages)).

Billing is visible to **Owners** and **Admins**. Every action on it (choosing or changing a plan, adding or updating a card, opening the Stripe portal) is for **Owners** only, so an Admin sees the same figures without the buttons. Members and Read only users see "Billing is managed by your organization's owners and admins" instead. See [Roles and permissions](/app/organization#roles-and-permissions).

Expand Down Expand Up @@ -37,8 +37,8 @@ A banner above the cards flags a problem with the account:
| **This organization is read-only** (grace period) | **Choose a plan** |
| **This subscription is canceled** | **Reactivate** |

:::note A failed payment makes the dashboard read-only
When a payment fails, the dashboard becomes read-only. Check the banner and update your payment method to resume. See [Trial & Billing](/billing/trial).
:::note A failed payment makes the console read-only
When a payment fails, the console becomes read-only. Check the banner and update your payment method to resume. See [Trial & Billing](/billing/trial).
:::

## Usage
Expand Down
6 changes: 3 additions & 3 deletions docs/app/buckets.mdx
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
---
title: Buckets
title: Buckets in the console
description: Creating buckets, browsing objects, uploading, downloading, and sharing from the Fil One console.
---

**Buckets** in the left sidebar is where you create buckets and work with their contents without writing code.
**Buckets** in the sidebar is where you create buckets and work with their contents without writing code.

This page covers the console specifically. For the concepts, the S3 API equivalents, and code samples, see [Buckets](/storage/buckets), [Objects](/storage/objects), [Versioning](/storage/versioning), and [Object Lock](/storage/object-lock).

Expand Down Expand Up @@ -104,7 +104,7 @@ To bring an earlier version back as the current one, download it and upload it a

**Download** is available on each row in the object list and in the object detail header. It works on any plan, including the trial.

**Share object** generates a link anyone can open without an API key. Choose an expiry of **1 hour**, **24 hours** (the default), **3 days**, or **7 days**, then **Generate link**.
**Share object** generates a link anyone can open without an API key. Choose an expiry of **1 hour**, **24 hours** (the default), **3 days**, or **7 days**, then **Generate link**. To create a time-limited link from your own code instead, see [Presigned URLs](/storage/objects#presigned-urls).

Sharing is a paid-plan feature. During the trial the button is disabled, with a tooltip pointing to an upgrade.

Expand Down
8 changes: 4 additions & 4 deletions docs/app/dashboard.mdx
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
---
title: Dashboard
description: What the Fil One dashboard home page shows, and how to read its usage figures.
description: What the Dashboard, the Fil One console's home page, shows, and how to read its usage figures.
---

The dashboard at [app.filone.com](https://app.filone.com) is the home page of the console, reached from **Dashboard** at the top of the left sidebar. It summarises your plan, usage, and recent activity. A **New bucket** button sits in the header. During the trial, a **Free trial** banner shows the days left and an **Upgrade** button. You can dismiss it with its **×** button.
The **Dashboard** is the home page of the console at [app.filone.com](https://app.filone.com), reached from **Dashboard** at the top of the sidebar. It summarises your plan, usage, and recent activity. A **New bucket** button sits in the header. During the trial, a **Free trial** banner shows the days left and an **Upgrade** button. You can dismiss it with its **×** button.

For sign-in methods, email verification, two-factor authentication, and passkeys, see [Account Security](/security/account-security).

## Get started

A new organization opens on a **Get started** page instead of the dashboard, because its dashboard would be all zeros. The page offers **Create bucket** and **Create API key**, which change to **Create another bucket** and **Create another key** once you have one. Below them, **Explore more** links to inviting your team, these docs, and the Fil One team. The page stays at `/get-started` if you want to come back to it.
A new organization opens on a **Get started** page instead of the Dashboard, because its Dashboard would be all zeros. The page offers **Create bucket** and **Create API key**, which change to **Create another bucket** and **Create another key** once you have one. Below them, **Explore more** links to inviting your team, these docs, and the Fil One team. The page stays at `/get-started` if you want to come back to it.

## Plan, storage, and egress

Expand Down Expand Up @@ -45,7 +45,7 @@ The feed currently covers bucket and key creation. Each row shows the resource n

## Account state banners

When your account is restricted, a banner appears above the page on every screen, not just the dashboard:
When your account is restricted, a banner appears above the page on every screen, not just the Dashboard:

| Situation | What the banner says |
|-----------|----------------------|
Expand Down
6 changes: 3 additions & 3 deletions docs/app/organization.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,15 +7,15 @@ Every Fil One account starts as a one-person organization, with you as its **Own

## Where to find the organization's pages

The organization's pages are in the **Organization** group of the left sidebar. You only see the entries your role can open:
The organization's pages are in the **Organization** group of the sidebar. You only see the entries your role can open:

| Entry | What it opens | Who sees it |
|-------|---------------|-------------|
| **Members** | Everyone in the organization, and pending invitations (see [Members](#members)) | Every role |
| **Billing** | Your plan, usage, payment method, and invoices (see [Billing](/app/billing)) | Owner, Admin |
| **Audit log** | A record of membership, key, and organization changes (see [Audit log](#audit-log)) | Owner, Admin |

The organization's logo and name sit at the top of the left sidebar. Click them to open the **organization menu**, which holds:
The organization's logo and name sit at the top of the sidebar. Click them to open the **organization menu**, which holds:

- **Edit organization**, for Owners and Admins: the organization's name and logo, and how to delete it (see [Editing the organization](#editing-the-organization))
- your organizations, if you belong to more than one (see [Switching organizations](#switching-organizations))
Expand Down Expand Up @@ -182,7 +182,7 @@ The invitation email links to `app.filone.com/invite/accept`. If you're not sign

## Switching organizations

If you belong to more than one organization, the organization menu lists them under **Organization**, sorted by name, with a check mark on the one you're in. Choosing another switches the console to that organization and opens its dashboard. With only one membership, the list doesn't appear.
If you belong to more than one organization, the organization menu lists them under **Organization**, sorted by name, with a check mark on the one you're in. Choosing another switches the console to that organization and opens its console. With only one membership, the list doesn't appear.

The choice is kept per browser tab, so two tabs can be in different organizations at the same time. The sidebar names the organization you're in, so check it before removing people or transferring ownership.

Expand Down
4 changes: 2 additions & 2 deletions docs/app/settings.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Settings
description: Profile fields, your organizations, notification preferences, and account security in the Fil One console.
---

**Settings** is in the user menu at the bottom of the left sidebar. It holds your profile, the organizations you belong to, your notification preferences, and your account security. Every member of an organization has their own Settings.
**Settings** is in the user menu at the bottom of the sidebar. It holds your profile, the organizations you belong to, your notification preferences, and your account security. Every member of an organization has their own Settings.

## Profile

Expand All @@ -21,7 +21,7 @@ You can change the address again while unverified, so a typo is recoverable.

**If you signed in with Google or GitHub, your name and email are managed there.** Avatar, name, and email are read-only for social sign-ins, labelled *Managed by Google* or *Managed by GitHub* with a link straight to that provider's profile page, so you keep one source of truth for them.

Your organization's name is not part of your profile. Owners and Admins rename it on the **Edit organization** page, opened from the organization menu at the top of the left sidebar, where the name must be 2 to 100 characters, using letters, numbers, spaces, hyphens, and periods only.
Your organization's name is not part of your profile. Owners and Admins rename it on the **Edit organization** page, opened from the organization menu at the top of the sidebar, where the name must be 2 to 100 characters, using letters, numbers, spaces, hyphens, and periods only.

## Organizations

Expand Down
4 changes: 2 additions & 2 deletions docs/app/support.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Support
description: How to reach the Fil One team from the console.
---

**Support** and **Documentation** are at the bottom of the left sidebar, above your name. **Support** opens the support page.
**Support** and **Documentation** are at the bottom of the sidebar, above your name. **Support** opens the support page.

## The support page

Expand All @@ -24,7 +24,7 @@ Below the form, **Common questions** answers a few frequent questions, such as w

## Other routes

- **Documentation** at the bottom of the left sidebar opens these docs in a new tab.
- **Documentation** at the bottom of the sidebar opens these docs in a new tab.
- The system status indicator links to the Fil One status page, which is the quickest way to check whether an issue is already known. On desktop it sits in the bar along the bottom of the content area; on a phone it is in the sidebar drawer.
- Account deletion is handled over email at [support@filone.com](mailto:support@filone.com), as noted in [Settings](/app/settings).
- For volume pricing, SLAs, or the Business plan, **Contact sales team** in the **Choose your plan** dialog on [Billing](/app/billing) reaches the sales team directly. On the trial or with no plan, **Talk to sales** in the **Need help?** panel beside the billing cards does the same.
9 changes: 7 additions & 2 deletions docs/billing/pricing.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Pricing"
description: "Fil One storage pricing."
description: "Pay as you go and Business plan pricing for Fil One, how a monthly bill is calculated, and worked examples."
---

Fil One is priced at **$5.99 / TB / month**, with a **$5.99 / month minimum**. If you store less than 1 TB, you are billed the $5.99 minimum.
Expand Down Expand Up @@ -30,11 +30,16 @@ Illustrative figures for a steady amount stored for the full month, at $5.99 per
| 2 TB (2,000 GB) | ~$11.98 |

:::note
These figures are illustrative. Your invoice is the source of truth for exact amounts — open the **Billing** page in the dashboard to see your current usage and charges.
These figures are illustrative. Your invoice is the source of truth for exact amounts — open the **Billing** page in the console to see your current usage and charges.
:::

If the amount you store changes during the month, it is averaged first. For example, storing 2 TB for the first 10 days and 0.5 TB for the remaining 20 days averages to 1 TB, billed at $5.99 for that month.

:::note If your account predates the current price
These are the prices for new customers. Organizations that subscribed before the move to $5.99 keep their earlier terms: $4.99 / TB / month with a $4.99 / month minimum, or, for accounts created before any monthly minimum was introduced, per-unit pricing with no minimum. The **Billing** page shows your own rate.
:::

## Next steps

- [Usage](/billing/usage): how storage and egress are measured
- [Billing in the console](/app/billing): see current usage, add a card and find invoices
10 changes: 5 additions & 5 deletions docs/billing/trial.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ You can upgrade to a paid plan at any time during the trial or grace period, and
:::

:::info What "disabled" means
Disabling blocks all access to the account: your data is no longer reachable through the API or the dashboard, and access keys stop working. Fil One does not run an automatic purge at this point. To restore access, an organization Owner opens **Billing** and clicks **Reactivate**. To have your data removed, email [support@filone.com](mailto:support@filone.com).
Disabling blocks all access to the account: your data is no longer reachable through the API or the console, and access keys stop working. Fil One does not run an automatic purge at this point. To restore access, an organization Owner opens **Billing** and clicks **Reactivate**. To have your data removed, email [support@filone.com](mailto:support@filone.com).
:::

## Paid plan pricing
Expand All @@ -66,25 +66,25 @@ Pricing is usage-based, measured as the average storage consumed across the bill

## Payment

Payments are processed through Stripe. An organization Owner adds a credit card from Billing in the dashboard, opened from **Billing** under **Organization** in the left sidebar. See [Billing](/app/billing).
Payments are processed through Stripe. An organization Owner adds a credit card from Billing in the console, opened from **Billing** under **Organization** in the sidebar. See [Billing](/app/billing).

- Invoices are generated monthly.
- Usage details are visible on the Billing page to Owners and Admins.
- Each invoice is charged automatically to the card on file.

## Payment failures

If a payment fails, your account enters **past due** status and Stripe automatically retries the charge. The **dashboard becomes read-only** from the moment the payment fails, and the Billing page shows **Your last payment failed** with an **Update payment** button.
If a payment fails, your account enters **past due** status and Stripe automatically retries the charge. The **console becomes read-only** from the moment the payment fails, and the Billing page shows **Your last payment failed** with an **Update payment** button.

If all retries are exhausted and the subscription is canceled by Stripe, your account transitions to the paid grace period (see below).

:::warning Check the Billing page, not your inbox
Don't rely on an email to tell you a payment has failed. If uploads stop working, open **Billing** in the dashboard: a **Your last payment failed** banner means the card needs updating, and an Owner can fix it with **Update payment**. See [Billing](/app/billing#your-plan).
Don't rely on an email to tell you a payment has failed. If uploads stop working, open **Billing** in the console: a **Your last payment failed** banner means the card needs updating, and an Owner can fix it with **Update payment**. See [Billing](/app/billing#your-plan).
:::

## Cancellation

An organization Owner can cancel the paid plan from the **Stripe billing portal**, which opens from **Billing** in the dashboard. Admins can see usage on Billing but can't open the portal. When cancellation takes effect depends on the option you choose there: if you cancel at the end of the current billing period, your plan stays **active and billable until that period ends**. The **30-day grace period** begins only once Stripe actually cancels the subscription — not the moment you click cancel:
An organization Owner can cancel the paid plan from the **Stripe billing portal**, which opens from **Billing** in the console. Admins can see usage on Billing but can't open the portal. When cancellation takes effect depends on the option you choose there: if you cancel at the end of the current billing period, your plan stays **active and billable until that period ends**. The **30-day grace period** begins only once Stripe actually cancels the subscription — not the moment you click cancel:

| Phase | Duration | What you can do |
|-------|----------|-----------------|
Expand Down
4 changes: 2 additions & 2 deletions docs/billing/usage.mdx
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
---
title: "Usage"
description: "Understanding your storage and bandwidth usage in Fil One."
description: "How Fil One measures storage and egress, where to see usage in the console, and why the egress figures differ."
---

The **Billing** page in the dashboard shows your current usage for the active billing period. It is visible to organization Owners and Admins. See [Billing](/app/billing).
The **Billing** page in the console shows your current usage for the active billing period. It is visible to organization Owners and Admins. See [Billing](/app/billing).

## What is measured

Expand Down
Loading