Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on macOS
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 macOS?
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 bash setup.sh. 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: xcode-select --install
git clone https://github.com/opf/openproject.git cd openproject
Node.js ^24.22.1, Ruby 4.0.10
# needs nvm: brew install nvm (or https://github.com/nvm-sh/nvm) nvm install 24 brew install rbenv ruby-build rbenv install --skip-existing
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
cp .env.example .env
Needs: Memcached
brew install --cask docker # Docker Desktop docker compose -f docker-compose.yml up -d
npm ci bundle install
bin/rails db:prepare
bin/dev
npm test bin/rails test
No reports for macOS yet.
GitManual AI Agent reads the 16 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.