mogeko/alist repository overview

⁠container-alist

A distroless and rootless container for Alist⁠.

⁠Usage

Set up a Alist server with the following command:

podman run -d \
    --name alist \
    --userns=keep-id:uid=65532,gid=65532 \
    -v /path/to/save/data:/opt/alist/data \
    -p 5244:5244 \
    ghcr.io/mogeko/alist:latest

Then, set a password for the admin account:

# Randomly generate a password.
podman exec -it alist /usr/bin/alist admin random
# Set a password manually. Replace NEW_PASSWORD with your password.
podman exec -it alist /usr/bin/alist admin set NEW_PASSWORD

Finally, visit http://localhost:5244⁠ and log in with the admin account.

For more information, please refer to the Alist documentation⁠.

⁠UID/GID mapping

In the consideration of safety, the container runs as a non-root user with UID/GID 65532.

At the same time, as a distroless container⁠, there is not a shell inside the container. Therefore, we cannot use usermod to change the UID/GID of the user inside the container. So we use the --userns⁠ option of podman to map the UID/GID of the host to the UID/GID of the user inside the container.

Since (as I know) the Docker cannot map the UID/GID of the host to the specified UID/GID of the user inside the container, we suggest using Podman to run this container.

⁠"Distroless" Container Images

Learn more about distroless container images⁠.

⁠License

The code in this project is released under the MIT License⁠.