[PR #1850] [CLOSED] feat: add PUID PGID UMASK settings to image #3630

Closed
opened 2026-04-25 00:16:25 +02:00 by adam · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/advplyr/audiobookshelf/pull/1850
Author: @DDSRem-Bot
Created: 6/16/2023
Status: Closed

Base: masterHead: master


📝 Commits (2)

  • e671508 feat: add PUID PGID UMASK settings to image
  • 5512ee9 fix: program directory permissions

📊 Changes

2 files changed (+53 additions, -7 deletions)

View changed files

📝 Dockerfile (+12 -7)
entrypoint.sh (+41 -0)

📄 Description

Changes

docker pull ghcr.io/advplyr/audiobookshelf

docker run -d \
  -p 13378:80 \
  -v </path/to/config>:/config \
  -v </path/to/metadata>:/metadata \
  -v </path/to/audiobooks>:/audiobooks \
  -v </path/to/podcasts>:/podcasts \
  --health-cmd="curl -f http://127.0.0.1/healthcheck || exit 1" \
  --health-interval=30s \
  --health-timeout=3s \
  --health-start-period=10s \
  --name audiobookshelf \
  --rm ghcr.io/advplyr/audiobookshelf
version: "3.7"
services:
  audiobookshelf:
    image: ghcr.io/advplyr/audiobookshelf:latest
    ports:
      - 13378:80
    volumes:
      - </path/to/audiobooks>:/audiobooks
      - </path/to/podcasts>:/podcasts
      - </path/to/config>:/config
      - </path/to/metadata>:/metadata
    healthcheck:
      test: ["CMD", "curl", "-f", "http://127.0.0.1/healthcheck"]
      interval: 30s
      timeout: 3s
      start_period: 10s

Because HEALTHCHECK will take up a certain amount of performance, it is more reasonable to make user-defined settings

Explain

The node base image comes with a node user. The container gets the uid and gid from the PUID PGID environment variable set by the user and changes the uid of the node user and the gid of the node user group. this unifies the user and user group for file permissions inside and outside the container


🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/advplyr/audiobookshelf/pull/1850 **Author:** [@DDSRem-Bot](https://github.com/DDSRem-Bot) **Created:** 6/16/2023 **Status:** ❌ Closed **Base:** `master` ← **Head:** `master` --- ### 📝 Commits (2) - [`e671508`](https://github.com/advplyr/audiobookshelf/commit/e6715081dd41e193a04f000c22e18e5833dfb4fc) feat: add PUID PGID UMASK settings to image - [`5512ee9`](https://github.com/advplyr/audiobookshelf/commit/5512ee9ee9176543a0bf7de6a480b4c4499072c1) fix: program directory permissions ### 📊 Changes **2 files changed** (+53 additions, -7 deletions) <details> <summary>View changed files</summary> 📝 `Dockerfile` (+12 -7) ➕ `entrypoint.sh` (+41 -0) </details> ### 📄 Description ## Changes - Add `UMASK` environment variable setting. The usefulness of `UMASK` setting can be seen in the explanation of linuxserver: https://github.com/linuxserver/docker-radarr#umask-for-running-applications - Add `PUID` `PGID` environment variable setting (Use this setting to replace the previous `AUDIOBOOKSHELF_UID/GID` setting). The usefulness of `PUID` `PGID` settings can be seen in the explanation of linuxserver: https://github.com/linuxserver/docker-radarr#user--group-identifiers - Remove the HEALTHCHECK specified in the Dockerfile. Use the following method to set HEALTHCHECK: ```bash docker pull ghcr.io/advplyr/audiobookshelf docker run -d \ -p 13378:80 \ -v </path/to/config>:/config \ -v </path/to/metadata>:/metadata \ -v </path/to/audiobooks>:/audiobooks \ -v </path/to/podcasts>:/podcasts \ --health-cmd="curl -f http://127.0.0.1/healthcheck || exit 1" \ --health-interval=30s \ --health-timeout=3s \ --health-start-period=10s \ --name audiobookshelf \ --rm ghcr.io/advplyr/audiobookshelf ``` ```yaml version: "3.7" services: audiobookshelf: image: ghcr.io/advplyr/audiobookshelf:latest ports: - 13378:80 volumes: - </path/to/audiobooks>:/audiobooks - </path/to/podcasts>:/podcasts - </path/to/config>:/config - </path/to/metadata>:/metadata healthcheck: test: ["CMD", "curl", "-f", "http://127.0.0.1/healthcheck"] interval: 30s timeout: 3s start_period: 10s ``` Because HEALTHCHECK will take up a certain amount of performance, it is more reasonable to make user-defined settings ## Explain The node base image comes with a `node` user. The container gets the uid and gid from the PUID PGID environment variable set by the user and changes the uid of the node user and the gid of the node user group. this unifies the user and user group for file permissions inside and outside the container --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
adam added the pull-request label 2026-04-25 00:16:25 +02:00
adam closed this issue 2026-04-25 00:16:25 +02:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/audiobookshelf#3630