Thanks to visit codestin.com
Credit goes to github.com

Skip to content

[Auto-sync] Free Cloud plan (#2492) #2493

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
May 13, 2025
Merged
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
6 changes: 2 additions & 4 deletions docusaurus/docs/cloud/cli/cloud-cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,11 +43,9 @@ strapi deploy

This command must be used after the `login` one. It deploys a local Strapi project on Strapi Cloud, without having to host it on a remote git repository beforehand. The terminal will inform you when the project is successfully deployed on Strapi Cloud.

Once the project is first deployed on Strapi Cloud with the CLI, the `deploy` command can be reused to trigger a new deployment of the same project.
Deploying a Strapi project through the CLI creates a project on the Free plan.

:::caution
The `deploy` command can only be used by new users who have never created a Strapi Cloud project, and for which the free trial is still available. Once a project is deployed with the CLI, it isn't possible to deploy another project on the same Strapi Cloud account with the CLI.
:::
Once the project is first deployed on Strapi Cloud with the CLI, the `deploy` command can be reused to trigger a new deployment of the same project.

:::note
Once you deployed your project, if you visit the Strapi Cloud dashboard, you may see some limitations as well as impacts due to creating a Strapi Cloud project that is not in a remote repository and which was deployed with the CLI.
Expand Down
4 changes: 2 additions & 2 deletions docusaurus/docs/cloud/getting-started/cloud-fundamentals.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,8 @@ Before going any further into this Strapi Cloud documentation, we recommend you

- **Hosting Platform** <br/> Strapi Cloud is a hosting platform that allows to deploy already existing Strapi projects created with Strapi CMS (Content Management System). Strapi Cloud is *not* the SaaS (Software as a Service) version of Strapi CMS. Feel free to refer to the [CMS documentation](https://docs.strapi.io/cms/intro) to learn more about Strapi CMS.

- **Strapi Cloud Pricing Plans** <br/> As a Strapi Cloud user you have the choice between 3 tiers: Essential, Pro and Scale. Depending on the tier, you have access to different functionalities, support and customization options (see [Pricing page](https://strapi.io/pricing-cloud) for more details). In this Strapi Cloud documentation, the <CloudEssentialBadge />, <CloudProBadge />, and <CloudScaleBadge /> badges can be displayed below a section's title to indicate for which tier the feature is available.
- **Strapi Cloud Pricing Plans** <br/> As a Strapi Cloud user you have the choice between 4 plans: Free, Essential, Pro and Scale. Depending on the plan, you have access to different functionalities, support and customization options (see [Pricing page](https://strapi.io/pricing-cloud) for more details). In this Strapi Cloud documentation, the <CloudEssentialBadge />, <CloudProBadge />, and <CloudScaleBadge /> badges can be displayed below a section's title to indicate that the feature is only available starting from the corresponding paid plan. If no badge is shown, the feature is available on the Free plan.

- **Types of Strapi Cloud users** <br/> There can be 2 types of users on a Strapi Cloud project: owners and maintainers. The owner is the one who has created the project and has therefore access to all features and options for the project. Maintainers are users who have been invited to contribute to an already created project by its owner. Maintainers, as documented in the [Collaboration](/cloud/projects/collaboration) page, cannot view and access all features and options from the Strapi Cloud dashboard.

- **Support** <br/> The level of support provided by the Strapi Support team depends on the Strapi Cloud tier you subscribed for. The Essential and Pro tiers include Basic support while the Scale tier includes Standard support. Please refer to the [dedicated support article](https://support.strapi.io/support/solutions/articles/67000680833-what-is-supported-by-the-strapi-team#Not-Supported) for all details regarding support levels.
- **Support** <br/> The level of support provided by the Strapi Support team depends on the Strapi Cloud plan you subscribed for. The Free plan does not include access to support. The Essential and Pro plans include Basic support while the Scale plan includes Standard support. Please refer to the [dedicated support article](https://support.strapi.io/support/solutions/articles/67000680833-what-is-supported-by-the-strapi-team#Not-Supported) for all details regarding support levels.
3 changes: 1 addition & 2 deletions docusaurus/docs/cloud/getting-started/deployment-cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,6 @@ This is a step-by-step guide for deploying your project on Strapi Cloud for the
:::prerequisites
Before you can deploy your Strapi application on Strapi Cloud using the Command Line Interface, you need to have the following prerequisites:

- Have at least 1 free trial still available.
- Have a Google, GitHub or GitLab account.
- Have an already created Strapi project (see [Installing from CLI in the CMS Documentation](/cms/installation/cli)), stored locally. The project must be less than 100MB.
- Have available storage in your hard drive where the temporary folder of your operating system is stored.
Expand Down Expand Up @@ -74,6 +73,7 @@ Before you can deploy your Strapi application on Strapi Cloud using the Command
</Tabs>

2. Follow the progression bar in the terminal until confirmation that the project was successfully deployed with Strapi Cloud.
Deploying the project will create a new Strapi Cloud project on the Free plan.

### Automatically deploying subsequent changes

Expand All @@ -93,6 +93,5 @@ Automatic deployment is compatible with all other deployment methods, so once a

Now that you have deployed your project via the Command Line Interface, we encourage you to explore the following ideas to have an even more complete Strapi Cloud experience:

- Fill in your [billing information](/cloud/account/account-billing) to prevent your project from being suspended at the end of the trial period.
- Visit the Cloud dashboard to follow [insightful metrics and information](/cloud/projects/overview) on your Strapi project.
- Check out the full [Command Line Interface documentation](/cloud/cli/cloud-cli) to learn about the other commands available.
27 changes: 13 additions & 14 deletions docusaurus/docs/cloud/getting-started/deployment.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,17 +58,12 @@ Before you can deploy your Strapi application on Strapi Cloud using the Cloud da
<ThemedImage
alt="Strapi Cloud project creation, step 1"
sources={{
light: '/img/assets/cloud/project-creation-1.png',
dark: '/img/assets/cloud/project-creation-1_DARK.png',
light: '/img/assets/cloud/project-creation-1-2.png',
dark: '/img/assets/cloud/project-creation-1-2_DARK.png',
}}
/>

3. Choose a plan for your Strapi Cloud project: either Essential, Pro, Scale, or the 14-day free trial. Feel free to refer to [Pricing](https://strapi.io/pricing-cloud) for more information.

:::note Notes
- Strapi Cloud offers 5 free trial projects and you will not need to share your credit card details to deploy your first project. Once the free trials have already been used for a previous project, the option will no longer appear in the plan selection.
- You can't upload HTML files to Strapi Cloud during your free trials.
:::
3. Choose a plan for your Strapi Cloud project: either Free, Essential, Pro, or Scale. Feel free to refer to [Pricing](https://strapi.io/pricing-cloud) for more information.

4. Connect a git repository to your new Strapi Cloud project.

Expand Down Expand Up @@ -116,11 +111,16 @@ Before you can deploy your Strapi application on Strapi Cloud using the Cloud da

<TabItem value="OWN-REPO" label="Own existing repo & Strapi project">


4.a. (optional) If you are deploying a project for the first time, you may first have to select a git provider: either GitHub or GitLab. If you already deployed a project with one git provider, you can afterward deploy another project using another provider by clicking on the **Switch git provider** button and selecting either GitHub or GitLab.

:::tip
Connect the GitHub or GitLab account and/or organizations that own the repository or repositories you want to deploy. This can be different from the account that owns the Strapi Cloud account.
:::
:::note

You can only connect a Github organization's repositories with Strapi Cloud paid plans. With the free plan, you can only connect a personal repository.
:::

4.b. If you have already given Strapi Cloud access to all repositories of your GitHub or GitLab account, go directly to the next step. If not, you will be redirected to a modal where you will have to allow Strapi Cloud permission to access some or all your repositories on GitHub/GitLab (more information in the <ExternalLink to="https://docs.github.com/en/apps/overview" text="GitHub"/> and <ExternalLink to="https://docs.gitlab.com/ee/integration/oauth_provider.html#view-all-authorized-applications" text="GitLab"/> documentations).

Expand Down Expand Up @@ -171,18 +171,18 @@ Before you can deploy your Strapi application on Strapi Cloud using the Cloud da

:::strapi Using Environment Variables
You can use environment variable to connect your project to an external database rather than the default one used by Strapi Cloud (see [database configuration](/cms/configurations/database#environment-variables-in-database-configurations) for more details). If you would like to revert and use Strapi's default database again, you have to remove your `DATABASE_` environment variables (no automatic migration implied).

You can also set up here a custom email provider. Sendgrid is set as the default one for the Strapi applications hosted on Strapi Cloud (see [providers configuration](/cms/providers#configuring-providers) for more details).
:::

## Setting up billing details

:::strapi No billing step for free trials
If you chose the free trial, this billing step will be skipped as you will not be asked to share your credit card details at the creation of the project.
:::strapi No billing step for the Free plan
If you chose the free plan, this billing step will be skipped as you will not be asked to share your credit card details at the creation of the project.

During the free trial, you will be kept informed of the number of remaining free days. You will then be notified by email and via the Strapi Cloud dashboard whenever it is time to fill in your billing information to move to a paid plan.
To upgrade your project to a paid plan, you will need to fill in your billing information in the **Billing** section of your Profile.

👉 Skip to step 5 of the section below to finalise the creation of your project.
<Icon name="fast-forward" /> Skip to step 5 of the section below to finalise the creation of your project.
:::

1. Click on the **Continue to billing** button. You will directly be redirected to the second and final project deployment interface. There you can review all your new project setup information, enter payment & billing details and receive your invoice.
Expand Down Expand Up @@ -211,6 +211,5 @@ Create your Admin user after the initial deployment is complete. Do not share yo

Now that you have deployed your project via the Cloud dashboard, we encourage you to explore the following ideas to have an even more complete Strapi Cloud experience:

- If you chose the free trial during your first project deployment, make sure to fill in your [billing information](/cloud/account/account-billing) afterward to prevent your project from being suspended at the end of the trial period.
- Invite other users to [collaborate on your project](/cloud/projects/collaboration).
- Check out the [deployments management documentation](/cloud/projects/deploys) to learn how to trigger new deployments for your project.
47 changes: 35 additions & 12 deletions docusaurus/docs/cloud/getting-started/usage-billing.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,18 +15,19 @@ tags:

This page contains general information related to the usage and billing of your Strapi Cloud account and projects.

Strapi Cloud offers 5 free 14 days trials for all new accounts, and 3 paid plans: Essential, Pro and Scale (see [Pricing page](https://strapi.io/pricing-cloud)). The table below summarizes Strapi Cloud usage-based pricing tiers, for general features and usage:

| Feature | Free Trial | Essential | Pro | Scale |
| --- | --- | --- | --- | --- |
| **Database Entries** | 2,500 | Unlimited* | Unlimited* | Unlimited* |
| **Assets Storage** | 25GB | 50GB | 250GB | 1000GB |
| **Assets Bandwidth (per month)** | 25GB | 50GB | 500GB | 1,000GB |
| **API Requests (per month)** | 10,000 | 100,000 | 1,000,000 | 10,000,000 |
Strapi Cloud offers 1 Free plan and 3 paid plans: Essential, Pro and Scale (see [Pricing page](https://strapi.io/pricing-cloud)). The table below summarizes Strapi Cloud usage-based pricing plans, for general features and usage:

| Feature | Free | Essential | Pro | Scale |
| -------------------------------- | ----- | --------- | --- | ----- |
| **Database Entries** | 500 | Unlimited* | Unlimited* | Unlimited* |
| **Assets Storage** | 10GB | 50GB | 250GB | 1,000GB |
| **Assets Bandwidth (per month)** | 10GB | 50GB | 500GB | 1,000GB |
| **API Requests (per month)** | 10,000 | 100,000 | 1,000,000 | 10,000,000 |
| | | | | |
| **Backups** | N/A | N/A | Weekly | Daily |
| **Environments** | N/A | N/A | 0 included (up to 99 extra) | 1 included (up to 99 extra) |
| **Emails (per month)** | 100 | Unlimited* | Unlimited* | Unlimited* |
| **Backups** | N/A | N/A | Weekly | Daily |
| **Custom domains** | N/A | Included | Included | Included |
| **Environments** | N/A | N/A | 0 included (up to 99 extra) | 1 included (up to 99 extra) |
| **Emails (per month)** | 100 | Unlimited* | Unlimited* | Unlimited* |

:::strapi Additional information on usage and features
- General features & usage:
Expand All @@ -36,9 +37,15 @@ Strapi Cloud offers 5 free 14 days trials for all new accounts, and 3 paid plans
- API requests are the number of requests made to your APIs. This includes requests to the GraphQL and REST APIs, excluding requests for file and media assets counted towards CDN bandwidth and storage.
- Cloud specific feature:
- Backups refers to the automatic backups of Strapi Cloud projects (see [Backups documentation](/cloud/projects/settings#backups) for more information on the feature).
- Custom domains refer to the ability to define a custom domain for your Strapi Cloud (see [Custom domains](/cloud/projects/settings#connecting-a-custom-domain)).
- Environments refers to the number of environments included in the plan on top of the default production environment (see [Environments](/cloud/projects/settings#environments) documentation for more information on the feature).
:::

:::info Scale-to-zero and cold start on the Free plan
On the Free plan, projects automatically scale down to zero after a short period of inactivity. When the application is accessed again—either through the frontend or via an API request—it may take a few seconds (up to a minute) before a response is returned.
Upgrading to a paid plan disables scaling to zero and cold starts, resulting in instant response times at all times.
:::

## Environments management

Environments are isolated instances of your Strapi Cloud project. All projects have a default production environment, but other additional environments can be configured for projects on a Pro or Scale plan, from the *Environments* tab of a project's settings (see [Environments](/cloud/projects/settings#environments)). There is no limit to the number of additional environments that can be configured for a Strapi Cloud project.
Expand All @@ -51,6 +58,10 @@ Billing is based on the usage of your Strapi Cloud account and projects. You wil

### Overages

:::caution
Overages are not allowed on the Free plan.
:::

If you exceed the limits of your plan for API Requests, Assets Bandwidth, or Assets Storage, you will be charged for the corresponding overages.

For example, if you exceed the 500GB limit in assets bandwidth of the Pro plan, you will be charged for the excess bandwidth at the end of the current billing period or on project deletion. Overages are not prorated and are charged in full.
Expand All @@ -65,7 +76,7 @@ Overages are charged according to the following rates:

### Project suspension

Projects may end up in a **Suspended** state for various reasons, including: not paying the invoice, exceeding the limits of your free trial plan, or violating the <ExternalLink to="https://strapi.io/cloud-legal" text="terms of service"/>.
Projects may end up in a **Suspended** state for various reasons, including: not paying the invoice, exceeding the limits of your free plan, or violating the <ExternalLink to="https://strapi.io/cloud-legal" text="terms of service"/>.

If your project is suspended, you will no longer be able to access the application or trigger new deployments. You will also be unable to access the Strapi admin panel.

Expand All @@ -75,6 +86,18 @@ You can view the status of your project in the <ExternalLink to="https://cloud.s
If you do not resolve the issue within 30 days, your suspended project will be deleted and all data will be permanently lost. To avoid this situation, you will be sent a first email when your project becomes suspended, then another email every 5 days until one week left, to remind you to solve the issue. The last week before the deletion of the project, you will be sent 3 more emails: 6 days, 3 days and 1 day before your project is finally deleted.
:::

#### Project suspension for exceeding the Free plan limits

When a project hosted with the Free plan exceeds either the API requests or the Assets Bandwidth limits, it will be suspended until the monthly allowance resets at the beginning of the following month.

While the project is suspended:

- Users cannot trigger new deployments
- Access to the application is blocked
- Users cannot make changes to the project’s settings

To reactivate the project immediately, users can upgrade to a paid plan.

#### Project suspension after subscription cancellation

If you don't pay the invoice, the subscription of your project will automatically be canceled and the project will be suspended. You can reactivate the subscription through the billing modal (see [Edit subscription](/cloud/account/account-billing#account-billing)).
Expand Down
4 changes: 3 additions & 1 deletion docusaurus/docs/cloud/projects/runtime-logs.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,9 @@ tags:
From a chosen project's dashboard, the *Runtime logs* tab displays the live logs of the project.

:::note
The *Runtime logs* are only accessible once the project is successfully deployed.

- The *Runtime logs* are only accessible once the project is successfully deployed.
- Runtime logs are not live for projects on the Free plan and are reset each time the application is scaled to zero due to inactivity.
:::

<ThemedImage
Expand Down
Loading