Add information about docker tags and automatic updates (#1632)

* feat(container): add information about docker tags and automatic updates * feat(tags): add tag descriptions to the docs instead of referencing the forum * fix: update internal links * fix: update internal links * remove added latest tags * adjust verbiage * remove tag from docker compose instructions * fix linting * apply suggested changes to container.md --------- Co-authored-by: BotBlake <B0TBlake@protonmail.com>
2026-09-03 04:10:04 +03:00 · 2025-11-19 14:41:10 +08:00
parent 35a84737e3
commit 940ded6f87
3 changed files with 11 additions and 2 deletions
@@ -13,13 +13,14 @@ You WILL NOT receive any support for running Jellyfin in Docker on platforms oth

 :::

-Create a `docker-compose.yml` file with the following contents. Add in the UID and GID that you would like to run jellyfin as in the user line below, or remove the user line to use the default (root).
+Create a `docker-compose.yml` file like the following.

 ```yml
 services:
  jellyfin:
    image: jellyfin/jellyfin
    container_name: jellyfin
+    # Optional - specify the uid and gid you would like Jellyfin to use instead of root
    user: uid:gid
    ports:
      - 8096:8096/tcp
@@ -44,7 +44,7 @@ The `--user` option will run with the provided user id and group id _inside_ the
 The `--userns keep-id` flag ensures that current user's id is mapped to the non-root user's id inside the container.
 This ensures that the permissions for directories bind-mounted inside the container are mapped correctly between the user running Podman and the user running Jellyfin inside the container.

-Keep in mind that the `--label "io.containers.autoupdate=image"` flag will allow the container to be automatically updated via `podman auto-update`.
+Keep in mind that the `--label "io.containers.autoupdate=image"` flag will allow the container to be automatically updated via `podman auto-update`, and a [backup](/docs/general/administration/backup-and-restore) will be required to restore a previous version.

 The `z` (shared volume) or `Z` (private volume) volume option and `relabel=shared` or `relabel=private` mount option tell Podman to relabel files inside the volumes as appropriate, for systems running SELinux.

@@ -19,6 +19,14 @@ hotio image: `ghcr.io/hotio/jellyfin`.
 Jellyfin distributes official container images on [Docker Hub](https://hub.docker.com/r/jellyfin/jellyfin/) and the [GitHub Container Registry](https://ghcr.io/jellyfin/jellyfin) for multiple architectures.
 These images are based on Debian and [built directly from the Jellyfin source code](https://github.com/jellyfin/jellyfin-packaging/blob/master/docker/Dockerfile).

+Several tags are available tracking different builds and [version](/docs/general/contributing/release-procedure/#versioning) levels.
+
+- `latest` always tracks the latest stable release, including through major and minor version bumps
+- `X` (e.g. `10`) tracks the major version, e.g. the latest 10.Y.Z
+- `X.Y` (e.g. `10.11`) tracks the minor version, e.g. the latest 10.11.Z
+- `X.Y.Z` (e.g. `10.11.0`) tracks a specific release
+- `X.Y.Z.YYYYMMDD-HHMMSS` (e.g. `10.11.0.20251020-004604`) tracks a specific packaging build
+
 Additionally, there are several third parties providing unofficial container images, including the [LinuxServer.io](https://www.linuxserver.io/) ([Dockerfile](https://github.com/linuxserver/docker-jellyfin/blob/master/Dockerfile)) project and [hotio](https://github.com/hotio) ([Dockerfile](https://github.com/hotio/jellyfin/blob/release/linux-amd64.Dockerfile)), which offer images based on Ubuntu and the official Jellyfin Ubuntu binary packages.

 ## Installation Instructions