MasterpieceDockerCompose/navidrome/README.md

# Navidrome Music Server
<div align="center">
  <img src="https://raw.githubusercontent.com/navidrome/navidrome/master/.github/screenshots/ss-desktop-player.png" />
</div>

## Descrizione
[Sito ufficiale](https://www.navidrome.org/) - [Repo (Github)](https://github.com/navidrome/navidrome) - [Demo](https://demo.navidrome.org/) Login: ```demo``` Password: ```demo``` - [Docs](https://www.navidrome.org/docs/)

Navidrome è un server per la gestione e lo streaming di file musicali:
- Interfaccia web multilingua, tematizzabile, moderna e reattiva basata su Material UI
- Gestisce collezioni musicali molto grandi
- Usa i metadati integrati nei file
- Gestione multiutente, ogni utente ha le proprie playlist, preferiti, ecc...
- Supporto alla transcodifica on-the-fly (anche Opus) e può essere impostato per singolo utente
- Compatibile con tutti i client Subsonic/Madsonic/Airsonic
- Uso delle risorse molto contenuto

## Struttura file e cartelle
```
/home/
└── docker/
    └── navidrome/
        ├── data/
        ├── music/
        ├── .env
        └── docker-compose.yml
```

* `data/` - cartella dove risiedono i dati che servono a navidrome
* `music/` - cartella dove vanno messi i vostri file musicali (mp3, flac, etc)
* `.env` - file contenenti le variabili environment per il docker compose
* `docker-compose.yml` - file usato per creare il container

**N.B. Tutti i file e le cartelle devono essere creati a mano.**

## Esempi
Semplice esempio per iniziare ad usare subito il container

### docker-compose
`docker-compose.yml`
```yml
version: "3"
services:
  navidrome:
    container_name: navidrome
    image: deluan/navidrome
    restart: unless-stopped
    ports:
      - ${NAVIDROME_WEBUI_PORT:-4533}:4533
    env_file: .env
    volumes:
      - ${NAVIDROME_DATA:-/home/docker/navidrome/data}:/data
      - ${MUSIC_DIR:-/home/music}:/music:ro
```

`.env`
```bash
# Generale
NAVIDROME_WEBUI_PORT=4533
NAVIDROME_DATA=/home/docker/navidrome/data
MUSIC_DIR=/home/music

# Navidrome
ND_LOGLEVEL=info
```

## Reverse proxy
Ancora non ho previsto l'uso di un reverse proxy (Vedi [Todo](#Todo))

## Aggiornamento
### Automatico
Usando [watchtower](../watchtower) il container si aggiorna automaticamente

### Manuale
1. `docker-compose pull`
2. `docker-compose up -d`
3. `docker image prune`

## Backup e ripristino
### Backup
Usate [borg](../borg_backup) per fare i backup giornalieri dell'intera cartella `navidrome`

### Ripristino
Per una maggiore spiegazione sui passaggi da fare, controllate [qua](../borg_backup#user-content-controllare-la-cartella-dei-backup)
1. fermare il container `docker-compose down`
2. cancellare l'intera cartella `navidrome`
3. dal backup copiare la cartella `navidrome`
4. far ripartire il container `docker-compose up -d`

## Todo
Implementare:
- reverse proxy: **[caddy](https://caddyserver.com/)** o **[traefik](https://doc.traefik.io/traefik/)**