Panduan pemasangan
Cara memasang dan merawat Contractor OS di server Anda. Satu pemasangan melayani satu perusahaan. Di paket Standar kami membantu pemasangan secara remote, di paket Plus kami mengurusnya penuh.
- Sebelum mulai
- Atur berkas .env
- Jalankan
- Pengaturan awal
- Backup dan restore
- Update dan rollback
- Log dan pemantauan
- Yang belum ada
Sebelum mulai
Siapkan satu server Linux (VPS kecil cukup: 2 vCPU, 2 GB RAM) dengan Docker dan plugin Compose, serta satu domain yang Anda kuasai. Buat A record (dan AAAA jika server punya IPv6) yang mengarah ke IP publik server. Di firewall, buka port 22 (SSH), 80, dan 443 saja. Database dan aplikasi tidak dibuka ke luar.
Atur berkas .env
Buat berkas .env dari contoh yang disertakan, lalu isi DOMAIN, ACME_EMAIL, POSTGRES_PASSWORD, dan NUXT_SESSION_PASSWORD. Buat kata sandinya dengan perintah di bawah. SETUP_TOKEN (opsional) membuat halaman pengaturan awal meminta kode, dan COMPANY_CODE adalah inisial untuk nomor proyek, PO, dan invoice. Simpan salinan .env di tempat aman: kehilangan POSTGRES_PASSWORD atau mengganti NUXT_SESSION_PASSWORD ada akibatnya (yang kedua memutus semua login).
openssl rand -hex 24 # POSTGRES_PASSWORD
openssl rand -hex 32 # NUXT_SESSION_PASSWORDJalankan
Tarik image lalu jalankan. Database PostgreSQL ikut berjalan di Docker Compose yang sama, dan aplikasi menerapkan migrasi database sendiri saat mulai. Tunggu sertifikat HTTPS terbit, lalu buka domain Anda.
docker compose -f docker-compose.prod.yml pull
docker compose -f docker-compose.prod.yml up -d
docker compose -f docker-compose.prod.yml logs -f caddy appPengaturan awal
Database produksi dimulai kosong dan tanpa akun demo. Selama belum ada user, domain Anda menampilkan halaman pengaturan awal. Pilih Cepat (nama perusahaan, akun Owner, ukuran perusahaan) atau Lengkap (juga logo, kode perusahaan, alamat dan rekening bank, PPN dan batas PO, aturan persetujuan, serta hingga lima akun tim). Jika server sudah bisa dijangkau sebelum Anda sempat membukanya, isi SETUP_TOKEN. Tanpa browser, buat Owner dari baris perintah:
docker compose -f docker-compose.prod.yml exec app ./erp create-user --email [email protected] --name "Full Name" --role ownerFitur opsional (modul) bisa dihidupkan atau dimatikan kapan saja di Pengaturan, Modul. Tidak ada data yang dihapus saat modul dimatikan.
Backup dan restore
Layanan backup menulis dump database harian ke folder backups (7 harian, 4 mingguan, 6 bulanan). Itu masih di server yang sama, jadi salin juga ke luar mesin. Owner dan Admin juga bisa membuat dan mengunduh backup dari halaman Backup Database. Foto lapangan dan lampiran tidak ikut backup database. Arsipkan dengan perintah ini, lalu salin kedua berkasnya ke luar server:
docker compose -f docker-compose.prod.yml exec app ./erp backupRestore mengganti SEMUA data saat ini dan memutus semua sesi login. Hentikan aplikasi dulu:
docker compose -f docker-compose.prod.yml stop app
docker compose -f docker-compose.prod.yml run --rm app ./erp restore /data/backups/erp-<stamp>.sql.gz --yes
docker compose -f docker-compose.prod.yml up -d appUpdate dan rollback
Baca CHANGELOG untuk setiap versi di antara versi Anda dan yang baru, lalu buat backup. Isi versi baru di ERP_VERSION pada .env, tarik, dan jalankan ulang. Migrasi berjalan otomatis. Jika database sudah berisi data dan ada migrasi baru, aplikasi lebih dulu menulis backup pengaman dan berhenti bila backup itu gagal, jadi tidak ada yang setengah berubah.
# ERP_VERSION=<new version> in .env
docker compose -f docker-compose.prod.yml pull app
docker compose -f docker-compose.prod.yml up -d
docker compose -f docker-compose.prod.yml logs -f appKembali ke versi lama berarti memulihkan backup pengaman, sehingga data yang dimasukkan setelah update ikut hilang. Lakukan latihan restore di mesin cadangan sebelum go-live, lalu tiap kuartal.
Log dan pemantauan
Tiap request API tercatat satu baris JSON di log. Alamat /api/live menjawab selama proses berjalan, sedangkan /api/health juga memeriksa database: arahkan pemantau uptime ke yang kedua.
docker compose -f docker-compose.prod.yml logs -f appYang belum ada
Belum ada reset kata sandi lewat email dan belum ada MFA. Owner atau Admin mengatur ulang kata sandi dari panel user. Foto lapangan disimpan di disk lokal, jadi server perlu disk yang persisten.
Butuh bantuan memasang? Tulis lewat formulir di bawah.