Bar Assistant

Bar Assistant adalah pengelola resep koktail dan inventaris bar rumahan yang di-hosting sendiri. Lacak bahan, hitung kadar alkohol, ganti satuan, dan temukan penggantinya. Berlisensi MIT dengan 1.000+ bintang GitHub.

Sekilas

1.1k

Bintang GitHub

Tampilan halaman

Lisensi MIT Versi v5 OS Ubuntu 24.04 LTS Min RAM 1 GB IP IPV4

Mengakses Bar Assistant

Antarmuka Web: https://<SERVER_IP>
REST API: https://<SERVER_IP>/bar
Meilisearch: https://<SERVER_IP>/search
Peringatan SSL di browser adalah hal yang wajar karena digunakan sertifikat self-signed.

Penyiapan Pertama

1. Buka URL berikut di browser Anda: https://<SERVER_IP>

2. Klik Register.

3. Buat akun pengguna pertama.

4. Setelah pendaftaran selesai, nonaktifkan pendaftaran publik dengan mengedit:

vim /root/barassistant/docker-compose.yml

Ubah ALLOW_REGISTRATION: "true" to ALLOW_REGISTRATION: "false".

Terapkan perubahan:

cd /root/barassistant
docker compose up -d

File dan Direktori Penting

Jalur instalasi: /root/barassistant
File Compose: /root/barassistant/docker-compose.yml
File Lingkungan: /root/barassistant/.env
Konfigurasi Nginx: /etc/nginx/sites-available/barassistant
Sertifikat SSL: /etc/nginx/ssl/barassistant.crt
Kunci SSL: /etc/nginx/ssl/barassistant.key
Direktori Data Bar: /var/lib/docker/volumes/barassistant_bar_data/_data
Direktori Data Meilisearch: /var/lib/docker/volumes/barassistant_meilisearch_data/_data

Mengelola Bar Assistant

Lihat kontainer yang berjalan:

docker compose -f /root/barassistant/docker-compose.yml ps

Mulai ulang semua kontainer:

docker compose -f /root/barassistant/docker-compose.yml restart

Ikuti log aplikasi:

docker compose -f /root/barassistant/docker-compose.yml logs -f

Hentikan aplikasi:

docker compose -f /root/barassistant/docker-compose.yml down

Jalankan aplikasi:

docker compose -f /root/barassistant/docker-compose.yml up -d

Mengelola Nginx

Periksa status:

systemctl status nginx

Mulai ulang Nginx:

systemctl restart nginx

Muat ulang Nginx:

systemctl reload nginx

Validasi konfigurasi:

nginx -t

Mengaktifkan SSL dengan Domain

1. Arahkan domain kamu ke IP server.

2. Edit konfigurasi Nginx dan ganti kedua server_name _; dengan domainmu (server_name <yourdomain.com>) untuk blok HTTP (port 80) dan HTTPS (port 443):

vim /etc/nginx/sites-available/barassistant

3. Install Certbot:

apt install -y certbot python3-certbot-nginx

4. Jalankan perintah berikut untuk menghasilkan sertifikat Let's Encrypt yang valid:

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

5. Ganti path SSL di konfigurasi Nginx:

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. Muat ulang Nginx untuk menerapkan perubahan:

systemctl reload nginx

7. Edit /root/barassistant/.env dan ganti IP server di API_URL dan MEILISEARCH_URL with your domain:

API_URL=https://yourdomain.com/bar
MEILISEARCH_URL=https://yourdomain.com/search

8. Buat ulang layanan:

cd /root/barassistant
docker compose up -d

9. Buka browser kamu dan kunjungi: https://yourdomain.com

Verifikasi Reverse Proxy

Buka https://yourdomain.com/bar. Anda seharusnya melihat: "This is your Bar Assistant instance."
Buka https://yourdomain.com/bar/docs. Anda seharusnya melihat dokumentasi Swagger API.
Buka https://yourdomain.com/bar/api/server/version. Anda seharusnya menerima respons JSON berisi versi server, bukan galat "Resource not found".

Bar Assistant

Aplikasi terkait.

Ackee

Actual

AFFiNE

AList

Deploy Bar Assistant now. Mulai $2,48/bln.