- Documentation
- Projects
- Projects Overview
Projects Overview
A project groups services that belong together, such as the app, API, landing page, and database of one product. Services in the same project talk to each other on a private network, and the project also holds their deploys, domains, and team members. You don’t need to create a project to get started: your first service goes into a default project.
What is a project?
A project works as a workspace where you organize everything related to an application or product. Inside a project, you can:
- Create and manage services (APIs, web apps, workers, etc.)
- Invite team members with different access levels
- Configure custom domains
- Track deploys and logs
- Manage environment variables and persistent volumes
All resources within a project share the same resource quota, defined by your plan.
Your default project
Every account has a default project. It is created the first time you add a service without choosing a project, and it starts out named My project. You can rename it at any time, in the project settings or right from the new service form.
- New services go to your default project when you don’t pick one.
- With several projects, you can make another one the default with Make default, in the project settings or the project card menu. Only the project owner can do this.
- If you delete your default project, your oldest remaining project becomes the default the next time you add a service. If you have no project left, a new default project is created.
Creating a project
You only need more projects when you want to keep products apart, for example to give them separate private networks or different team members. To create a new project, go to the dashboard and click New Project. You will need to provide:
- Name — a descriptive name to identify the project (for example,
my-apioronline-store). - Description (optional) — a short description of what the project does, useful for teams with multiple projects.
When you create the project, you automatically become the Owner with full control over all settings.
Project list
On the main dashboard, you will see a list of all projects you are a member of. Each project displays:
- Project name and description
- Your role in the project (Owner, Admin, Member, or Viewer)
- Number of active services
- Overall service status
- A Default tag on your default project
You only see projects you were invited to or that you created yourself. To see every service across all of your projects in one list, open Services in the sidebar.
Resource quotas
Your plan defines an account-wide resource pool shared by all services across all of your projects. For example, the Pro plan reserves up to 2 vCPU in total across your services, and a single service can use all of it. You can distribute that pool across your services as long as the total reserved CPU does not exceed it.
If you need more resources, you can upgrade your plan or enable overage billing in the project settings.
Project limits by plan
The number of projects you can create depends on your plan:
| Plan | Projects allowed |
|---|---|
| Starter | 99 |
| Pro | 99 |
| Max | 99 |
| Business | 99 |
| Enterprise | Unlimited |
Next steps
Now that you understand what projects are, learn how to adjust your project settings on the Settings page.