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.

image-20201006154046435

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.
Email 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.