MasterpieceDockerCompose/komga/README.md

101 lines
2.6 KiB
Markdown
Raw Normal View History

2021-05-17 10:40:18 +02:00
# Komga in docker
<div align="center">
<img src="https://i.ibb.co/3hc9vKb/Screenshot-2021-05-17-Komga.png" />
</div>
# Descrizione
* [Sito ufficiale](https://komga.org/)
* [Repo (Github)](https://github.com/gotson/komga)
Komga è un server per la gestione di manga/comics:
- Interfaccia web moderna e compatibile con tablet e smartphone
- Possibilità di organizzare, modificare e importare i metadati (anche integrati)
- Multiutente, con possiblità di gestire l'accesso alle librerie (anche singolarmente)
- Lettore web dotato con varie personalizzioni (di lettura e non solo)
- Possibilità di interazione esterna tramite REST API
# Struttura file e cartelle
```
/home/
└── ~/
└── docker/
└── komga/
├── config/
├── data/
├── .env
└── docker-compose.yml
```
* `config/` - la cartella dove risiedono i dati che servono a komga
* `data/` - la cartella dove vanno messi i manga/comics
* `.env` - un file contenenti le variabili environment per il docker compose
* `docker-compose.yml` - il docker compose per creare il container
Tutti i file e le cartelle devono essere creati a mano.</br>
# docker-compose
`docker-compose.yml`
```yml
version: "3"
services:
komga:
container_name: komga
image: gotson/komga
restart: unless-stopped
ports:
- ${KOMGA_PORT:-8080}:8080
env_file: .env
volumes:
- ${KOMGA_CONFIG:-/home/docker/komga/config}:/config
- ${KOMGA_DATA:-/home/docker/komga/data:/data
```
`.env`
```bash
# Generale
2021-05-17 11:57:31 +02:00
KOMGA_PORT=8080
KOMGA_CONFIG=/config
KOMGA_DATA=/data
2021-05-17 10:40:18 +02:00
# Komga
ND_LOGLEVEL=info
```
# Reverse proxy
Ancora non ho previsto l'uso di un reverse proxy. (Vedi [Todo](#Todo))
# Aggiornamenti
[Watchtower](https://github.com/DoTheEvo/selfhosted-apps-docker/tree/master/watchtower) aggiorna l'immagine automaticamente.
Aggiornamento manuale:
- `docker-compose pull`</br>
- `docker-compose up -d`</br>
- `docker image prune`
# Backup e ripristino
#### Backup
Copiare a mano, tramite crontab o altro la cartella `komga` (Vedi [Todo](#Todo))
#### Ripristino
* spegnere il container `docker-compose down`</br>
* cancellare l'intera cartella `komga`</br>
* dal backup copiare la cartella `komga`</br>
* far partire il container `docker-compose up -d`
# Todo
Implementare:
- reverse proxy: **[caddy](https://caddyserver.com/) o [traefik](https://doc.traefik.io/traefik/).**
- backup: **[borg](https://github.com/DoTheEvo/selfhosted-apps-docker/tree/master/borg_backup) per fare i backup giornalieri completi.**