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.shScript ini:
- memilih file sesuai prosesor dan memeriksa port 80 tidak dipakai program lain;
- memasang ke
/opt/orkasebagai 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
| Hal | Keterangan |
|---|---|
| Sistem | Linux 64-bit: Ubuntu 20.04+, Debian 11+, Rocky/AlmaLinux 8+, Fedora, openSUSE, Alpine, Raspberry Pi OS 64-bit |
| Prosesor | amd64 (Intel/AMD) atau arm64. ARM 32-bit tidak didukung. |
| Memori | Teruji 1.000 siswa simulasi di 2 core, RAM 2 GB. Uji coba kecil: 1 GB RAM. |
| Service otomatis | Butuh systemd. Tanpa systemd: lihat bagian 9. |
| Akses | Login SSH dengan hak sudo |
| Jam server | Harus tepat (sinkron NTP). Lihat bagian 6. |
2. Pilih file yang sesuai
sh
uname -m| Hasil | File |
|---|---|
x86_64 | orka-<versi>-linux-amd64 |
aarch64 atau arm64 | orka-<versi>-linux-arm64 |
armv7l, armv6l, i686 | Tidak 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 /mntPerintah 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
| Firewall | Perintah |
|---|---|
| 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
timedatectlPastikan 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
- Buka
http://IP-SERVER/panel.html→ wizard setup awal. - Beri server IP tetap (lihat Alamat server dan jaringan).
- VPS untuk ujian dari rumah: pakai domain dan HTTPS. Lihat Akses dari luar sekolah.
8. Perintah sehari-hari
| Keperluan | Perintah |
|---|---|
| Keadaan service | sudo /opt/orka/orka service status |
| Log berjalan | journalctl -u orka -f (keluar: Ctrl+C) |
| Log 50 baris terakhir | journalctl -u orka -n 50 --no-pager |
| Hentikan / nyalakan / mulai ulang | sudo systemctl stop orka / start orka / restart orka |
| Versi terpasang | /opt/orka/orka --version (juga di panel → Pengaturan server) |
| Backup sekarang | cd /opt/orka && sudo ./orka backup |
| Salin backup ke komputer Anda | scp 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 uninstallService dilepas, data tidak dihapus (tetap di /opt/orka/data).
11. Masalah yang sering terjadi
| Gejala | Jalan keluar |
|---|---|
exec format error | File tidak cocok dengan prosesor. Cek uname -m. |
Permission denied saat menjalankan | Lupa chmod +x, atau folder di-mount noexec. Pakai /opt/orka. |
Service gagal, log: Port 80 sedang dipakai program lain | Ada Apache/nginx. Cek `sudo ss -ltnp |
| Dari server berhasil, dari HP gagal | Firewall server/VPS belum dibuka, atau HP tidak di jaringan yang sama. |
| Waktu ujian siswa tidak masuk akal | Jam server salah (bagian 6). |
| Peringatan "folder data … di drive jaringan / flashdisk" | Pindahkan data ke disk internal (-data). |