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

From your web browser, open your dashboard
Click the Projects tab

The list includes, in addition of the projects you have created, those you are collaborating on (meaning you’re collaborator on at least one of the applications)

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

From your web browser, open your dashboard
Click the Projects tab
Click Create a project button in the top of the list
Enter the project name of your choice (1–64 characters, using only a-z, 0-9, -, or _)
Choose the region on which you want to create the new project
Click Create new project

Right after the creation of the project, you’re redirected on its Dashboard. It is empty and you’ve got the capability to create its first App by clicking on Deploy an app button.

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

Using the Dashboard

If you want to update the name of your project, the steps are the following:

From your web browser, open your dashboard
Click the Projects tab
(optional) You can filter the list of projects by clicking on My projects or Other projects and or type its name or a part of it in the search text box
On the row of the project you want to edit, click the name of the project
On the Dashboard of the project you want to edit, click Settings tab
In the Settings submenu, make sure to select General
In the Project details, click Rename button
Put the name of your choice (1-64 characters, using only a-z, 0-9, -, or _)
Click Rename

If you want to change the default project, the steps are the following:

From your web browser, open your dashboard
Click the Projects tab
(optional) You can filter the list of projects by clicking on My projects or Other projects and or type its name or a part of it in the search text box
On the row of the project you want to edit, click the name of the project
On the Dashboard of the project you want to edit, click Settings tab
In the Settings submenu, make sure to select General
In the Project details, click Set [project name] as your default project

Using the Command Line

Two attributes can be updated: name and default.

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

From your web browser, open your dashboard
Click the Projects tab
(optional) You can filter the list of projects by clicking on My projects or Other projects and or type its name or a part of it in the search text box
On the row of the project you want to edit, click the name of the project
On the Dashboard of the project you want to edit, click Settings tab
In the Settings submenu, make sure to select General
Click Delete project button
In the popup, confirm the name of the project you want to delete
Click Delete project [project name]

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: 13 Nov 2025 Suggest edits