Skip to content

Commit 4d03f9a

Browse files
ecktotecktoecktoteckto
authored
docs: add docs for new AWS Marketplace listing
1 parent ce9f04e commit 4d03f9a

19 files changed

+296
-0
lines changed

‎apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2551,6 +2551,32 @@ export const platform: NavMenuConstant = {
25512551
name: 'Credits',
25522552
url: '/guides/platform/credits' as `/${string}`,
25532553
},
2554+
{
2555+
name: 'AWS Marketplace',
2556+
url: '/guides/platform/aws-marketplace',
2557+
items: [
2558+
{
2559+
name: 'Getting Started',
2560+
url: '/guides/platform/aws-marketplace/getting-started',
2561+
},
2562+
{
2563+
name: 'Account Setup',
2564+
url: '/guides/platform/aws-marketplace/account-setup',
2565+
},
2566+
{
2567+
name: 'Manage your subscription',
2568+
url: '/guides/platform/aws-marketplace/manage-your-subscription',
2569+
},
2570+
{
2571+
name: 'Invoices',
2572+
url: '/guides/platform/aws-marketplace/invoices',
2573+
},
2574+
{
2575+
name: 'FAQ',
2576+
url: '/guides/platform/aws-marketplace/faq',
2577+
},
2578+
],
2579+
},
25542580
{
25552581
name: 'Billing FAQ',
25562582
url: '/guides/platform/billing-faq' as `/${string}`,

‎apps/docs/content/guides/platform/aws-marketplace.mdx‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
---
2+
id: 'aws-marketplace'
3+
title: 'AWS Marketplace'
4+
---
5+
6+
You can purchase Supabase through the AWS Marketplace. Buying through AWS Marketplace can mean simpler billing, faster progress toward your AWS spend commitments, and centralized purchasing across all your AWS accounts. Start the purchase process from our marketplace [product page](https://aws.amazon.com/marketplace/pp/prodview-zjciuce2qsb3q).
7+
8+
When you make a purchase on AWS Marketplace, AWS will calculate sales taxes, VAT, GST, service tax, etc. (“Indirect Taxes”), if applicable, based on the location of your AWS account. You can find more details in the [AWS tax help guide](https://aws.amazon.com/tax-help/marketplace-buyers/).
9+
10+
### Plans available through the AWS Marketplace
11+
12+
- Free Plan: not available
13+
- Pro Plan: available, self-serve
14+
- Team Plan: available, self-serve
15+
- Enterprise Plan: available, via AWS Marketplace Private Offer. [Contact us](https://forms.supabase.com/enterprise) for more information.
16+
17+
## More information
18+
19+
- Implications of managing your Supabase organization through the AWS Marketplace. Refer to the [Account Setup guide](./aws-marketplace/account-setup#implications-of-linking-a-supabase-organization-to-a-marketplace-subscription).
20+
- [AWS Marketplace FAQ](./aws-marketplace/faq)
21+
- General guidance on using the AWS Marketplace as a buyer. Refer to the [AWS documentation](https://docs.aws.amazon.com/marketplace/latest/buyerguide/using-aws-marketplace-as-a-subscriber.html).
22+
23+
## Next steps
24+
25+
- Purchase Supabase through the AWS Marketplace. Refer to the [Getting Started guide](./aws-marketplace/getting-started).

‎apps/docs/content/guides/platform/aws-marketplace/account-setup.mdx‎

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
---
2+
id: 'account-setup'
3+
title: 'Account Setup'
4+
---
5+
6+
After purchasing a Supabase subscription on the AWS Marketplace, the next and final step is to link the newly purchased subscription to a Supabase organization. This can either be an existing organization or a newly created one.
7+
8+
An AWS Marketplace subscription is linked to exactly one Supabase organization. If you want to manage multiple organizations through the AWS Marketplace, you must purchase a separate marketplace subscription for each organization.
9+
10+
<Image
11+
alt="Supabase product subscribe"
12+
src={{
13+
dark: '/docs/img/guides/platform/aws-marketplace-onboarding-page-extended--dark.png',
14+
light: '/docs/img/guides/platform/aws-marketplace-onboarding-page-extended--light.png',
15+
}}
16+
zoomable
17+
/>
18+
19+
## Implications of linking a Supabase organization to a marketplace subscription
20+
21+
- The billing details from your AWS account, such as the billing address and tax ID, are used. These details are managed through the [AWS Billing and Cost Management console](https://console.aws.amazon.com/billing).
22+
- The subscription plan is managed through the AWS Marketplace. You can read more about this in the [Manage your subscription](./manage-your-subscription#manage-your-subscription-plan) guide.
23+
- Charges will come from AWS rather than Supabase, using the default payment method set in your AWS account.
24+
- The [Spend Cap](/docs/guides/platform/cost-control#spend-cap) for the organization is disabled. The Spend Cap is not available for organizations managed through AWS.
25+
- When you downgrade your plan to the Free Plan, all projects within the organization will be paused if you exceed the [free projects limit](/docs/guides/platform/billing-on-supabase#free-plan).
26+
27+
### Linking an existing Supabase organization
28+
29+
Linking an existing organization will result in the following:
30+
31+
- The organization will be upgraded or downgraded to the plan purchased on the AWS Marketplace.
32+
- The organization’s billing cycle will be adjusted. The start date will be set to the date your marketplace subscription became active.
33+
- The credit card you have on file with Supabase may receive a closing charge. This charge covers usage costs incurred up until the point when the marketplace subscription became active.
34+
35+
## Prerequisites for linking a Supabase organization to a marketplace subscription
36+
37+
- The Supabase user must have the Owner or Admin role
38+
- There must be no overdue invoices within the organization
39+
- The organization must not already be managed through another marketplace (e.g. Vercel Marketplace)

‎apps/docs/content/guides/platform/aws-marketplace/faq.mdx‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
---
2+
id: 'aws-marketplace-faq'
3+
title: 'AWS Marketplace FAQ'
4+
---
5+
6+
#### The payment for completing the subscription on the AWS Marketplace fails.
7+
8+
For more information on payment errors, refer to the [AWS documentation](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-paying-for-products.html#payment-methods).
9+
10+
#### How can the Spend Cap for an organization managed through the AWS Marketplace be enabled?
11+
12+
For organizations on the Pro Plan that are managed through the AWS Marketplace, the Spend Cap is not available.
13+
In your AWS account, you can set up a budget for marketplace purchases (or for a specific marketplace product) and receive notifications once the budget is exceeded.
14+
15+
#### How to cancel your AWS Marketplace subscription
16+
17+
You can cancel your marketplace subscription within 48 hours of purchase. To do so, open a support ticket via the Supabase dashboard. After the 48-hour period, cancellation is no longer possible. If you cancel within the first 48 hours, the upfront charge for the fixed subscription fee will be refunded. Any usage costs incurred up to that point will not be refunded.
18+
19+
#### Does purchasing Supabase through the AWS Marketplace count toward your AWS spend commitment?
20+
21+
Yes, marketplace purchases do count toward the spend commitment.

‎apps/docs/content/guides/platform/aws-marketplace/getting-started.mdx‎

Lines changed: 88 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,88 @@
1+
---
2+
id: 'getting-started'
3+
title: 'Getting Started'
4+
---
5+
6+
## Before you start
7+
8+
Depending on whether a Supabase organization is managed and billed through the AWS Marketplace or directly through the Supabase platform, there are differences. To help you make an informed decision about which approach is better suited for your needs, you can find an overview of these differences in the table below.
9+
10+
| Feature/Aspect | Managed via AWS Marketplace | Managed directly via Supabase platform |
11+
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
12+
| Available Plans | Pro, Team, Enterprise | Free, Pro, Team, Enterprise |
13+
| Mid-cycle downgrades | No | Yes |
14+
| Cost Control | Spend Cap not available | Spend Cap available |
15+
| Downgrade Behaviour | If a downgrade to the Free Plan causes you to exceed the [free projects limit](/docs/guides/platform/billing-on-supabase#free-plan), all projects will be paused. | If a downgrade to the Free Plan causes you to exceed the [free projects limit](/docs/guides/platform/billing-on-supabase#free-plan), you have the option to prevent pausing by transferring projects. |
16+
| Invoicing | Separate invoices, one for fixed costs and one for usage costs | One invoice for both fixed costs and usage costs |
17+
18+
## Purchase Supabase through the AWS Marketplace
19+
20+
Purchasing Supabase through the AWS Marketplace involves two steps. First, you purchase the corresponding subscription on the marketplace. Then, to complete the setup, you must link this subscription to a Supabase organization on the Supabase platform.
21+
22+
For more details on completing the setup and what it means to link an organization, see our [Account Setup guide](./account-setup).
23+
24+
<StepHikeCompact>
25+
<StepHikeCompact.Step step={1}>
26+
<StepHikeCompact.Details title="Go to the AWS Marketplace" fullWidth>
27+
Go to the [Supabase product page on the AWS Marketplace](https://aws.amazon.com/marketplace/pp/prodview-zjciuce2qsb3q) and click "View purchase options".
28+
<Image
29+
alt="Supabase product overview on the AWS Marketplace"
30+
src="/docs/img/guides/platform/aws-marketplace-listing-overview.png"
31+
zoomable
32+
/>
33+
</StepHikeCompact.Details>
34+
</StepHikeCompact.Step>
35+
<StepHikeCompact.Step step={2}>
36+
<StepHikeCompact.Details title="Configure the subscription" fullWidth>
37+
Select the desired plan (Pro Plan or Team Plan) and configure whether the subscription should automatically renew after one month.
38+
39+
<Admonition type="danger">
40+
41+
Disabling auto-renewal means that the subscription will be downgraded to the Free Plan after one month.
42+
43+
If the downgrade causes you to exceed the [free projects limit](/docs/guides/platform/billing-on-supabase#free-plan), **all** projects within the organization will be paused. We do not make the decision about which projects continue to run and which are paused. You must then decide which projects you want to keep active and manually reactivate them through the Supabase dashboard.
44+
45+
</Admonition>
46+
47+
<Image
48+
alt="Supabase purchase options on the AWS Marketplace"
49+
src="/docs/img/guides/platform/aws-marketplace-listing-purchase-options.png"
50+
zoomable
51+
/>
52+
</StepHikeCompact.Details>
53+
</StepHikeCompact.Step>
54+
<StepHikeCompact.Step step={3}>
55+
<StepHikeCompact.Details title="Subscribe" fullWidth>
56+
Click "Subscribe" at the bottom of the page.
57+
<Image
58+
alt="Supabase product subscribe"
59+
src="/docs/img/guides/platform/aws-marketplace-listing-subscribe.png"
60+
zoomable
61+
/>
62+
</StepHikeCompact.Details>
63+
</StepHikeCompact.Step>
64+
<StepHikeCompact.Step step={4}>
65+
<StepHikeCompact.Details title="Go to the Supabase platform" fullWidth>
66+
After the payment has been confirmed and your marketplace subscription is active, click "Set up your account" to be redirected to the Supabase platform.
67+
<Image
68+
alt="Supabase product subscribe"
69+
src="/docs/img/guides/platform/aws-marketplace-listing-success.png"
70+
zoomable
71+
/>
72+
</StepHikeCompact.Details>
73+
</StepHikeCompact.Step>
74+
<StepHikeCompact.Step step={5}>
75+
<StepHikeCompact.Details title="Complete the setup on the Supabase platform" fullWidth>
76+
Complete the setup by linking a Supabase organization to the AWS Marketplace subscription.
77+
<Image
78+
alt="Supabase product subscribe"
79+
src={{
80+
dark: '/docs/img/guides/platform/aws-marketplace-onboarding-page--dark.png',
81+
light: '/docs/img/guides/platform/aws-marketplace-onboarding-page--light.png',
82+
}}
83+
zoomable
84+
/>
85+
</StepHikeCompact.Details>
86+
</StepHikeCompact.Step>
87+
88+
</StepHikeCompact>

‎apps/docs/content/guides/platform/aws-marketplace/invoices.mdx‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
id: 'invoices'
3+
title: 'Invoices'
4+
---
5+
6+
## Where to find your invoices
7+
8+
You can view your invoices in the [AWS Billing and Cost Management console](https://console.aws.amazon.com/billing/home#/bills) under the "Bills" section.
9+
10+
<Image
11+
alt="Subscription upgrade modal"
12+
src="/docs/img/guides/platform/aws-marketplace-invoices.png"
13+
zoomable
14+
/>
15+
16+
## What invoices you get from AWS
17+
18+
You'll receive two invoices for your marketplace subscription.
19+
20+
### Invoice 1 - charge type "subscription"
21+
22+
- What for: The fixed subscription fee paid in advance
23+
- When: At the time of subscription, and in subsequent months on the same day of the month the subscription was started
24+
25+
### Invoice 2 - charge type "usage"
26+
27+
- What for: Usage that exceeds the quota included in the plan, or usage not covered by the plan (e.g. Custom Domain add-on, IPv4 add-on, additionally provisioned Disk IOPS).
28+
- When: No later than the third day of the month for the previous month. This is independent of your subscription’s billing cycle and instead covers the period from the first to the last day of the previous month.
29+
30+
## More information
31+
32+
- Detailed explanations of how each usage item is billed, independent of the AWS Marketplace. Refer to the [Manage Your Usage guide](../manage-your-usage).

‎apps/docs/content/guides/platform/aws-marketplace/manage-your-subscription.mdx‎

Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
---
2+
id: 'manage-your-subscription'
3+
title: 'Manage your subscription'
4+
---
5+
6+
## Manage your subscription plan
7+
8+
Plan changes are not made on the Supabase dashboard, but instead through the AWS Marketplace. The easiest way to navigate to the corresponding page on the marketplace is through the Supabase dashboard.
9+
10+
1. On the [organization's billing page](/dashboard/org/_/billing), go to section **Subscription Plan**
11+
2. Click **Change subscription plan**
12+
3. On the side panel, follow the link to the AWS Marketplace
13+
14+
### Upgrade
15+
16+
You can upgrade your plan at any time. The new plan will be active immediately, and you will be charged a prorated amount for the remainder of the current billing cycle. The charge for the upgrade also factors in the upfront payment you have already made for your existing plan.
17+
18+
<Image
19+
alt="AWS Marketplace modify contract page"
20+
src={{
21+
light: '/docs/img/guides/platform/aws-marketplace-change-plan.png',
22+
dark: '/docs/img/guides/platform/aws-marketplace-change-plan.png',
23+
}}
24+
zoomable
25+
/>
26+
27+
### Downgrade
28+
29+
Downgrades are only possible at the end of the billing cycle, not in the middle of a billing cycle.
30+
31+
#### Downgrade to the Free Plan
32+
33+
If you want your subscription to be downgraded to the Free Plan at the end of the current billing cycle, you need to disable auto-renewal for the marketplace subscription.
34+
35+
<Admonition type="danger">
36+
37+
If the downgrade causes you to exceed the [free projects limit](/docs/guides/platform/billing-on-supabase#free-plan), **all** projects within the organization will be paused. We do not make the decision about which projects continue to run and which are paused. You must then decide which projects you want to keep active and manually reactivate them through the Supabase dashboard.
38+
39+
</Admonition>
40+
41+
<Image
42+
alt="AWS Marketplace modify contract page"
43+
src={{
44+
light: '/docs/img/guides/platform/aws-marketplace-configure-auto-renewal.png',
45+
dark: '/docs/img/guides/platform/aws-marketplace-configure-auto-renewal.png',
46+
}}
47+
zoomable
48+
/>
49+
50+
#### Downgrade to a paid plan
51+
52+
A downgrade to a paid plan (Pro Plan / Team Plan) involves two steps.
53+
54+
**Step 1:** Let the current subscription on the higher plan expire, meaning turn off auto-renewal
55+
**Step 2:** Start a new subscription on the lower plan
56+
57+
## Manage your payment methods
58+
59+
You can manage your payment methods through the [AWS Billing and Cost Management console](https://console.aws.amazon.com/billing).
60+
61+
## Manage your billing details
62+
63+
You can manage billing details, such as the billing address or tax ID, through the [AWS Billing and Cost Management console](https://console.aws.amazon.com/billing).

‎apps/docs/public/img/guides/platform/aws-marketplace-change-plan.png‎

488 KB
Loading

‎apps/docs/public/img/guides/platform/aws-marketplace-configure-auto-renewal.png‎

435 KB
Loading

‎apps/docs/public/img/guides/platform/aws-marketplace-invoices.png‎

789 KB
Loading

0 commit comments

Comments
 (0)