Adgang til Bar Assistant
- Webgrænseflade:
https://<SERVER_IP> - REST API:
https://<SERVER_IP>/bar - Meilisearch:
https://<SERVER_IP>/search - En SSL-advarsel i browseren er forventet, fordi der bruges et selvsigneret certifikat.
Førstegangsopsætning
1. Åbn følgende URL i din browser: https://<SERVER_IP>
2. Klik på Register.
3. Opret den første brugerkonto.
4. Når registreringen er gennemført, skal du deaktivere offentlig registrering ved at redigere:
vim /root/barassistant/docker-compose.yml
Ændr ALLOW_REGISTRATION: "true" to ALLOW_REGISTRATION: "false".
Anvend ændringen:
cd /root/barassistant
docker compose up -d
Vigtige filer og mapper
- Installationssti:
/root/barassistant - Compose-fil:
/root/barassistant/docker-compose.yml - Miljøfil:
/root/barassistant/.env - Nginx-konfiguration:
/etc/nginx/sites-available/barassistant - SSL-certifikat:
/etc/nginx/ssl/barassistant.crt - SSL-nøgle:
/etc/nginx/ssl/barassistant.key - Bar-datamappe:
/var/lib/docker/volumes/barassistant_bar_data/_data - Meilisearch-datamappe:
/var/lib/docker/volumes/barassistant_meilisearch_data/_data
Administration af Bar Assistant
Se kørende containere:
docker compose -f /root/barassistant/docker-compose.yml ps
Genstart alle containere:
docker compose -f /root/barassistant/docker-compose.yml restart
Følg applikationens logfiler:
docker compose -f /root/barassistant/docker-compose.yml logs -f
Stop applikationen:
docker compose -f /root/barassistant/docker-compose.yml down
Start applikationen:
docker compose -f /root/barassistant/docker-compose.yml up -d
Administrering af Nginx
Tjek status:
systemctl status nginx
Genstart Nginx:
systemctl restart nginx
Genindlæs Nginx:
systemctl reload nginx
Validér konfigurationen:
nginx -t
Aktivering af SSL med et domæne
1. Peg dit domæne mod serverens IP.
2. Rediger Nginx-config og erstat begge server_name _; med dit domæne (server_name <yourdomain.com>) for både HTTP (port 80) og HTTPS (port 443) blokke:
vim /etc/nginx/sites-available/barassistant
3. Installer Certbot:
apt install -y certbot python3-certbot-nginx
4. Kør følgende kommando for at generere et gyldigt Let's Encrypt-certifikat:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Erstat SSL-stier i 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. Genindlæs Nginx for at anvende ændringerne:
systemctl reload nginx
7. Redigér /root/barassistant/.env og erstat server-IP'en i API_URL og MEILISEARCH_URL with your domain:
API_URL=https://yourdomain.com/bar
MEILISEARCH_URL=https://yourdomain.com/search
8. Genskab tjenesterne:
cd /root/barassistant
docker compose up -d
9. Åbn din browser og gå til: https://yourdomain.com
Verificér reverse proxyen
- Åbn
https://yourdomain.com/bar. Du bør se: "This is your Bar Assistant instance." - Åbn
https://yourdomain.com/bar/docs. Du bør se Swagger API-dokumentationen. - Åbn
https://yourdomain.com/bar/api/server/version. Du bør modtage et JSON-svar med serverversionen, ikke en "Resource not found"-fejl.
