Projects: group your services by client, team or environment

1. What is a project?

A project is a folder for your services: "Client A", "Web Production", "Staging" and so on. Every service sits in one project. When you pick a project in the project switcher in the top bar, My Services and Gyro Console show only that project's services.

• Every account has a default project called General. Any service you have not put into a project is in General, including everything you bought before projects existed. If you do nothing, your client area works exactly as before.
• A service is in exactly one project at a time.
• A project is only a grouping: the service itself, its invoices, renewal date and tags do not change.

2. Step by step: create a project and move services

1. Open Projects in the left menu (or New project in the project switcher).
2. Click New project, enter a name (up to 40 characters), optionally a description, colour and icon, then Create.
3. Go to My Services. Tick the boxes on the left of the services you want to move; a bar opens at the bottom of the screen.
4. Click Move to project in the bar, pick the project and click Move. Create a new project and move does both in one step.

You can also move a single service from its own page: the Move to project button next to the project badge in the header.

Limits

3. Filtering with the project switcher

• Click the Project box in the top bar. You see All projects, General and your projects with their active service counts.
• Picking a project reloads the page; My Services shows only that project and a "Showing project X" note with Show all projects.
• In All projects view every service has a coloured project badge.
• Your choice is remembered in your browser.
• Invoices are not filtered by project (one invoice can cover several services). Dashboard counters and "needs attention" notices also cover the whole account.

4. Spend per project

The Projects page shows the number of resources and this month's spend for each project, with a total at the top.

• Prepaid (hourly) services (Gyro Cloud Istanbul, Gyro Containers and so on): the amount actually deducted from your balance this month.
• Recurring services (monthly, yearly): the monthly equivalent of the service price (a 120 € yearly service counts as 10 €).
• Amounts are shown in your account currency with the euro equivalent in brackets.

Open on a card selects the project and takes you to My Services. Use the card menu to edit or delete a project. When a project is deleted its services go back to General; no service is deleted.

5. Where do new services go?

• If a project is selected in the client area when you order, the new service is added to that project.
• Orders placed while All projects or General is selected go to General.
• With the API, CLI or Terraform, pass project_id in the order. An invalid project_id is rejected before the order is created.
• Services our support team creates for you go to General; move them wherever you like.

6. API, CLI and Terraform

Create an API key under API Credentials in the account menu (full reference: developer documentation). Reading needs the services_read scope, changes need services_write.

gyro project list                                                   # General is always id 0
gyro project create --name "Client A" --color teal --icon briefcase --service-ids 12345,12346
gyro service project set 12347 --project-id 7                       # 0 = General
gyro service list --project 7
gyro project delete 7 --yes                                         # services go back to General

API: GET/POST /cloud/projects, GET/PATCH/DELETE /cloud/projects/{id}, POST /cloud/projects/{id}/services (bulk move, up to 500 services) and PUT /cloud/services/{id}/project. Service list and detail responses include a project field; filter the list with ?project=<id>. Server, load balancer and server-from-template orders accept project_id.

Terraform (provider 0.18.0 or later):

resource "gyro_project" "client_a" {
  name  = "Client A"
  color = "teal"
  icon  = "briefcase"
}

resource "gyro_server" "web" {
  plan          = "standart-2-4"
  region        = "tr-ist-1"
  image         = "ubuntu-24.04"
  confirm_order = true
  project_id    = tonumber(gyro_project.client_a.id)
}

resource "gyro_service_project" "old_site" {
  service_id = 12348
  project_id = tonumber(gyro_project.client_a.id)
}

Changing project_id later moves the server in place; it is not recreated.

7. Frequently asked questions