axiilay/chown repository overview

⁠axiilay/chown Docker Image Overview

⁠Purpose

This is a lightweight Alpine-based utility image designed to fix permission issues for OpenList users upgrading to version 4.1.0 and later. It automatically changes the ownership of the /opt/openlist/data directory to 1001:1001, which is required by the new OpenList container architecture.

⁠Background

Starting from OpenList v4.1.0 (excluding v4.1.0 itself), the official OpenList Docker image has undergone significant changes:

• Removed PUID and PGID environment variables
• Added a dedicated openlist user (UID 1001) and group (GID 1001)
• The application now runs under this non-root user for enhanced security

This change can cause permission issues, especially on NAS devices where Docker doesn't allow running containers with root privileges to modify directory permissions.

⁠Features

• Lightweight: Based on Alpine Linux (minimal footprint)
• Single Purpose: Only changes ownership to 1001:1001
• Quick Execution: Runs and exits immediately after changing permissions
• NAS-Friendly: Works on restricted Docker environments where root access is limited

⁠Usage

⁠Basic Usage

Run this container before starting OpenList to fix permissions:

# Step 1: Fix permissions using this image
docker run --rm -v /your/openlist/data:/opt/openlist/data axiilay/chown

# Step 2: Start OpenList normally
docker run -d --restart=unless-stopped \
  -v /your/openlist/data:/opt/openlist/data \
  -p 5244:5244 \
  -e UMASK=022 \
  --name="openlist" \
  openlistteam/openlist:latest

⁠Docker Compose Example

version: '3.8'
services:
  chown-fix:
    image: axiilay/chown:latest
    volumes:
      - ./data:/opt/openlist/data
    restart: "no"
    
  openlist:
    image: openlistteam/openlist:latest
    depends_on:
      - chown-fix
    restart: unless-stopped
    volumes:
      - ./data:/opt/openlist/data
    ports:
      - "5244:5244"
    environment:
      - UMASK=022

⁠When to Use This Image

Use this image when:

• Upgrading OpenList from versions before v4.1.0 to v4.1.0 or later
• Encountering "Current user does not have write and/or execute permissions" errors
• Running OpenList on NAS devices with restricted Docker permissions
• Unable to use sudo chown or --user root options in your Docker environment

⁠Technical Details

• Base Image: alpine:latest
• Command: chown 1001:1001 /opt/openlist/data
• Volume Mount Required: /opt/openlist/data (must match OpenList's data directory)

⁠Troubleshooting

If you still encounter permission issues after using this image:

1. Ensure the volume mount path is correct
2. Verify the directory exists before running the container
3. Check if your Docker daemon has sufficient permissions to modify the mounted directory

⁠Related Links

• OpenList Official Documentation⁠
• OpenList Docker Installation Guide⁠
• OpenList GitHub Repository⁠
• Fix OpenList Permission Error on Your NAS⁠

⁠Support

For issues specific to this utility image, please open an issue on the repository. For OpenList-related questions, refer to the official OpenList documentation and community channels.

This image is a community contribution to help OpenList users with the v4.1.0+ permission migration.