Prerequisites
- At least one runner in your organization
- By default, all organization members can create projects
- Admins can restrict project creation to admins only via Settings → Policies → “Only admins can create projects”
Create a project
When you create a project, you become its admin. You can manage settings and share the project with other users and groups.- Go to your organization dashboard
- Click Create project
- Enter the repository URL
- Enter a project name
- Select at least one environment class
Configuration options
| Option | Description |
|---|---|
| Repository URL | Git repository cloned when creating environments |
| Repository branch | Default branch checked out (e.g., main, develop) |
| Environment classes | Compute resources (CPU, memory, storage) and region. Min 1, max 30 per project |
| Dev Container path | Path to devcontainer configuration file |
| Tasks and services | Path to automation YAML file |
| Recommended editors | Editors and versions suggested for this project |
Environment classes
Each runner provides multiple environment classes (e.g.,Small, Regular, Large). The classes you select for a project determine which compute configurations users can choose when creating environments.
Dev Container configuration
Controls the development environment setup: base image, VS Code extensions, environment variables, and port forwarding rules. See Dev Container configuration for details.Tasks and services
Define automations beyond Dev Container setup:- Services: long-running processes (databases, servers)
- Tasks: one-off actions (test runs, builds)
Recommended editors
Set which editors and versions appear as suggestions when team members open an environment. See Recommended editors for the full list of editor aliases and version configuration.Manage projects
Select a project from your organization dashboard to modify its settings: environment classes, Dev Container and tasks/services paths, recommended editors, and project secrets.
Limitations
Multi-repo configurations are not built-in. See Working with multiple repositories for a workaround.Next steps
- Create an environment from your project
- Share the project with your team
- Add project secrets