System Administration guide
Welcome to the OpenProject System Administration guide.
In order to make changes to settings affecting your entire OpenProject environment, you need to navigate to the OpenProject administration.
If you are an administrator on your OpenProject environment, you can access the administration by clicking on your user Avatar in the upper right corner and selecting ->Administration from the dropdown menu.
Click on one of the categories in order to proceed with the configuration.
Overview
| Topic | Content |
|---|---|
| Users and permissions | How to manage users, groups and permissions in OpenProject? |
| Work packages | How to configure work packages, types, status and workflows? |
| Custom fields | Set custom fields for work packages, Spent time, projects, versions, users, groups and more. |
| Attribute help texts | Add help texts to explain attributes (including custom fields) in projects and work packages. |
| Enumerations | Set enumerations, e.g. work package priorities, time tracking activities, document categories, and more. |
| System settings | Configure your system settings, e.g. a welcome text block on the landing page, display settings, repositories, and more. |
| Configure email settings in OpenProject. How to configure email notifications and your email provider? How to set up incoming email? | |
| Authentication | Configure authentication methods in OpenProject, e.g. OAuth, OpenID, Two-factor-authentication, LDAP, and more. |
| Announcement | How to create a system announcement? |
| Design | Create your own design and make it compliant to your company’s Corporate Identity, upload logo and customize colors. |
| Colors | Configure colors used in the system, e.g. status colors, work package types, priorities and more. |
| Time and costs | Configure your currency and create cost types in OpenProject. |
| Backlogs | Configure your backlogs settings in OpenProject, e.g. story types to be displayed in the backlogs, task types, and more. |
| Plugins | Manage plugins in OpenProject. |
| Webhooks | Add and manage webhooks in OpenProject. |
| Information | View the latest system information status. |
| GitHub Integration | How to combine GitHub and OpenProject. |
| Enterprise on-premises | Upgrading your Community Edition to Enterprise on-premises and other administrative topics. |
| Enterprise cloud | Manage your OpenProject Enterprise cloud and other administrative topics. |
Help and feedback
If you did not find what you were looking for
If you need help from the community or want to support others
If you are eligible for professional support and have more questions
REQUEST SUPPORT
If you find an easily fixable error or need for improvement in the documentation for the stable release
If you would like to suggest bigger updates or improvements to this documentation
If you want to contribute to translate this documentation to another language
If there's something you don't like or understand about this feature
If you want to propose a new feature that OpenProject does not offer yet
To further help OpenProject to shape and test new features
To view OpenProject premium features and pricing
If you want to try all premium features in the OpenProject Cloud Edition 14 days for free
If you want to try all premium features in your on premise Community installation 14 days for free