Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Instructions on the openproject site are apparently (badly) out of date

Open
#87 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
35/100
Issue type
Documentation
Clarity
Needs clarification
Activity status
Quiet
Tech stack
docker, docker-compose, postgresql

Research direction

Start with the “All in one container” section and the linked docs/installation-and-operations/installation/docker instructions. Compare the documented deployment with the reported PostgreSQL setup, migration step, port 8080 behavior, missing user, and project-copy failures. Done when the supported setup and prerequisites are accurately documented or the reported problems are confirmed and scoped.

Written by the indexing model from the issue text.

Description

needs more info

I followed the instructions in the section "All in one container", which appear to be the same as the ones found at https://github.com/opf/openproject/tree/dev/docs/installation-and-operations/installation/docker.

Either the deploy process, as described, is broken, or I totally misunderstood the instructions. Among the problems I found:

  • the container has no postgres DBMS installed (I supplied one form the outside, creating role and database)
  • an additional migration step was required (prbly because the external DBMS I supplied is postgres16)
  • the container listens on port 8080 (the docs say 80)
  • there is no user admin (or otherwise), all records in the users tables have no login field. I added a user through psql AND the ruby console (in the container)
  • After the instance is up and running a number of functions (notably create prj from template/copy porject) appear not to be working (they post a spinner that never terminates, project is not copied/created).
Dominant language
Shell
Stars
347
Forks
319
PR merge metrics
No merged PRs in 30d

Getting set up

  • Ships a Dockerfile or Docker Compose file
  • No pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from opf/openproject-docker-compose

All issues in opf/openproject-docker-compose

Similar issues

More Shell/Bash issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.