SealRoute SealRoute
Kembali ke beranda

Pasang SealRoute di server Anda

Panduan 7 langkah yang membawa Anda dari mesin Linux baru dengan Docker hingga instans SealRoute yang teraktivasi penuh. Setiap langkah memiliki perintah atau tangkapan layar persis yang Anda butuhkan.

Dalam panduan ini

  1. Prasyarat
  2. Langkah 1 - Tarik file docker-compose
  3. Langkah 2 - Konfigurasikan lingkungan Anda
  4. Langkah 3 - Jalankan stack
  5. Langkah 4 - Penyiapan awal
  6. Langkah 5 - Beli lisensi
  7. Langkah 6 - Aktifkan lisensi Anda
  8. Langkah 7 - Selesai

Prasyarat

  • Host Linux (Ubuntu 22.04+ atau distro modern apa pun) dengan setidaknya 2 GB RAM dan 10 GB disk.
  • Docker Engine (24+) dan plugin Docker Compose v2. Verifikasi dengan: 
    docker --version
docker compose version
  • Domain publik (dengan HTTPS di depan) atau cukup port yang Anda kendalikan di localhost. docker-compose.yml bawaan menyertakan reverse proxy Caddy yang menangani HTTPS otomatis saat Anda mengatur HOST=domain.anda.
  • Sebuah lisensi Aplindo. Anda juga dapat membelinya langsung dari aplikasi yang berjalan di Langkah 5 di bawah.

Langkah 1 - Tarik file docker-compose

Buat direktori kerja dan ambil file compose produksi dari repo. File ini sudah menghubungkan SealRoute, Postgres, dan Caddy.

mkdir sealroute && cd sealroute
curl -L https://raw.githubusercontent.com/sealroute/sealroute/main/docker-compose.yml -o docker-compose.yml
curl -L https://raw.githubusercontent.com/sealroute/sealroute/main/deploy.sh         -o deploy.sh
chmod +x deploy.sh

Jika Anda lebih suka mengkloning seluruh paket deploy: git clone https://github.com/sealroute/sealroute.git && cd sealroute. Bagaimanapun caranya, langkah berikutnya sama.

Langkah 2 - Konfigurasikan lingkungan Anda

SealRoute membaca konfigurasinya dari variabel lingkungan. Buat file .env di samping file compose Anda. Minimum yang Anda butuhkan:

# Where the app is reachable from a browser. Use https://your.domain in
# production or http://localhost:3000 for a local trial.
APP_URL=https://your.domain
HOST=your.domain

# Generate with `openssl rand -hex 64` and keep it secret.
SECRET_KEY_BASE=replace-me-with-a-long-random-string

# --- Aplindo licensing ------------------------------------------------------
APLINDO_LICENSE_API_URL=https://license.aplindo.com
APLINDO_LICENSE_PRODUCT_SLUG=SealRoute
APLINDO_LICENSE_DEFAULT_AMOUNT_IDR=5000000.00
APLINDO_LICENSE_HEARTBEAT_SECONDS=3600

Contoh yang lebih lengkap dengan opsi tambahan ada di .env.example.

Langkah 3 - Jalankan stack

Jalankan SealRoute, Postgres, dan reverse proxy di latar belakang:

docker compose up -d

Pantau log boot hingga Anda melihat Puma mendengarkan di tcp://0.0.0.0:3000:

docker compose logs -f app

Boot pertama juga menjalankan migrasi basis data. Pada host 2 GB ini biasanya selesai dalam kurang dari satu menit.

Langkah 4 - Penyiapan awal

Buka aplikasi di browser Anda. Karena belum ada pengguna, SealRoute mengalihkan Anda ke halaman /setup. Di sinilah Anda membuat akun admin pertama dan metadata akun Anda.

Formulir /setup SealRoute kosong

Isi:

  • Nama depan / Nama belakang - nama Anda sebagai admin pertama.
  • Email - ini adalah login admin dan tempat notifikasi penandatanganan dikirim.
  • Nama perusahaan - ditampilkan kepada penanda tangan di email dan di halaman penandatanganan.
  • Kata sandi - setidaknya 8 karakter, disarankan campuran huruf dan angka.
  • URL Aplikasi - terisi otomatis dari APP_URL di .env Anda. Digunakan untuk menghasilkan tautan penandatanganan di email.
  • Bahasa - bahasa antarmuka default untuk penanda tangan baru.
Formulir /setup SealRoute terisi dengan data contoh

Klik Submit. SealRoute membuat akun, memasukkan Anda, dan mengalihkan ke halaman /license.

Langkah 5 - Beli lisensi

Instans SealRoute self-hosted memerlukan lisensi aktif untuk membuka layar setelah masuk. Halaman /license memiliki dua kartu: Beli lisensi di atas dan Aktifkan lisensi di bawah.

Halaman /license SealRoute menampilkan kartu Beli lisensi dan Aktifkan lisensi

Di kartu Beli lisensi, tetapkan jumlah Kursi yang Anda butuhkan. Harga satuan berasal dari pengaturan APLINDO_LICENSE_DEFAULT_AMOUNT_IDR Anda (saat ini IDR 1.499.000 per kursi), dan totalnya dihitung ulang otomatis saat Anda mengubah jumlah kursi.

Kartu Beli lisensi dengan kursi diatur ke 5 dan total dihitung ulang menjadi IDR 7.495.000

Klik Beli lisensi. SealRoute membuka modal dengan iframe checkout Aplindo. Selesaikan pembayaran di sana. Setelah transaksi berhasil, Aplindo mengirim kunci lisensi ke alamat yang Anda masukkan, dan kunci yang sama juga ditampilkan di halaman sukses checkout.

Langkah 6 - Aktifkan lisensi Anda

Salin kunci lisensi dari halaman sukses atau email Anda, lalu tempel ke kartu Aktifkan lisensi di /license:

Kartu Aktifkan lisensi dengan contoh kunci lisensi XXXX-XXXX-XXXX-XXXX yang ditempel

Klik Aktifkan. SealRoute memanggil server lisensi Aplindo, mengikat kunci ke mesin ini, dan memuat ulang. Anda akan melihat kartu Lisensi saat ini di atas dengan status active, slug produk, ID lisensi, ID mesin, tanggal kedaluwarsa, dan stempel waktu heartbeat terakhir.

Kartu lisensi saat ini menampilkan status aktif, produk, ID lisensi, ID mesin, kedaluwarsa, dan heartbeat terakhir

SealRoute menjadwalkan tugas heartbeat yang memeriksa ulang lisensi dengan Aplindo setiap APLINDO_LICENSE_HEARTBEAT_SECONDS detik (default: per jam). Jika lisensi dicabut atau kedaluwarsa, heartbeat berikutnya akan mencerminkannya.

Langkah 7 - Selesai

SealRoute kini beroperasi penuh. Kunjungi / dan Anda akan tiba di dasbor Templat Dokumen kosong, siap untuk unggahan pertama Anda.

Dasbor Templat Dokumen SealRoute kosong siap untuk unggahan pertama

Bangun templat pertama Anda

Klik Unggah di dasbor, jatuhkan PDF atau DOCX, lalu seret kolom ke atasnya - tanda tangan, tanggal, teks, kotak centang, dll.

Coba API

SealRoute adalah REST API terlebih dahulu. Hasilkan token API di Pengaturan → API, lalu buka dokumentasi API untuk contoh menyeluruh dalam 10 bahasa.

Butuh bantuan?