mirror of
https://github.com/funkypenguin/geek-cookbook/
synced 2025-12-13 01:36:23 +00:00
cf44acda27
* Add recipe for searxng Signed-off-by: David Young <davidy@funkypenguin.co.nz> * Fussy linter Signed-off-by: David Young <davidy@funkypenguin.co.nz> --------- Signed-off-by: David Young <davidy@funkypenguin.co.nz>
88 lines
3.1 KiB
Markdown
88 lines
3.1 KiB
Markdown
---
|
|
title: How to run Komga with Docker
|
|
description: Run Komga under Docker Swarm in docker-compose syntax
|
|
recipe: Komga
|
|
---
|
|
|
|
# Komga in Docker Swarm
|
|
|
|
So you've just watched a bunch of superhero movies, and you're suddenly inspired to deep-dive into the weird world of comic books? You're already rocking [AutoPirate](/recipes/autopirate/) with [Mylar](/recipes/autopirate/mylar/) and [NZBGet](/recipes/autopirate/nzbget/) to grab content, but how to manage and enjoy your growing collection?
|
|
|
|
{ loading=lazy }
|
|
|
|
[Komga](https://komga.org/) is a media server with a beautifully slick interface, allowing you to read your comics / manga in CBZ, CBR, PDF and epub format. Komga includes an integrated web reader, as well as a [Tachiyomi](https://tachiyomi.org/) plugin and an OPDS server for integration with other mobile apps such as [Chunky on iPad](https://apps.apple.com/us/app/chunky-comic-reader/id663567628).
|
|
|
|
## {{ page.meta.recipe }} Requirements
|
|
|
|
--8<-- "recipe-standard-ingredients.md"
|
|
|
|
* [X] [AutoPirate](/recipes/autopirate/) components (*specifically [Mylar](/recipes/autopirate/mylar/)*), for searching for, downloading, and managing comic books
|
|
|
|
## Preparation
|
|
|
|
### Setup data locations
|
|
|
|
First we create a directory to hold the komga database, logs and other persistent data:
|
|
|
|
```bash
|
|
mkdir /var/data/komga
|
|
```
|
|
|
|
### {{ page.meta.recipe }} Docker Swarm config
|
|
|
|
Create a docker swarm config file in docker-compose syntax (v3), something like the example below:
|
|
|
|
--8<-- "premix-cta.md"
|
|
|
|
```yaml
|
|
version: "3.2"
|
|
|
|
services:
|
|
komga:
|
|
image: gotson/komga
|
|
env_file: /var/data/config/komga/komga.env
|
|
volumes:
|
|
- /var/data/media/:/media
|
|
- /var/data/komga:/config
|
|
deploy:
|
|
replicas: 1
|
|
labels:
|
|
# traefik common
|
|
- traefik.enable=true
|
|
- traefik.docker.network=traefik_public
|
|
|
|
# traefikv1
|
|
- traefik.frontend.rule=Host:komga.example.com
|
|
- traefik.port=8080
|
|
|
|
# traefikv2
|
|
- "traefik.http.routers.komga.rule=Host(`komga.example.com`)"
|
|
- "traefik.http.services.komga.loadbalancer.server.port=8080"
|
|
- "traefik.enable=true"
|
|
|
|
# Remove if you wish to access the URL directly
|
|
- "traefik.http.routers.komga.middlewares=forward-auth@file"
|
|
networks:
|
|
- traefik_public
|
|
|
|
networks:
|
|
traefik_public:
|
|
external: true
|
|
```
|
|
|
|
## Serving
|
|
|
|
### Avengers Assemble!
|
|
|
|
Launch the Komga stack by running ```docker stack deploy komga -c <path -to-docker-compose.yml>```
|
|
|
|
Log into your new instance at https://**YOUR-FQDN**. Since it's a fresh installation, Komga will prompt you to setup a username and password, after which you'll be able to setup your library, and tweak all teh butt0ns!
|
|
|
|
### Save teh wurld!
|
|
|
|
If Komga scratches your particular itch, please join me in [sponsoring the developer](/#sponsored-projects) :heart:
|
|
|
|
[^1]: Since Komga doesn't need to communicate with any other services, we don't need a separate overlay network for it. Provided Traefik can reach Komga via the `traefik_public` overlay network, we've got all we need.
|
|
|
|
--8<-- "recipe-footer.md"
|