Skip to content

Memasang di Linux, Proxmox, atau VPS ​

Untuk admin IT yang memasang ORKA lewat terminal: Ubuntu Server, Debian, VM di Proxmox, mini PC, atau VPS.

ORKA hanya satu file program. Tidak perlu memasang database, PHP, Docker, atau paket lain.

File pemasangan

Selama program sekolah perintis, file install.sh dan orka-<versi>-linux-amd64 (atau -arm64) dibagikan lewat grup Telegram resmi ORKA CBT. Unduhan publik dibuka setelah rilis.

Cara tercepat: install.sh ​

Salin install.sh dan file orka-<versi>-linux-amd64 ke satu folder di server (cara menyalin ada di bagian 3), lalu di folder itu:

sh
sudo sh install.sh

Script ini:

  • memilih file sesuai prosesor dan memeriksa port 80 tidak dipakai program lain;
  • memasang ke /opt/orka sebagai service yang menyala sendiri setelah restart;
  • membuka port di firewall (ufw/firewalld) dan memeriksa jam server;
  • menunggu ORKA menjawab, lalu menampilkan alamat untuk siswa dan panel.

Opsi: --port 8080 (port lain), --file ./orka-… (file tertentu), --uji (hanya menampilkan langkah tanpa menjalankan apa pun).

Setelah selesai, buka http://IP-SERVER/panel.html di browser → wizard setup awal.

Bagian di bawah menjelaskan langkah manual dan hal-hal yang dilakukan script.

1. Syarat ​

HalKeterangan
SistemLinux 64-bit: Ubuntu 20.04+, Debian 11+, Rocky/AlmaLinux 8+, Fedora, openSUSE, Alpine, Raspberry Pi OS 64-bit
Prosesoramd64 (Intel/AMD) atau arm64. ARM 32-bit tidak didukung.
MemoriTeruji 1.000 siswa simulasi di 2 core, RAM 2 GB. Uji coba kecil: 1 GB RAM.
Service otomatisButuh systemd. Tanpa systemd: lihat bagian 9.
AksesLogin SSH dengan hak sudo
Jam serverHarus tepat (sinkron NTP). Lihat bagian 6.

2. Pilih file yang sesuai ​

sh
uname -m
HasilFile
x86_64orka-<versi>-linux-amd64
aarch64 atau arm64orka-<versi>-linux-arm64
armv7l, armv6l, i686Tidak didukung

3. Kirim file ke server ​

Dari Mac/Linux:

sh
scp orka-<versi>-linux-amd64 install.sh user@IP-SERVER:~/

Dari Windows: PowerShell (scp .\orka-<versi>-linux-amd64 user@IP-SERVER:~/), atau aplikasi WinSCP/FileZilla (SFTP).

Lewat flashdisk (server tanpa SSH):

sh
lsblk                     # cari flashdisk, mis. sdb1
sudo mount /dev/sdb1 /mnt
cp /mnt/orka-<versi>-linux-amd64 /mnt/install.sh ~/
sudo umount /mnt

Perintah yang ditempel

Jalankan baris ssh … sendiri dulu. Setelah masuk ke server, baru jalankan perintah berikutnya. Kalau beberapa baris ditempel sekaligus, baris setelah ssh tidak ikut berjalan di server.

Periksa keutuhan file (disarankan): sha256sum orka-<versi>-linux-amd64, lalu bandingkan dengan isi SHA256SUMS.

4. Pasang manual ​

sh
sudo mkdir -p /opt/orka
sudo cp ~/orka-<versi>-linux-amd64 /opt/orka/orka
sudo chmod +x /opt/orka/orka
/opt/orka/orka --version
cd /opt/orka && sudo ./orka service install

--version harus menampilkan versi, mis. ORKA CBT v0.9.0 (…, linux/amd64). Jika muncul exec format error, file tidak cocok dengan prosesor.

Service berjalan dari /opt/orka, jadi data ada di /opt/orka/data (database, gambar soal, backup). Jika berhenti karena error, systemd menyalakannya lagi setelah 5 detik.

