Skip to content

docs: Correct Docker setup errors + remove irrelevant native PostgreSQL instructions - #759

Merged
strycore merged 1 commit into
lutris:masterfrom
AlixBarreaux:readme-fix
May 21, 2026
Merged

docs: Correct Docker setup errors + remove irrelevant native PostgreSQL instructions#759
strycore merged 1 commit into
lutris:masterfrom
AlixBarreaux:readme-fix

Conversation

@AlixBarreaux

Copy link
Copy Markdown
Contributor

What

Fixes several errors in the README that block contributors from getting
the app running with the recommended Docker setup.

Changes

  • POSTGRES_PORT: 54345432
  • REDIS_PORT: 63786379
  • POSGRES_DB typo → POSTGRES_DB in the docker run command (was
    silently ignored by Docker, causing the container to use the wrong
    database name)
  • Postgres image: postgres:12postgres:18 : Django 5.2 raises
    NotSupportedError with PostgreSQL 12 (PostgreSQL 14 or later is required)
  • Removed native PostgreSQL setup instructions (Quickstart, user/db
    creation, owner/password management) : These only apply to a
    host-installed PostgreSQL. With the recommended Docker setup the
    container bootstraps everything from env vars, making these blocks
    misleading for contributors following the Docker path. Operational
    commands (drop schema, backup, restore) are kept as they remain
    useful during development regardless of setup method.

How I found this

Hit all of these while setting up a fresh local environment following
the README as written.

…QL instructions

- Fix POSTGRES_PORT: 5434 → 5432
- Fix REDIS_PORT: 6378 → 6379
- Fix POSGRES_DB typo → POSTGRES_DB in docker run command
- Bump postgres image: 12 → 18 (Django 5.2 requires PostgreSQL 14+)
- Remove native PostgreSQL setup instructions (Quickstart, user/db
  creation, permission management) : Redundant when using the
  recommended Docker setup where the container bootstraps everything
  from env vars; kept operational commands (drop, backup, restore)
  which remain useful regardless of setup method
@strycore
strycore merged commit 4c37625 into lutris:master May 21, 2026
2 checks passed
@strycore

Copy link
Copy Markdown
Member

thanks, I forgot to update the dockerfile since I'm using the native setup rather than docker

@AlixBarreaux
AlixBarreaux deleted the readme-fix branch May 27, 2026 13:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants