Manage your Projects

Projects are the way to organize your applications and resources on Scalingo.

Learn more about Projects.

Setting the project at App creation

Using the Dashboard

Within the App creation wizard, the section Project enables you to set a project different from default.

If the project you’d like to set against the new App, doesn’t exist, proceed as follows:

Click + New project
Enter the project name of your choice (1–64 characters, using only a-z, 0-9, -, or _)
Click Add

If the project is in the list

Select the project you want
Proceed with the next steps of your app creation

Using the Command Line

Make sure you have correctly setup the Scalingo command line tool

From the command line, list the projects:

scalingo projects

The output should look like this:

 /!\  This command only displays projects where you are the owner
┌──────────────┬─────────┬──────────────────────────────────────────┐
│     NAME     │ DEFAULT │                    ID                    │
├──────────────┼─────────┼──────────────────────────────────────────┤
│ test-project │ false   │ prj-6731a609-02b6-4614-b28d-5abe43654333 │
│ default      │ true    │ prj-20f1b7e4-cf4d-46e9-aff1-e47ae149c444 │
└──────────────┴─────────┴──────────────────────────────────────────┘

From the command line, set the project at the app creation step:
```
scalingo create --project-id=prj-6731a609-02b6-4614-b28d-5abe43654333 test-app
```
The output should look like this:
```
App 'test-app' has been created
To deploy your application, run these commands in your GIT repository:
...
```
Here you’ve created the app named test-app and set the project ID to prj-6731a609-02b6-4614-b28d-5abe43654333.

Using the Terraform Provider

Place the following project_id in the app resource block in your Terraform file:

resource "scalingo_app" "test_app" {
  name = "terraform-testapp"
  project_id = "prj-6731a609-02b6-4614-b28d-5abe43654333"
}

Updating the project of an existing App

Using the Dashboard

From your web browser, open your dashboard
Click the Apps tab
Click on the application for which you want to manage the project
Click the Settings tab
In the Settings submenu, make sure to select General
In the section Parent project, click Move app to another project

If the project isn’t already existing, proceed as follows:

Click + New project
Enter the project name of your choice (1-64 characters, using only a-z, 0-9, -, or _)
Click Add

If the project is in the list

Select the project you want
Click Move app to project

Using the Command Line

This feature is not yet available in the CLI.

Using the Terraform Provider

This feature is not yet available in the Terraform Provider.

Listing the projects

Using the Dashboard

Right now it is only possible to list the projects when creating a new application.

Using the Command Line

Make sure you have correctly setup the Scalingo command line tool

From the command line, list the projects:

scalingo projects

The output should look like this:

  /!\  This command only displays projects where you are the owner
┌──────────────┬─────────┬──────────────────────────────────────────┐
│     NAME     │ DEFAULT │                    ID                    │
├──────────────┼─────────┼──────────────────────────────────────────┤
│ test-project │ false   │ prj-6731a609-02b6-4614-b28d-5abe43654333 │
│ default      │ true    │ prj-20f1b7e4-cf4d-46e9-aff1-e47ae149c444 │
└──────────────┴─────────┴──────────────────────────────────────────┘

Creating a new project

Using the Dashboard

Right now it is only possible to create a new project when creating a new application or when moving an existing application to another project.

Using the Command Line

Make sure you have correctly setup the Scalingo command line tool
From the command line, create a project:
```
scalingo projects-add test-project
```
The output should look like this:
```
-----> test-project has been created
```
You can also create a new project that will be default directly:
```
scalingo projects-add --default test-project
```

Using the Terraform Provider

Place the following resource block in your Terraform file:

resource "scalingo_project" "test-project" {
  name = "test-project"
  default = true
}

Updating a project

Two attributes can be updated: name and default.

Using the Dashboard

From your web browser, open your dashboard
Click the Apps tab
Click on the application for which you want to edit the project
Click the Settings tab, make sure to select General
Click your-project settings (where your-project is the current name of the project you want to edit)
Edit either the name of the project or tick the checkbox to make it the default project or update both
Click Edit

Using the Command Line

Make sure you have correctly setup the Scalingo command line tool

From the command line, update a project name:

scalingo projects-update --name=updated-test-project prj-6731a609-02b6-4614-b28d-5abe43654333

The output should look like this:

-----> test-project has been updated

You can also update a project to become the new default:

scalingo projects-update --default prj-6731a609-02b6-4614-b28d-5abe43654333

Using the Terraform Provider

There is only one step required to update a project using Terraform. You need to update the project with the desired attributes. For example:

   resource "scalingo_project" "test-project" {
     name = "updated-test-project"
   }

Removing a project

A project can be removed only if this is not the default one, and no application is linked to it.

Using the Dashboard

This feature is not yet available in the dashboard.

Using the Command Line

Make sure you have correctly setup the Scalingo command line tool

From the command line, update a project:

scalingo projects-remove prj-6731a609-02b6-4614-b28d-5abe43654333

The output should look like this:

-----> prj-6731a609-02b6-4614-b28d-5abe43654333 has been removed

Using the Terraform Provider

There is only one step required to remove a project using Terraform. You just need to remove the associated resource from the Terraform file.

Last update: 09 Sep 2025 Suggest edits