Create New Project

Organize your data sources and teams around projects

Stash follows a project‑based architecture designed to keep your data organized and scoped. You can create multiple projects under your company’s account, with each project linking to its own set of data sources - repositories, issue trackers, and wikis.

This structure makes it easy to keep information relevant and focused, as well as manage access: team members can be granted project‑specific permissions so they only see the data that matters to their work.

Projects bring together all your technical data sources in a single place, making everything easier to access, understand, and use effectively.

How to create a new project?

1. Start New Project

   From the Stash home screen, click Create new project in the Quick Actions panel. This will launch the Project Creation Wizard, which will guide you through the setup step by step.

   
2. Fill in project details

   Enter the name, description, and primary language of the project.

   
3. Connect repositories

   Add the repositories you want to link to this project. Enter the repository details and click Validate. Once validated, select the branch you want Stash to analyze.

   
4. Connect issue trackers

   Next, add any issue trackers you want linked to this project, such as Jira, GitHub Issues, or GitLab Issues. Select the tracker type, enter the required details, and click Validate.

   
5. Connect wikis

   If your project uses a wiki or documentation space, such as Confluence, you can connect it at this step. Enter the required details, click Validate.

   
6. Configure project settings

   If your issue trackers already work with Stash’s default settings, you can skip this step. Otherwise, use the configuration options to adjust how issues and labels are handled.

   
7. Review and finish

   The summary screen shows all the repositories, issue trackers, and wikis you’ve connected. Review the information and click the confirmation button to create the project.

   
8. You’re ready to go

   After you finish creating a project, Stash will begin analyzing your connected data sources. Depending on the size of your project, this process may take up to 24 hours to complete.

   Please wait until the analysis is finished before using Stash, as results will not be accurate until the process is done.