/
Menu

Create and manage a project

Create a project, rename it, change its status and environments, retire it with Sunset, or delete it.

This page helps you create a project and manage it over time.

#Before you start

  • Unlock your vault. See Unlock your vault.
  • The Free plan includes 2 projects. If you are at the limit, creating another shows a message with an upgrade link. Solo has no project limit. See Plans.

#Create a project

  1. Open Projects and select New project.
  2. Enter a Name (up to 80 characters).
  3. Under Environments, tick the ones this product uses. Production is ticked by default. You need at least one.
  4. Select Create project.

Projects are encrypted like everything else in your vault, so the server never sees the name. See What StackHangar can see.

To start a whole new product with a guided checklist instead, select Launch a product. See Launch playbook.

#Rename a project

Open the project and scroll to Project settings. Change Project name and select Rename.

#Change the status

In Project settings, the Status menu offers Active, Paused and Retired. Paused and retired projects stay in your vault. Status also affects savings findings: an account plan that serves no active project can be flagged. See Findings.

Retired is normally set by the Sunset playbook rather than by hand.

#Change the environments

In Project settings, tick or untick Production, Staging and Development and save. You can't remove an environment while items in the project still use it. Move those items to another environment first (see Items).

#Sunset a project

Sunset project walks you through cancelling subscriptions, revoking keys and deciding what to do with domains, then retires the project. Nothing is deleted without your confirmation. The button is tucked behind Show sunset button so you don't press it by accident. If a sunset run is already in progress it says Resume sunset.

#Delete a project

  1. In Project settings, open Show delete button.
  2. Select Delete project, then Yes, delete.

A project must be empty first. If it still has items you'll be told to move or delete them. If it has a playbook run in progress, finish or abandon the run first.

A deleted project can be restored from Recently deleted (a link at the top of the Vault page) for 30 days.

#Project history

Project history, at the bottom of Project settings, shows earlier names and statuses from the last 30 days. See History.

#If something goes wrong

  • "Give the project a name." means the name field was empty.
  • A plan limit message means you have reached the Free plan's 2 projects.
  • If you can't delete a project, check for items or a run in progress, as above.