← Kembali ke Contractor OS

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.

  1. Sebelum mulai
  2. Atur berkas .env
  3. Jalankan
  4. Pengaturan awal
  5. Backup dan restore
  6. Update dan rollback
  7. Log dan pemantauan
  8. 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_PASSWORD

Jalankan

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 app

Pengaturan 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 owner

Fitur 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 backup

Restore 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 app

Update 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 app

Kembali 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 app

Yang 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.

Kontak - dibalas 09.00–21.00 WIB

Paling cepat lewat WhatsApp.

Ceritakan proyek Anda dalam beberapa baris. Kami balas dengan link demo, daftar harga, dan jawaban untuk pertanyaan Anda.

samapp - Contractor OS

Halo, saya kontraktor interior. Bisa dipakai untuk 3 proyek sekaligus?

Bisa, user dan proyek tanpa batas. Ini link demonya, langsung bisa dicoba tanpa daftar. Mau saya kirim daftar harga juga?

Boleh, yang langganan ya.

Contoh percakapan, bukan percakapan nyata.
lebih suka email?[email protected]
lebih suka telegram?@samappdev

Atau kirim lewat formulir

Tentang

samapp adalah studio software di Indonesia. Satu developer yang pegang proyek Anda dari awal sampai rilis, bukan tim yang berganti-ganti. Kode ada di repositori Anda sejak hari pertama, jadi Anda tidak pernah terkunci pada kami. Lingkup, jadwal, dan harga ditulis sebelum pekerjaan dimulai.

Foto Sultan Atha Maulana, pendiri samapp
Sultan Atha MaulanaPendiri / Developer

Membangun Contractor OS sendiri: tujuh peran, BOQ, Gantt, persetujuan, dan invoice, semuanya bisa Anda coba sekarang. Kotlin, Nuxt, dan Node. Lugas dan mudah diajak bekerja sama.

GitHub
© 2026 samappMenggunakan JetBrains Mono dan Geist