Prerequisites
- Organization administrator permissions
- At least one runner in your organization
Create a project
- Go to your organization dashboard
- Click Create project
No projects screen
- Enter the repository URL
- Enter a project name
- Select at least one environment class
Create project
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 |
Environment classes
Each runner has multiple environment classes configured (e.g.,Small, Regular, Large). When you select environment classes for a project, you’re choosing which compute configurations are available to users creating environments.
Dev Container configuration
Specifies how the development container is configured:- Base image
- VS Code extensions
- Environment variables
- Port forwarding rules
Tasks and services
Define automated workflows beyond Dev Container setup:- Services: long-running processes (databases, servers)
- Tasks: one-off actions (test runs, builds)
- Automations: database provisioning, cloud authentication
Manage projects
Select a project from your organization dashboard to modify its settings:- Environment classes
- Dev Container and tasks/services paths
- Project secrets
Project settings
Limitations
Multi-repo configurations aren’t 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