Skip to main content
A project connects a repository to a runner with predefined configuration. It is the blueprint for environments and the entry point for Automations. Every environment and every Automation run starts from a project.

​
Prerequisites

  • An Ona account on any plan
  • At least one runner in your organization
  • A repository URL (GitHub or GitLab)

​
Create the project

  1. Go to your organization dashboard.
  2. Click Create project.
No projects screen showing Create project button
  1. Enter the repository URL.
  2. Enter a project name.
  3. Select at least one environment class. Environment classes define the compute resources (CPU, memory, storage) available to environments created from this project.
Project creation form with repository URL, name, and environment class fields
  1. Click Create.

​
Configure your environment

A project points to two configuration files in your repository:
  • devcontainer.json: defines the base image, language runtimes, tools, and VS Code extensions. See Set up your first environment.
  • automations.yaml: defines startup tasks (install dependencies, seed databases) and long-running services (databases, servers). See Tasks and Services.
These files make your environment reproducible. Every environment launched from this project, and every Automation run against it, uses the same configuration.

​
Verify it works

  1. Open the project from your dashboard.
  2. Click New Environment.
  3. Wait for the environment to build and start.
  4. Confirm your tools, dependencies, and services are available.
If the environment builds and your test suite passes, the project is ready for Automations.

​
What’s next