Projects
A project groups related code, deployments, environments and members together. Every resource in your account belongs to exactly one project.
Overview
Projects are the main unit of organisation. Each project has its own settings, access controls, environment variables and deployment history. You can create as many projects as you need, and move resources between them at any time.
Creating a project
From the command line, run:
docs projects create my-service \
--region eu-west-1 \
--visibility privateProject names must be lowercase, may contain hyphens, and must be unique within your account.
Browse projects
The table below lists sample projects in this account. Filter by name or status.
| Name | Status | Region | Tags | Updated |
|---|---|---|---|---|
| checkout-api | Active | eu-west-1 | backendpayments | 2 hours ago |
| web-storefront | Active | eu-west-1 | frontend | yesterday |
| legacy-reports | Paused | us-east-1 | internal | 3 weeks ago |
| search-indexer | Active | us-east-1 | backenddata | 5 days ago |
| mobile-prototype-v1 | Archived | eu-west-1 | mobile | last year |
| docs-site | Active | eu-west-1 | frontenddocs | just now |
No projects match your filter.
Project settings
Each project exposes the following settings under Project → Settings:
| Setting | Default | Description |
|---|---|---|
visibility | private | Who can see the project. One of private, team, or public. |
region | Account default | Where build and runtime resources are provisioned. |
retention_days | 30 | How long deployment logs are kept. |
archive_on_delete | true | Keep a read-only copy when the project is deleted. |
Archiving and deleting
Archiving a project stops all deployments and makes it read-only. Archived projects can be restored within 90 days. Deleting a project is permanent and removes all associated resources.
docs projects archive my-service
docs projects restore my-service
docs projects delete my-service --confirm