System admin 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.



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.
Calendars and dates Configure working days, dates formats and calendar subscriptions.
System settings Configure your system settings, e.g. a welcome text block on the landing page, languages, repositories, and more.
Emails and notifications Manage notifications and emails.
API and webhooks Manage APIs and configure webhooks.
Authentication Configure authentication methods in OpenProject, e.g. OAuth, OpenID, Two-factor-authentication, LDAP, and more.
GDPR Review and sign a Data Processing Agreement (DPA).
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.
Enterprise edition Upgrading and managing OpenProject Enterprise and other administrative topics.
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.
Files Settings for attachments and virus scanning functionality in OpenProject. Manage external file storages.
External file storages - Nextcloud Set up external file storages with Nextcloud.
External file storages - One Drive Set up external file storages with One Drive.
Plugins Manage plugins in OpenProject.
Information View the latest system information status.
Integrations How to integration OpenProject into other tools (eg. GitHub, Nextcloud…)