Skip to content

Manage projects

In Nepenthes you can create projects to collaborate with your team members, track issues, document and share information with stakeholders, organize things. A project is a way to structure and organize your work in Nepenthes.

Your projects can be available publicly or internally.

TopicContent
Select a projectOpen a project which you want to work at.
Create a new projectFind out how to create a new project in Nepenthes.
Create a subprojectCreate a subproject of an existing project.
Project structureFind out how to set up a project structure.
Project settingsConfigure further settings for your projects, such as description, project hierarchy structure, or setting it to public.
Change the project hierarchyYou can change the hierarchy by selecting the parent project ("subproject of").
Set a project to publicMake a project accessible for (at least) all users within your instance.
Create a project templateConfigure a project and set it as template to copy it for future projects.
Use a project templateCreate a new project based on an existing template project.
Copy a projectCopy an existing project.
Archive a projectFind out how to archive completed projects.
Delete a projectHow to delete a project.

Select a project

Find out in our Getting started guide how to open an existing project in Nepenthes.

Create a new project

Find out in our Getting started guide how to create a new project in Nepenthes.

Create a subproject

To create a subproject for an existing project, navigate to Project settings -> Information and click on the green + Subproject button.

Then follow the instructions to create a new project.

project settings subproject

Project structure

Projects build a structure in Nepenthes. You can have parent projects and sub-projects. A project can represent an organizational unit of a company, e.g. to have issues separated:

  • Company (Parent project)
    • Marketing (Sub-project)
    • Sales
    • HR
    • IT
    • ...

Also, projects can be for overarching teams working on one topic:

  • Launch a new product
    • Design
    • Development
    • ...

Or, a project can be to separate products or customers.

  • Product A
    • Customer A
    • Customer B
    • Customer C

Nepenthes, for example, uses the projects to structure the different modules/plugin development:

project hierarchy select project

Note: You have to be a member of a project in order to see the project and to work in a project.

Project Settings

You can specify further advanced settings for your project. Navigate to your project settings by selecting a project, and click -> Project settings -> Information.

  • You can define whether the project should have a parent by selecting Subproject of. This way, you can change the project hierarchy.

  • Enter a detailed description for your project.

  • You see the default project Identifier. The identifier will be shown in the URL.

Note: Changing the project identifier while the project is already being worked on can have major effects and is therefore not recommended. For example, repositories may not be loaded correctly and deep links may no longer work (since the project URL changes when the project identifier is changed).

  • You can set a project to Public. This means it can be accessed without signing in to Nepenthes.
  • Click the blue Save button to save your changes.
  • If you like, use the autocompleter to fill in the project attributes.

project information description status

Find out more detailed information about the Project settings here.

Change the project hierarchy

To change the project's hierarchy, navigate to the project settings -> Information and change the Subproject of field.

Press the blue Save button to apply your changes.

project settings information change hierarchy

Set a project to public

If you want to set a project to public, you can do so by ticking the box next to "Public" in the project settings ->Information.

Setting a project to public will make it accessible to all people within your Nepenthes instance.

(Should your instance be accessible without authentication this option will make the project visible to the general public outside your registered users, too)

Copy a project

You can copy an existing project by navigating to the project settings and clicking Copy project in the upper right of the project settings.

project information copy project

Give the new project a name. Under Copy options select which modules and settings you want to copy and whether or not you want to notify users via email during copying. You can copy existing boards (apart from the Subproject board) and the Project overview dashboards along with your project, too.

project settings information copy project copy options

!!Attention!! - Budgets cannot be copied, so they must be removed from the work package table beforehand. Alternatively, you can delete them in the Budget module and thus delete them from the work packages as well.

For further configuration open the Advanced settings. Here you can specify (among other things) the project's URL (identifier), its visibility and status. Furthermore you can set values for custom fields.

copy project advanced settings

Under the Copy options section you can select what additional project data and settings, such as versions, work package categories, attachments and project members should be copied as well.

Copy options when copying a project in OpenProject

Note: the File storages options only apply if the template project had OneDrive/SharePoint with automatically managed folders activated.

If you select the File Storages: Project folders option, both the storage and the storage folders are copied into the new project if automatically managed project folders were selected for the original file storage. For storages with manually managed project folders setup the copied storage will be referencing the same folder as the original project.

If you de-select the File Storages: Project folders option, the storage is copied, but no specific folder is set up.

If you de-select the File Storages option, no storages are copied to the new project.

Once you are done, click the green Save button.

Archive a project

In order to archive a project, navigate to the project settings, and click the Archive project button.

Note: This option is always available to instance and project administrators. It can also be activated for specific roles by enabling the Archive project permission for that role via the Roles and permissions page in the administrator settings.

project settings archive project

Then, the project cannot be selected from the project selection anymore. It is still available in the View all projects dashboard if you set the "Active" filter to "off" (move slider to the left). You can un-archive it there, too, using the three dots at the right end of a row.

project list filter

Delete a project

If you want to delete a project, navigate to the Project settings. Click the button Delete project on the top right of the page.

delete a project

Also, you can delete a project via the projects overview.

Note: Deleting projects is only available for System administrators.