Rocky/AlmaLinux/Fedora

Pakai cp, bukan mv, dari /tmp. Jika service gagal dengan Permission denied: sudo restorecon -Rv /opt/orka.

Opsi saat memasang (ikut tersimpan di service): sudo ./orka service install -addr :8080 (port lain) atau -data /srv/orka-data (folder data lain). Lihat Pengaturan lanjutan.

5. Buka port di firewall ​

FirewallPerintah
ufw (Ubuntu)sudo ufw allow 80/tcp
firewalld (Rocky, AlmaLinux, Fedora)sudo firewall-cmd --permanent --add-service=http && sudo firewall-cmd --reload
Tidak ada (Debian bawaan)Tidak perlu apa-apa

VPS: buka juga port 80 di dashboard penyedia (Firewall, Security Group, Inbound rules).

Uji dari komputer lain: curl http://IP-SERVER/api/health → {"status":"ok"}.

6. Jam server (wajib tepat) ​

Server adalah sumber waktu ujian. Periksa:

sh
timedatectl

Pastikan System clock synchronized: yes. Jika belum: sudo timedatectl set-ntp true. Server tanpa internet: atur jam manual sebelum hari ujian (sudo timedatectl set-ntp false, lalu sudo timedatectl set-time "2026-11-10 07:00:00").

7. Setelah terpasang ​

  1. Buka http://IP-SERVER/panel.html → wizard setup awal.
  2. Beri server IP tetap (lihat Alamat server dan jaringan).
  3. VPS untuk ujian dari rumah: pakai domain dan HTTPS. Lihat Akses dari luar sekolah.

8. Perintah sehari-hari ​

KeperluanPerintah
Keadaan servicesudo /opt/orka/orka service status
Log berjalanjournalctl -u orka -f (keluar: Ctrl+C)
Log 50 baris terakhirjournalctl -u orka -n 50 --no-pager
Hentikan / nyalakan / mulai ulangsudo systemctl stop orka / start orka / restart orka
Versi terpasang/opt/orka/orka --version (juga di panel → Pengaturan server)
Backup sekarangcd /opt/orka && sudo ./orka backup
Salin backup ke komputer Andascp user@IP-SERVER:/opt/orka/data/backup/orka-backup-….zip .

Perintah orka backup dan orka restore memakai folder data dari folder tempat perintah diketik. Jalankan dari /opt/orka.

9. Linux tanpa systemd ​

Alpine (OpenRC): buat /etc/init.d/orka:

sh
#!/sbin/openrc-run
description="ORKA CBT"
command="/opt/orka/orka"
directory="/opt/orka"
command_background=true
pidfile="/run/orka.pid"
output_log="/var/log/orka.log"
error_log="/var/log/orka.log"
depend() { need net; }

lalu sudo chmod +x /etc/init.d/orka && sudo rc-update add orka default && sudo rc-service orka start.

10. Melepas ORKA ​

sh
cd /opt/orka && sudo ./orka service uninstall

Service dilepas, data tidak dihapus (tetap di /opt/orka/data).

11. Masalah yang sering terjadi ​

GejalaJalan keluar
exec format errorFile tidak cocok dengan prosesor. Cek uname -m.
Permission denied saat menjalankanLupa chmod +x, atau folder di-mount noexec. Pakai /opt/orka.
Service gagal, log: Port 80 sedang dipakai program lainAda Apache/nginx. Cek `sudo ss -ltnp
Dari server berhasil, dari HP gagalFirewall server/VPS belum dibuka, atau HP tidak di jaringan yang sama.
Waktu ujian siswa tidak masuk akalJam server salah (bagian 6).
Peringatan "folder data … di drive jaringan / flashdisk"Pindahkan data ke disk internal (-data).

ORKA CBT adalah aplikasi ujian berbasis komputer gratis untuk sekolah Indonesia yang tetap berjalan tanpa internet.