Skip to content

Documentation Update - Fladder-Rootless (Docker) #993

@Doodle-Aks

Description

@Doodle-Aks

Description

The Docker Installation/Usage guide instructs users to copy and use the provided docker-compose.yml file as-is.
A note in the file also mentions the use of fladder-rootless for rootless Docker setups, which I followed.

However, using the compose file without modifications did not work in my rootless Docker environment.
The default port mapping did not work and the logs didn't report any errors either.
Changing the port mapping from 80:80 to xxxx:8080 (xxxx - use any port number you want) worked, and the application worked as expected.

Just wanted to add this note for future users who might stumble upon this issue.
It may be helpful to update the documentation for this requirement or add a note for rootless Docker users.

Reproduction steps

1. Navigate to https://github.com/DonutWare/Fladder/blob/develop/INSTALL.md
2. Docker Installation - Copy the contents of the docker-compose.yml file and save it to your server.
3. Switch Docker Image from ghcr.io/donutware/fladder:latest to ghcr.io/donutware/fladder-rootless:latest.
4. Comment out all the optional Environment Variables.
5. Run docker-compose up -d to start the container. It will be available on http://<server-ip>.
6. Unable to access Fladder URL (Works after changing the port-mapping in compose 80:80 to 10001:8080) and url to  http://<server-ip>:10001

Screenshots

No response

Logs

Configuring Fladder at root path

2026/05/14 19:59:27 [notice] 1#1: using the "epoll" event method

2026/05/14 19:59:27 [notice] 1#1: nginx/1.26.3

2026/05/14 19:59:27 [notice] 1#1: built by gcc 13.2.1 20240309 (Alpine 13.2.1_git20240309) 

2026/05/14 19:59:27 [notice] 1#1: OS: Linux 6.8.0-111-generic

2026/05/14 19:59:27 [notice] 1#1: getrlimit(RLIMIT_NOFILE): 1024:524288

2026/05/14 19:59:27 [notice] 1#1: start worker processes

2026/05/14 19:59:27 [notice] 1#1: start worker process 14

2026/05/14 19:59:27 [notice] 1#1: start worker process 15

2026/05/14 19:59:27 [notice] 1#1: start worker process 16

2026/05/14 19:59:27 [notice] 1#1: start worker process 17

2026/05/14 19:59:27 [notice] 1#1: start worker process 18

2026/05/14 19:59:27 [notice] 1#1: start worker process 19

2026/05/14 19:59:27 [notice] 1#1: start worker process 20

2026/05/14 19:59:27 [notice] 1#1: start worker process 21

Platform

Web

App Version

No response

Jellyfin server

10.11.8

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions