MasterpieceDockerCompose/unifi/README.md

102 lines
2.6 KiB
Markdown
Raw Normal View History

2021-05-21 12:55:29 +02:00
# Unifi Controller in docker
<div align="center">
<img src="https://i.ibb.co/6srMcZx/Screenshot-2021-05-21-Uni-Fi.png" />
</div>
# Descrizione
* [Sito ufficiale](https://www.ui.com/software/)
* [Repo (Github)](https://github.com/linuxserver/docker-unifi-controller)
* [Demo](https://demo.ui.com)
* [Documentazione](https://dl.ui.com/guides/UniFi/UniFi_Controller_V5_UG.pdf)
Unfi Controller è un'interfaccia per la gestione di hardware Ubiquiti:
- Interfaccia web moderna e compatibile con tablet e smartphone
- Aggiornamenti frequenti e stabili
- Possibilità di aggiornare, configurare e personalizzare tutto l'hardware (compatibile)
- Possibilità di backup della configurazione, sia del controller che dell'hardware
# Struttura file e cartelle
```
/home/
└── docker/
└── unifi/
├── config/
├── .env
└── docker-compose.yml
2021-05-21 12:55:29 +02:00
```
* `config/` - cartella dove risiedono i dati che servono a unifi
* `.env` - file contenenti le variabili environment per il docker compose
* `docker-compose.yml` - file usato 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:
unifi:
container_name: linuxserver-unifi
image: ghcr.io/linuxserver/unifi-controller
restart: unless-stopped
ports:
- ${UNIFI_WEBUI_PORT:-8080}:8080
- ${UNIFI_HTTPS_PORT:-8443}:8443
- ${UNIFI_AP_DSV_PORT:-10001}/udp:10001/udp
- ${UNIFI_STUN_PORT:-3478}/udp:3478/udp
env_file: .env
volumes:
- ${UNIFI_CONFIG:-/home/docker/unifi/config}:/config
```
`.env`
```bash
# Generale
UNIFI_WEBUI_PORT=8080
UNIFI_HTTPS_PORT=8443
UNIFI_AP_DSV_PORT=10001
UNIFI_STUN_PORT=3478
UNIFI_CONFIG=/config
# Unifi
MEM_LIMIT=1024M # opzionale, di base è un 1 GB
```
# Reverse proxy
Ancora non ho previsto l'uso di un reverse proxy. (Vedi [Todo](#Todo))
# Aggiornamenti
[Watchtower](../watchtower) aggiorna l'immagine automaticamente.
2021-05-21 12:55:29 +02:00
Aggiornamento manuale:
- `docker-compose pull`
- `docker-compose up -d`
2021-05-21 12:55:29 +02:00
- `docker image prune`
# Backup e ripristino
#### Backup
Usare [borg](../borg_backup) per fare i backup giornalieri dell'intera cartella `unifi`.
2021-05-21 12:55:29 +02:00
#### Ripristino
* spegnere il container `docker-compose down`
* cancellare l'intera cartella `unifi`
* dal backup copiare la cartella `unifi`
* far ripartire il container `docker-compose up -d`
2021-05-21 12:55:29 +02:00
# Todo
Implementare:
- reverse proxy: **[caddy](https://caddyserver.com/) o [traefik](https://doc.traefik.io/traefik/).**