Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on Windows
OpenProject is the leading open source project management software for product, project and portfolio management. A powerful Jira alternative with agile planning, issue tracking, roadmaps, Gantt charts, time tracking, collaboration features, and more. Available on premises or in the cloud. ⭐ Star us on GitHub
Saved setup from 2 h ago
Will it work on Windows?
wsl --install) plus the Linux steps is the smoothest path.Heads-upIt also needs Memcached and 50 settings in .env (17 secret).
The maintainers included bin/setup. Open it to see how it's meant to be run: bin/setup on GitHub.
Also: bin/setup_dev
Then run powershell -ExecutionPolicy Bypass -File .\setup.ps1. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: winget install Git.Git
git clone https://github.com/opf/openproject.git cd openproject
Node.js ^24.22.1, Ruby 4.0.10
winget install CoreyButler.NVMforWindows nvm install 24 nvm use 24 # Install Ruby+Devkit from https://rubyinstaller.org (or use WSL — recommended for Ruby)
Fill in secrets: OPENPROJECT_COLLABORATIVE__EDITING__HOCUSPOCUS__SECRET, DB_PASSWORD, SMTP_PASSWORD, NEXTCLOUD_LOCAL_OAUTH_CLIENT_SECRET, NEXTCLOUD_LOCAL_OPENPROJECT_SECRET, NEXTCLOUD_LOCAL_OAUTH_CLIENT_ACCESS_TOKEN, NEXTCLOUD_LOCAL_OAUTH_CLIENT_REFRESH_TOKEN, NEXTCLOUD_LOCAL_AMPF_PASSWORD
Copy-Item .env.example .env
Needs: Memcached
winget install Docker.DockerDesktop docker compose -f docker-compose.yml up -d
npm ci bundle install
ruby bin/rails db:prepare
ruby bin/dev
npm test ruby bin/rails test
This project relies on Unix tooling. On Windows, WSL2 (wsl --install) plus the Linux steps is the smoothest path.
No reports for Windows yet.
GitManual AI Agent reads the 16 key files and writes a step-by-step guide for Windows. Once written, it's saved for everyone.