Docker e Compose
Run the control plane and the data plane in containers with Docker Compose, on Linux or a Mac: start, first-login credentials, upgrade and uninstall.
Quale versione installi
La versione pubblica è una versione di sviluppo, chiamata 0.3.0-dev. Il suo nome non cambia: ogni pubblicazione sostituisce la precedente e un identificativo di build distingue due build. Non esiste ancora una versione stabile: sarà pubblicata solo quando ogni sistema e ogni pacchetto saranno stati testati end to end. I comandi di questa pagina installano quindi dal canale dev. Una versione di sviluppo può contenere difetti: provala su un sito di prova prima di farci affidamento.
At a glance
- One image runs the control plane (console and API) or the data plane, selected with TOUTWAF_ROLE; the compose file starts one of each.
- The files (the deploy folder) come with your ToutWAF distribution: they are not in the public repository, which holds binaries and installers only.
- On the very first start, the toutwaf-cp logs show once the secret console address and the generated username and password: copy them, they are written nowhere else.
- The console is published on 127.0.0.1 only: to reach it remotely, use an SSH tunnel, a VPN or a TLS reverse proxy with an allow-list. Never publish 9443 on a public interface.
The commands, step by step
Docker Compose su Mac o Linux
Docker Compose su Linux o su un Mac (Docker Desktop, OrbStack, Colima), con l'immagine tutto in uno (control plane e data plane). I file arrivano con la tua distribuzione ToutWAF (la cartella deploy, che non è nel repository pubblico: quello contiene solo binari e installer). L'immagine contiene binari precompilati per architettura (bin/amd64 o bin/arm64) e nessuna immagine è ancora pubblicata in un registry. Testata solo su Linux amd64; non provata su un vero Mac, dove l'IP del client visto dietro Docker Desktop è l'indirizzo del gateway Docker. Le credenziali monouso compaiono una sola volta nel log del control plane.
cd deploy/docker
# bin/amd64/{toutwaf-cp,toutwaf-dp,toutwafctl} (Intel Mac, Linux x86-64)
# bin/arm64/{toutwaf-cp,toutwaf-dp,toutwafctl} (Apple Silicon, Linux ARM)
cp .env.example .env
docker compose up -d --build
docker compose logs toutwaf-cpAggiornare (container)
Fai prima un backup. Il pulsante di aggiornamento della console non può funzionare in un container: sostituisci i binari nella cartella bin (o l'immagine, quando ne sarà pubblicata una) e ricostruisci; i volumi, quindi i tuoi dati, vengono conservati.
docker compose up -d --buildDisinstalla
Il primo blocco rimuove i servizi, i binari e le regole del firewall aggiunte da ToutWAF, e conserva i tuoi dati. Il secondo elimina anche configurazione, dati e log.
docker compose downdocker compose down -vWhat is not verified
We prefer to say it plainly.
- Tested end to end on Linux x86-64 only. An Intel Mac, an Apple Silicon Mac (linux/arm64) and Windows with Docker Desktop are not tested on real hardware.
- No image is published to a registry: building needs the prebuilt release binaries. Native macOS is not provided.
- The in-console update and the firewall helper do not work in a container: you update by replacing the image. A single control-plane instance, with SQLite.