Projects – Octopus Deploy

Last updated 2022-10-12T23:12:40.5376342+00:00

Projects let you create and manage your deployment processes, releases, and runbooks from the Octopus REST API and Octopus Web Portal.

For each project, you can define a deployment process, runbooks to manage your infrastructure, variables, the environments where the software will be deployed, and releases of your software.

You can manage your projects by navigating to the Projects tab in the Octopus Web Portal:

If you have already created projects, or are joining an existing team, you'll see the existing projects on the projects page.

Before you can define your deployment processes or runbooks, you must create a project:

Now that you've created a project, you can define your deployment process or runbooks.

You can change the projects settings by accessing the settings menu on the project's main page. The settings you can change are:

Customize your project logo to make it easily identifiable amongst other projects.

For custom images, in addition to supporting .jpg and .png files, we also support .gif files. This means you can have an animated icon to add a little flair to your Octopus Deploy instance!

Project groups are a great way to organize your deployment projects. They have many uses; not only do they visually separate the projects, but you can also configure the dashboard to hide/show specific project groups and configure permissions to restrict access to them.

The Default Project group contains all of the projects that have not been added to another group.

When the group is first created and doesn't have any projects associated with it, you will need to click SHOW EMPTY GROUPS on the projects page to see the group.

After you have created a project group there are a number of ways you can add projects to the group:

To edit or delete a project group click the project groups overflow menu (...) and select edit. From there you can edit the groups name or description. If you need to delete the group, click the overflow menu again and select Delete.

For information about project permissions, see managing users and teams.

Projects can be cloned.

After you've cloned a project, you can see details about where your project was cloned from and which projects have been cloned from your project, by navigating to the project's overview page and selecting Settings and looking at the Cloning History section.

The following topics are explained further in this section:

Was this page helpful?

Yes thanks! Not really

We're sorry this page did not help you! We review your answers every month to find ways to improve these docs. How can we improve it?

Send

Thanks so much for taking the time to give us feedback!

Need support? We're here to help.

Read more:

Projects - Octopus Deploy