Jalankan di server

Celerp selalu berjalan di perangkat keras Anda sendiri - aplikasi desktop mengubah komputer Anda menjadi server dengan satu klik. Panduan ini untuk menjalankannya di server Linux terpisah yang selalu menyala (VPS atau server rumah), agar seluruh kantor dapat mengaksesnya sepanjang waktu. Jalur pip install celerp yang sama seperti di desktop bekerja di server Linux mana pun.

Persyaratan

  • Python 3.11+
  • Postgres 14+ (berjalan dan dapat diakses)
  • Pengguna dengan akses sudo (diperlukan oleh celerp init untuk membuat pengguna dan database Postgres)

Instal & Inisialisasi

pip install celerp
celerp init

celerp init bersifat interaktif. Ia akan:

  • Meminta URL koneksi Postgres (atau menerima default: postgresql+asyncpg://celerp:celerp@localhost:5432/celerp)
  • Membuat pengguna dan database Postgres (melalui sudo -u postgres psql)
  • Membuat secret JWT
  • Menjalankan migrasi
  • Menulis berkas konfigurasi (~/.celerp/config.toml)

Memulai server

celerp start

Ini memulai dua proses:

  • Server API di port 8000
  • Server UI di port 8080

Buka http://your-server-ip:8080 di browser untuk mengakses Celerp.

Jalankan sebagai layanan systemd

Agar Celerp tetap berjalan setelah logout dan otomatis mulai saat reboot:

sudo tee /etc/systemd/system/celerp.service <<EOF
[Unit]
Description=Celerp ERP
After=network.target postgresql.service

[Service]
Type=simple
User=$USER
ExecStart=$(which celerp) start
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable --now celerp

Reverse Proxy (nginx + HTTPS)

Untuk mengekspos Celerp pada domain dengan HTTPS, proksikan UI dan API melalui nginx:

server {
    server_name erp.yourdomain.com;

    # UI
    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    # API
    location /api/ {
        proxy_pass http://localhost:8000/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    listen 443 ssl;
    ssl_certificate /etc/letsencrypt/live/erp.yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/erp.yourdomain.com/privkey.pem;
}

Gunakan Certbot untuk mendapatkan sertifikat SSL gratis.

Memperbarui

celerp upgrade

Ini menjalankan pip install --upgrade celerp dan menerapkan migrasi yang tertunda secara otomatis.

Multi-Pengguna LAN

Jika Anda menjalankan Celerp pada komputer di jaringan lokal Anda, pengguna lain di jaringan yang sama dapat mengaksesnya dari browser di http://your-machine-ip:8080. Pastikan firewall Anda mengizinkan koneksi masuk pada port 8000 dan 8080.