Installing Komga on Fedora

📢 This article was translated by gemini-3-flash-preview

Introduction

Setting this up to make reading manga easier on my local network.

IP Settings

My router runs OpenWRT.

Router Setup

Go to Network - IP/MAC Binding and bind a static IP to the computer.

Fedora Setup

Since the static IP I want is different from the auto-assigned one (wired connection), I need to change it manually.

In Network - Settings, under the Identity tab, add the MAC Address. Change IPv4 to Manual. Set the addresses as IP, 255.255.255.0, Router IP. For DNS, add the Router IP. I kept the automatic toggle checked.

Local DNS

While IP access works, a domain name is much easier to remember.

On the router, go to Network - Hostnames. Enter your desired domain in the Hostname field and the computer’s IP in the IP Address field.

Installing Docker

I went with Docker Desktop for the GUI.

Set up the Repository

1
dnf -y install dnf-plugins-core
1
2
3
sudo dnf config-manager \
    --add-repo \
    https://download.docker.com/linux/fedora/docker-ce.repo

Download the RPM Package

Download it from the Official Website .

Once downloaded, double-click to install.

Installing Komga

Docker Configuration

  • File Sharing

    In Docker Desktop, go to Settings - Resources - File sharing and add the path to your manga.

    Note: If the shared directory is missing (not mounted) on the next boot, Docker will fail to start.

  • Network Settings

    Not sure if this is strictly necessary, but I set the subnet to match my own in Settings - Resources - Network.

Installation via CLI

Run this directly in the shell:

1
2
3
4
5
6
7
8
docker run \
  --name=komga \
  --user 1000:1000 \
  -p 2333:8080 \
  -v /home/yexca/komga/config:/config \
  -v /home/yexca/komga/data:/data \
  --restart unless-stopped \
  gotson/komga:latest
  • -p: Maps the host port (left) to the container port (right).
  • -v: Volume mapping. Maps a host directory (/home/yexca/komga/config) to the container (/config).

Note: You cannot map hidden files (files starting with .) from the host.

Installation via GUI

After the previous step, gotson/komga will appear in the Images tab of Docker Desktop. Click run and configure:

  • First line: Name.
  • Ports: Host port mapping. Set to 80 if you want to access it directly via the domain name.
  • Volumes: Path mappings.
  • Environment variables: Not needed for this setup.

Verify Running Status

Check the status with:

1
docker ps -a

Firewall Configuration

Open the port:

1
firewall-cmd --zone=public --add-port=80/tcp

Reload the configuration:

1
firewall-cmd --reload

Check if the port is open:

1
firewall-cmd --zone=public --query-port=80/tcp

You might need to add the HTTP service:

1
firewall-cmd --add-service=http

If you hate CLI, just use the GUI—it’s probably faster anyway:

1
sudo yum install firewall-config

References

Install Docker Desktop on Fedora - Docker Documentation

【Docker】Error response from daemon: invalid mount config for type “bind”: bind source path does not exist - Qiita

Run with Docker - Komga

简约但绝不简单的Komga-老苏的blog

fedora 28 , firewalld 防火墙控制,firewall-cmd 管理防火墙规则 - xuyaowen - 博客园

Fedora防火墙配置 - 上官飞鸿 - 博客园

原神自动签到(Linux服务器Docker) - yexca’Blog

Fedora 打开8080端口_chunqi zhi的博客-CSDN博客

This post is licensed under CC BY-NC-SA 4.0 by the author.