Bar Assistant openen
- Webinterface:
https://<SERVER_IP> - REST-API:
https://<SERVER_IP>/bar - Meilisearch:
https://<SERVER_IP>/search - Een SSL-waarschuwing in de browser is te verwachten omdat er een zelfondertekend certificaat wordt gebruikt.
Eerste installatie
1. Open de volgende URL in je browser: https://<SERVER_IP>
2. Klik op Register.
3. Maak het eerste gebruikersaccount aan.
4. Schakel na de registratie openbare registratie uit door dit te bewerken:
vim /root/barassistant/docker-compose.yml
Wijzig ALLOW_REGISTRATION: "true" to ALLOW_REGISTRATION: "false".
Pas de wijziging toe:
cd /root/barassistant
docker compose up -d
Belangrijke bestanden en mappen
- Installatiepad:
/root/barassistant - Compose-bestand:
/root/barassistant/docker-compose.yml - Omgevingsbestand:
/root/barassistant/.env - Nginx-configuratie:
/etc/nginx/sites-available/barassistant - SSL-certificaat:
/etc/nginx/ssl/barassistant.crt - SSL-sleutel:
/etc/nginx/ssl/barassistant.key - Bar-datamap:
/var/lib/docker/volumes/barassistant_bar_data/_data - Meilisearch-datamap:
/var/lib/docker/volumes/barassistant_meilisearch_data/_data
Bar Assistant beheren
Actieve containers bekijken:
docker compose -f /root/barassistant/docker-compose.yml ps
Alle containers herstarten:
docker compose -f /root/barassistant/docker-compose.yml restart
Volg de applicatielogs:
docker compose -f /root/barassistant/docker-compose.yml logs -f
Stop de applicatie:
docker compose -f /root/barassistant/docker-compose.yml down
Start de applicatie:
docker compose -f /root/barassistant/docker-compose.yml up -d
Nginx beheren
Status controleren:
systemctl status nginx
Nginx herstarten:
systemctl restart nginx
Nginx herladen:
systemctl reload nginx
Valideer de configuratie:
nginx -t
SSL inschakelen met een domein
1. Wijs je domein naar het server-IP.
2. Pas de Nginx-config aan en vervang beide server_name _; met je domein (server_name <yourdomain.com>) voor zowel de HTTP-blokken (poort 80) als de HTTPS-blokken (poort 443):
vim /etc/nginx/sites-available/barassistant
3. Installeer Certbot:
apt install -y certbot python3-certbot-nginx
4. Voer de volgende opdracht uit om een geldig Let's Encrypt-certificaat te genereren:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Vervang de SSL-paden in de Nginx-config:
vim /etc/nginx/sites-available/barassistant
# Before:
# ssl_certificate /etc/nginx/ssl/barassistant.crt;
# ssl_certificate_key /etc/nginx/ssl/barassistant.key;
# After:
# ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
# ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
6. Herlaad Nginx om de wijzigingen toe te passen:
systemctl reload nginx
7. Bewerk /root/barassistant/.env en vervang het server-IP in API_URL en MEILISEARCH_URL with your domain:
API_URL=https://yourdomain.com/bar
MEILISEARCH_URL=https://yourdomain.com/search
8. De services opnieuw aanmaken:
cd /root/barassistant
docker compose up -d
9. Open je browser en bezoek: https://yourdomain.com
De reverse proxy controleren
- Open
https://yourdomain.com/bar. Je zou moeten zien: "This is your Bar Assistant instance." - Open
https://yourdomain.com/bar/docs. Je zou de Swagger API-documentatie moeten zien. - Open
https://yourdomain.com/bar/api/server/version. Je zou een JSON-respons met de serverversie moeten krijgen, geen "Resource not found"-fout.
