67 lines
1.5 KiB
Markdown
67 lines
1.5 KiB
Markdown
# Nexterm con Docker Compose
|
|
|
|
Questa cartella contiene una configurazione Docker Compose parametrizzata tramite file `.env`.
|
|
|
|
## Requisiti
|
|
|
|
- Docker Desktop (o Docker Engine)
|
|
- Docker Compose v2 (`docker compose`)
|
|
|
|
## File inclusi
|
|
|
|
- `docker-compose.yml`: configurazione del servizio
|
|
- `.env`: variabili di configurazione del deploy
|
|
|
|
## Configurazione
|
|
|
|
Modifica il file `.env` in base alle tue esigenze.
|
|
|
|
Variabili principali:
|
|
|
|
- `NEXTERM_IMAGE`: immagine Docker da usare
|
|
- `NEXTERM_CONTAINER_NAME`: nome del container
|
|
- `NEXTERM_RESTART_POLICY`: policy di riavvio
|
|
- `NEXTERM_PORT_HOST`: porta esposta sull'host
|
|
- `NEXTERM_PORT_CONTAINER`: porta interna del container
|
|
- `NEXTERM_DATA_DIR`: directory dati persistenti
|
|
- `NEXTERM_TZ`: timezone del container
|
|
- `NEXTERM_ENCRYPTION_KEY`: chiave di cifratura obbligatoria per Nexterm
|
|
|
|
> `NEXTERM_ENCRYPTION_KEY` deve essere una stringa lunga e casuale.
|
|
> Esempio rapido (PowerShell):
|
|
|
|
```powershell
|
|
[Convert]::ToBase64String((1..48 | ForEach-Object { Get-Random -Maximum 256 }))
|
|
```
|
|
|
|
## Avvio
|
|
|
|
```bash
|
|
docker compose up -d
|
|
```
|
|
|
|
## Verifica
|
|
|
|
```bash
|
|
docker compose ps
|
|
docker compose logs -f nexterm
|
|
```
|
|
|
|
Apri poi il browser su:
|
|
|
|
- `http://localhost:${NEXTERM_PORT_HOST}`
|
|
|
|
## Stop e rimozione
|
|
|
|
```bash
|
|
docker compose down
|
|
```
|
|
|
|
> I dati restano nel percorso indicato in `NEXTERM_DATA_DIR`.
|
|
|
|
## Migliorie applicate
|
|
|
|
- Parametrizzazione completa del servizio tramite `.env`
|
|
- Default sicuri nel `docker-compose.yml` usando `${VAR:-default}`
|
|
- Separazione chiara tra configurazione ( `.env` ) e orchestrazione (`docker-compose.yml`)
|