Dokumentasi / Server rumah & tunnel

Server rumah & tunnel

Pakai komputer di rumah atau kantor sebagai server, tanpa sewa VPS dan tanpa IP publik. Situs dan aplikasi web bisa dibuka dari internet di alamat gratis <nama>-app.hack.id.

Cocok untuk apa

Kurang cocok untuk toko yang ramai atau layanan yang harus selalu hidup: listrik dan internet rumah bisa putus. Untuk itu tetap pakai VPS.

Pilih perangkat

PerangkatCaraStatus
Mini PC atau laptop bekasPasang Ubuntu Server 24.04, lalu agent SakaDisarankan, paling stabil
Raspberry Pi 4/5Pasang Ubuntu Server 24.04 64-bit (Raspberry Pi OS belum didukung)Didukung (arm64)
PC Windows 10/11Ubuntu di dalam Windows lewat WSL2Beta
MacUbuntu di mesin virtual MultipassBeta

Kebutuhan sama dengan server biasa: RAM minimal 1 GB untuk agent, 2 GB untuk OpenClaw (1 GB untuk Hermes). Agent Saka hanya berjalan di Linux, karena itu Windows dan Mac memakai Ubuntu di dalamnya.

Jalur A: mini PC atau laptop dengan Ubuntu

  1. Pasang Ubuntu Server 24.04 (atau Ubuntu Desktop bila ingin ada layar).
  2. Di pengaturan BIOS, nyalakan power on after power loss (namanya beda-beda per merek) agar komputer menyala sendiri setelah listrik padam.
  3. Untuk laptop: agar tidak tidur saat layar ditutup, jalankan:
Terminal
sudo sed -i 's/^#\?HandleLidSwitch=.*/HandleLidSwitch=ignore/' /etc/systemd/logind.conf
sudo systemctl restart systemd-logind
  1. Di panel Saka, buka Server lalu Tambah server, salin perintahnya, dan jalankan di komputer itu. Selengkapnya di Mulai.

Jalur B: Windows lewat WSL2 (beta)

  1. Buka PowerShell sebagai Administrator, jalankan perintah di bawah, lalu restart bila diminta. Setelah itu buat username dan sandi Ubuntu.
PowerShell (Administrator)
wsl --install -d Ubuntu-24.04
  1. Di terminal Ubuntu, cek bahwa systemd menyala dengan systemctl is-system-running. Bila muncul galat, tambahkan isi ini ke /etc/wsl.conf, lalu jalankan wsl --shutdown di PowerShell dan buka Ubuntu lagi:
/etc/wsl.conf
[boot]
systemd=true
  1. Jalankan perintah Tambah server dari panel Saka di terminal Ubuntu. Docker dipasang otomatis di dalam Ubuntu; Docker Desktop tidak diperlukan. Bila Docker Desktop sudah terpasang, matikan WSL integration untuk Ubuntu-24.04 agar tidak bentrok.
  2. WSL berhenti sendiri saat semua jendelanya ditutup. Agar tetap hidup, buat tugas di Task Scheduler: pemicu At log on, aksi menjalankan perintah di bawah. Atur juga Windows agar tidak pernah sleep saat terhubung listrik.
Task Scheduler: aksi
wsl.exe -d Ubuntu-24.04 --exec sleep infinity

Jalur C: Mac lewat Multipass (beta)

  1. Pasang Homebrew bila belum ada, lalu buat mesin virtual Ubuntu dan masuk ke dalamnya:
Terminal Mac
brew install --cask multipass
multipass launch 24.04 --name saka --cpus 2 --memory 4G --disk 30G
multipass shell saka
  1. Jalankan perintah Tambah server dari panel Saka di dalam mesin virtual itu. Mac Apple Silicon (M1 ke atas) dan Intel sama-sama didukung.
  2. Di System Settings, bagian Energy atau Battery, cegah Mac tidur otomatis saat terhubung listrik. Setelah Mac restart, nyalakan lagi dengan multipass start saka.

Sudah memasang OpenClaw langsung di PC?

OpenClaw yang dipasang sendiri di Windows atau Mac tidak dikelola Saka. Saka hanya mengurus OpenClaw yang dipasang lewat panel (di dalam Docker). Jalur yang disarankan: pasang OpenClaw lewat Saka di Ubuntu (WSL atau Multipass), lalu hentikan OpenClaw lama. Jangan jalankan keduanya dengan token bot Telegram yang sama, karena keduanya akan berebut pesan.

PentingJangan membuka dasbor atau gateway OpenClaw ke internet lewat tunnel. Itu pintu masuk ke asisten yang memegang kunci API Anda. Dari luar rumah, pakai tombol Buka dasbor di panel Saka yang sudah terlindungi login.

Buka situs ke internet: tunnel

Server rumah biasanya di balik router tanpa IP publik. Tunnel membuat penghubung keluar dari server ke jaringan Cloudflare, jadi tidak perlu membuka port di router dan IP rumah tidak terlihat. HTTPS otomatis.

  1. Buka menu Tunnel di panel.
  2. Isi nama alamat (mis. tokokue menjadi tokokue-app.hack.id), pilih server, lalu pilih yang dibuka: situs Saka atau aplikasi web lain lewat nomor port (mis. 3000 atau 8080).
  3. Untuk situs, biarkan Jadikan alamat utama situs tercentang bila domain situs sekarang tidak bisa dibuka dari internet. WordPress akan mengganti semua tautannya ke alamat ini. Menghapus tunnel mengembalikan domain sebelumnya.
  4. Tekan Buat alamat.

Selama verifikasi nomor telepon belum tersedia, alamat baru ditinjau tim Saka dulu dan Anda dikabari lewat Telegram. Batas 3 alamat per akun. Nama yang mudah dipakai untuk menipu (bank, login, verifikasi, merek besar) tidak bisa dipakai.

Yang perlu diketahui

Lewat API atau AI

Agent AI Anda bisa membuat tunnel lewat MCP (tunnel_buat, tunnel_daftar, tunnel_hapus) atau API:

curl
curl -s -X POST https://app.saka.work/api/v1/tunnel \
  -H "Authorization: Bearer $SAKA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"nama": "tokokue", "server_id": "<id-server>", "situs_id": "<id-situs>", "utama": true}'

Untuk aplikasi web, ganti situs_id dengan "port": 8080. Menghapus: DELETE /api/v1/tunnel/<id> dengan {"konfirmasi": "<nama>"}.