# OpenProject — Self-Hosted Open Source Project Management

> A full-featured project management platform with Gantt charts, agile boards, time tracking, cost reporting, and team collaboration built for self-hosting.

## Install

Save in your project root:

# OpenProject — Self-Hosted Open Source Project Management

## Quick Use
```bash
docker run -d -p 8080:80 -e OPENPROJECT_SECRET_KEY_BASE=secret 
  openproject/openproject:14
# Open http://localhost:8080 — default admin/admin
```

## Introduction
OpenProject is a web-based project management system written in Ruby on Rails. It covers the full project lifecycle from planning through execution, offering classic Gantt charts, agile boards, budgets, and time tracking in a single self-hosted application that teams own and control.

## What OpenProject Does
- Manages work packages with custom types, statuses, and workflows
- Provides interactive Gantt charts for timeline planning and dependency tracking
- Supports Scrum and Kanban boards for agile project execution
- Tracks time and costs with built-in reporting and budget management
- Integrates with Git and Subversion repositories for linking commits to work items

## Architecture Overview
OpenProject is a Ruby on Rails monolith backed by PostgreSQL. It uses a background job processor (GoodJob) for async tasks like notifications and mail delivery. The frontend is an Angular single-page application that communicates with the backend via a JSON:API-compliant REST API. File storage can be local or delegated to Nextcloud or S3-compatible backends.

## Self-Hosting & Configuration
- Deploy via Docker Compose with the official `openproject/openproject` image
- Alternatively install on Ubuntu/Debian via the packaged DEB installer
- Configure SMTP settings for email notifications in `configuration.yml` or environment variables
- Set `OPENPROJECT_SECRET_KEY_BASE` and `DATABASE_URL` as required environment variables
- Use a reverse proxy (Nginx, Caddy) for HTTPS and optionally enable LDAP or SAML for SSO

## Key Features
- Full Gantt chart editor with drag-and-drop scheduling and auto-rescheduling
- Built-in meeting management with agendas and minutes linked to work packages
- Fine-grained role-based access control with project-level permissions
- BIM module for construction and architecture project workflows
- REST API and webhooks for integrating with CI/CD, chat tools, and custom automations

## Comparison with Similar Tools
- **Jira** — SaaS with complex licensing; OpenProject is self-hosted and open core
- **Plane** — lighter-weight and newer; OpenProject offers deeper Gantt and cost tracking
- **Taiga** — focused on agile; OpenProject also covers waterfall, hybrid, and BIM workflows
- **Redmine** — similar heritage but aging UI; OpenProject has a modern Angular frontend
- **Leantime** — simpler and more opinionated; OpenProject provides enterprise-grade customization

## FAQ
**Q: Is OpenProject fully open source?**
A: The Community edition is GPLv3. Enterprise features like LDAP group sync and 2FA are in a paid edition built on the same codebase.

**Q: Can OpenProject replace Jira for my team?**
A: For many teams, yes. It covers work tracking, agile boards, Gantt charts, and time logging. Complex Jira plugin ecosystems may not have direct equivalents.

**Q: What databases does OpenProject support?**
A: PostgreSQL is the only supported production database. SQLite is not recommended beyond evaluation.

**Q: How do I migrate from another tool?**
A: OpenProject provides CSV importers and a REST API. Community plugins exist for importing from Redmine and Jira.

## Sources
- https://github.com/opf/openproject
- https://www.openproject.org/docs/

---
Source: https://tokrepo.com/en/workflows/b4cc199a-3e02-11f1-9bc6-00163e2b0d79
Author: AI Open Source