Komga

Komga is a free and open source comics/mangas/magazines server.

Version tags

This image provides various versions that are available via tags.

Tag	Description
`beta`	build from latest commit
`latest`	latest stable release
`x.y.z`	version `x.y.z`

Usage

Here are some example snippets to help you get started creating a container.

docker

docker create \
  --name=komga \
  --user 1000:1000 \
  -p 8080:8080 \
  -e KOMGA_USER_PASSWORD=your-user-password
  -e KOMGA_ADMIN_PASSWORD=your-admin-password
  -e KOMGA_LIBRARIES_SCAN_DIRECTORY_EXCLUSIONS=#recycle,@eaDir
  -v path/to/data:/config \
  -v path/to/books:/books \
  --restart unless-stopped \
  gotson/komga

docker-compose

---
version: '3'
services:
  komga:
    image: gotson/komga
    container_name: komga
    volumes:
      - path/to/data:/config
      - path/to/books:/books
      - /etc/timezone:/etc/timezone:ro
    ports:
      - 8080:8080
    user: "1000:1000"
    environment:
      - KOMGA_USER_PASSWORD=your-user-password
      - KOMGA_ADMIN_PASSWORD=your-admin-password
      - KOMGA_LIBRARIES_SCAN_DIRECTORY_EXCLUSIONS=#recycle,@eaDir
    restart: unless-stopped

Parameters

Container images are configured using parameters passed at runtime (such as those above). These parameters are separated by a colon and indicate external:internal respectively. For example, -p 8080:80 would expose port 80 from inside the container to be accessible from the host's IP on port 8080 outside the container.

Parameter	Function
`-p 8080`	The port for the Komga APIs and web interface
`--user: 1000:1000`	User:Group identifier - see below for explanation
`-v /config`	Database and Komga configurations
`-v /books`	Location of books library on disk
`-e KOMGA_USER_PASSWORD`	Password for the `user` user
`-e KOMGA_ADMIN_PASSWORD`	Password for the `admin` user
`-e KOMGA_LIBRARIES_SCAN_DIRECTORY_EXCLUSIONS`	Comma-separated list of patterns to exclude directories from the scan

User / Group Identifiers

When using volumes (-v flags) permissions issues can arise between the host OS and the container, we avoid this issue by allowing you to specify the user ID and group ID.

Ensure any volume directories on the host are owned by the same user you specify and any permissions issues will vanish like magic.

In this instance UID=1000 and GID=1000, to find yours use id user as below:

$ id username
  uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

Support info

Shell access whilst the container is running: docker exec -it komga /bin/bash
To monitor the logs of the container in realtime: docker logs -f komga

Updating

Below are the instructions for updating containers:

Via Docker Run/Create

Update the image: docker pull gotson/komga
Stop the running container: docker stop komga
Delete the container: docker rm komga
Recreate a new container with the same docker create parameters as instructed above (if mapped correctly to a host folder, your /config folder and settings will be preserved)
Start the new container: docker start komga
You can also remove the old dangling images: docker image prune

Via Docker Compose

Update all images: docker-compose pull
- or update a single image: docker-compose pull komga
Let compose update all containers as necessary: docker-compose up -d
- or update a single container: docker-compose up -d komga
You can also remove the old dangling images: docker image prune

4.6 KiB Raw Blame History