Skip to content

Commit 5095e71

Browse files
authored
fix: explain staging dev envs (#1713)
1 parent 50d92d9 commit 5095e71

File tree

1 file changed

+36
-0
lines changed

1 file changed

+36
-0
lines changed

docs/getting-started/local-development.mdx

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,42 @@ Follow these steps:
4343
4. Enter the API Key name and click **Create API Key**.
4444
5. Copy the created API Key from the prompt that shows at the bottom right of the screen.
4545

46+
## Environments
47+
48+
Ory Network offers different environments for production, staging, and development. These are called Ory Network projects.
49+
50+
Review rate limits in the [Project Rate Limits](https://www.ory.sh/docs/guides/rate-limits) documentation. To match configuration
51+
between projects use the [Ory CLI](https://www.ory.sh/docs/guides/cli/config-with-cli) For more information what environments are
52+
included on the Ory Network plans, head over to the [Pricing](https://ory.sh/pricing) page.
53+
54+
:::warning
55+
56+
Staging and development projects are for test data only! Ory Network doesn't guarantee GDPR-compliant PII handling in staging and
57+
development projects.
58+
59+
:::
60+
61+
### Development projects
62+
63+
Development projects provide a free test environment for your projects, with limited rate limits and no custom domain. They are
64+
ideal for early-stage development and testing. To create a new development project, use the following command:
65+
66+
```shell
67+
ory create project --name "My Development Project"
68+
```
69+
70+
### Staging projects
71+
72+
Staging projects offer all features of production environment including a custom domain (e.g.,
73+
`https://auth-staging.example.com`). Staging projects have lower rate limits than production projects.
74+
75+
To create a new staging project, open the [Ory Console](https://console.ory.sh/projects/create), hit "Create new project", and
76+
select the Staging environment in the next screen.
77+
78+
Staging projects are suitable for testing your application and its integrations with Ory Network before deploying to production.
79+
They provide a more accurate representation of how your application will behave in a production project compared to development
80+
projects, without the risk of affecting real users or data.
81+
4682
## Local development
4783

4884
To make login easy and secure, Ory uses cookies to manage session in browser applications. Ory additionally deploys CSRF cookies

0 commit comments

Comments
 (0)