docs/system-admin-guide/README.md
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. |
| 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. |
| Documents | Settings for document types and real-time collaboration in OpenProject. |
| 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...) |