Bookstack è un’alternativa “open source” a MediaWiki o Confluence. Oggi mostro come installare un servizio Bookstack sulla Synology disk station.
Opzione per i professionisti
Come utente esperto di Synology, puoi ovviamente accedere con SSH e installare l’intera configurazione tramite il file Docker Compose.
version: '3'
services:
bookstack:
image: solidnerd/bookstack:0.27.4-1
restart: always
ports:
- 8080:8080
links:
- database
environment:
DB_HOST: database:3306
DB_DATABASE: my_wiki
DB_USERNAME: wikiuser
DB_PASSWORD: my_wiki_pass
database:
image: mariadb
restart: always
volumes:
- ./mysql:/var/lib/mysql
environment:
MYSQL_ROOT_PASSWORD: my_wiki_pass1
MYSQL_DATABASE: my_wiki
MYSQL_USER: wikiuser
MYSQL_PASSWORD: my_wiki_pass
Altre immagini Docker utili per uso domestico possono essere trovate nella Dockerverse.
Passo 1: Preparare la cartella bookstack
Creo una nuova directory chiamata “wiki” nella directory Docker.
Passo 2: installare il database
Dopo di che, si deve creare un database. Faccio clic sulla scheda “Registrazione” nella finestra di Synology Docker e cerco “mariadb”. Seleziono l’immagine Docker “mariadb” e poi clicco sul tag “latest”.
Dopo il download dell’immagine, l’immagine è disponibile come immagine. Docker distingue tra 2 stati, container “stato dinamico” e immagine (stato fisso). Prima di creare un contenitore dall’immagine, devono essere fatte alcune impostazioni. Faccio doppio clic sulla mia immagine mariadb.
Poi clicco su “Impostazioni avanzate” e attivo il “Riavvio automatico”. Seleziono la scheda “Volume” e clicco su “Aggiungi cartella”. Lì creo una nuova cartella di database con questo percorso di montaggio “/var/lib/mysql”.
Sotto “Impostazioni delle porte” tutte le porte sono cancellate. Questo significa che seleziono la porta “3306” e la cancello con il tasto “-”.
Nome della variabile | Valore | Che cos’è? |
---|---|---|
TZ | Europe/Berlin | Fuso orario |
MYSQL_ROOT_PASSWORD | my_wiki_pass | Password principale del database. |
MYSQL_DATABASE | my_wiki | Questo è il nome del database. |
MYSQL_USER | wikiuser | Nome utente del database del wiki. |
MYSQL_PASSWORD | my_wiki_pass | Password dell’utente del database wiki. |
Dopo queste impostazioni, il server Mariadb può essere avviato! Premo “Applica” dappertutto.
Passo 3: installare Bookstack
Faccio clic sulla scheda “Registrazione” nella finestra di Synology Docker e cerco “bookstack”. Seleziono l’immagine Docker “solidnerd/bookstack” e poi clicco sul tag “latest”.
Faccio doppio clic sulla mia immagine Bookstack. Poi clicco su “Impostazioni avanzate” e attivo anche qui il “Riavvio automatico”.
Assegno delle porte fisse per il contenitore “bookstack”. Senza porte fisse, potrebbe essere che il “server bookstack” giri su una porta diversa dopo un riavvio. La prima porta del contenitore può essere cancellata. L’altra porta dovrebbe essere ricordata.
Inoltre, un “link” al contenitore “mariadb” deve ancora essere creato. Faccio clic sulla scheda “Link” e seleziono il contenitore del database. Il nome dell’alias dovrebbe essere ricordato per l’installazione del wiki.
Nome della variabile | Valore | Che cos’è? |
---|---|---|
TZ | Europe/Berlin | Fuso orario |
DB_HOST | wiki-db:3306 | Nomi alias / collegamento al contenitore |
DB_DATABASE | my_wiki | Dati dal passo 2 |
DB_USERNAME | wikiuser | Dati dal passo 2 |
DB_PASSWORD | my_wiki_pass | Dati dal passo 2 |
Il contenitore può ora essere avviato. Potrebbe essere necessario un po' di tempo per creare il database. Il comportamento può essere osservato attraverso i dettagli del contenitore.
Chiamo il server Bookstack con l’indirizzo IP del Synology e la mia porta del container. Il nome di login è “admin@admin.com” e la password è “password”.