[GH-ISSUE #2352] [Documentation] Manual Installation / Docker Compose #6944

Closed
opened 2026-04-25 15:56:15 -05:00 by GiteaMirror · 4 comments
Owner

Originally created by @ulab on GitHub (Jan 27, 2026).
Original GitHub issue: https://github.com/fosrl/pangolin/issues/2352

Describe the Bug

Following the Manual Installation / Docker Compose setup, I ran into a "404 Page not found" when navigating to the https://your-domain.com/auth/initial-setup.

While comparing the installer and manual configuration, I noticed the following differences:

  • docker-compose.yml
    • installer uses version numbers instead of latest for the images
    • healthcheck / interval and timeout use different values (10s vs 3s)
    • installer asks for and enables ipv6, maybe the manual config should have that as comment?
  • dynamic_config.yml
    • manual installation has tab before - badger instead of spaces
    • manual installation is missing the full tcp: section
  • traefik_config.yml
    • different badger versions
    • email in manual installation is missing quotes
    • encodedCharacters section is missing in manual installation
    • ping / entrypoint has two additional spaces in manual installation. I do think these matter in yml?

I am not sure if any of these resulted in my issue, but I do feel the configuration should at least be identical between these two setups.

Environment

Debian 12

To Reproduce

Follow the above linked documentation for the manual installation.

Expected Behavior

A similar if not identical configuration.

Originally created by @ulab on GitHub (Jan 27, 2026). Original GitHub issue: https://github.com/fosrl/pangolin/issues/2352 ### Describe the Bug Following the [Manual Installation / Docker Compose](https://docs.pangolin.net/self-host/manual/docker-compose) setup, I ran into a "404 Page not found" when navigating to the https://your-domain.com/auth/initial-setup. While comparing the installer and manual configuration, I noticed the following differences: - `docker-compose.yml` - installer uses version numbers instead of `latest` for the images - healthcheck / interval and timeout use different values (10s vs 3s) - installer asks for and enables ipv6, maybe the manual config should have that as comment? - `dynamic_config.yml` - manual installation has tab before `- badger` instead of spaces - manual installation is missing the full `tcp:` section - `traefik_config.yml` - different `badger` versions - `email` in manual installation is missing quotes - `encodedCharacters` section is missing in manual installation - `ping / entrypoint` has two additional spaces in manual installation. I do think these matter in yml? I am not sure if any of these resulted in my issue, but I do feel the configuration should at least be identical between these two setups. ### Environment Debian 12 ### To Reproduce Follow the above linked documentation for the manual installation. ### Expected Behavior A similar if not identical configuration.
Author
Owner

@oschwartz10612 commented on GitHub (Jan 27, 2026):

Not sure if you have the time but a PR on the docs page would be awesome
to resolve this.

I will only say we use latest on the example because we want to avoid
the tags getting old / stale in the docs. But the badger version should
be up to date.

<!-- gh-comment-id:3807759094 --> @oschwartz10612 commented on GitHub (Jan 27, 2026): Not sure if you have the time but a PR on the docs page would be awesome to resolve this. I will only say we use latest on the example because we want to avoid the tags getting old / stale in the docs. But the badger version should be up to date.
Author
Owner

@ulab commented on GitHub (Jan 28, 2026):

I will give it a try, but it's my first look at the software, so I need someone to proofread :-).

I guess it's best to copy this over to docs-v2 and close this for now?

<!-- gh-comment-id:3809294452 --> @ulab commented on GitHub (Jan 28, 2026): I will give it a try, but it's my first look at the software, so I need someone to proofread :-). I guess it's best to copy this over to docs-v2 and close this for now?
Author
Owner

@ulab commented on GitHub (Jan 28, 2026):

Will push a PR to the right repository.

<!-- gh-comment-id:3809666336 --> @ulab commented on GitHub (Jan 28, 2026): Will push a PR to the right repository.
Author
Owner

@oschwartz10612 commented on GitHub (Jan 28, 2026):

Thanks for doing this fix! 🙌

<!-- gh-comment-id:3814383055 --> @oschwartz10612 commented on GitHub (Jan 28, 2026): Thanks for doing this fix! 🙌
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/pangolin#6944