Ruang Meeting membantu tim IT mengatur banyak akun Zoom kantor dari satu kalender. Setiap akun Zoom menjadi satu jalur di papan jadwal. Saat ada permintaan meeting, aplikasi menunjukkan akun yang kosong, membuat meeting langsung di Zoom, lalu mengirim link ke pemohon.
Aplikasi ini berjalan di komputer atau server kantor Anda sendiri. Data jadwal, pengguna, dan kredensial Zoom tidak pernah dikirim ke PT Stellar Digital Innovations.
Isi panduan
- Kebutuhan sistem
- Mengunduh dan memeriksa berkas
- Menjalankan pertama kali
- Menghubungkan akun Zoom
- Menambahkan pengguna dan peran
- Membuat dan mengelola meeting
- Portal pemohon
- Pengaturan organisasi
- Email, SSO, dan sinkron kalender
- Cadangan dan pemulihan
- Memasang di server kantor
- Pembaruan aplikasi
- Pertanyaan umum dan kendala
Kebutuhan sistem
| Minimum | |
|---|---|
| Sistem operasi | Windows 10/11 64-bit, macOS 12 atau lebih baru (Apple Silicon atau Intel), Linux 64-bit (x86_64 atau ARM64) |
| Memori | 256 MB kosong |
| Ruang disk | 100 MB untuk aplikasi dan data awal |
| Jaringan | Akses keluar ke zoom.us (HTTPS port 443) |
| Akun Zoom | Paket berbayar (Pro, Business, atau Enterprise) dengan hak membuat aplikasi Server-to-Server OAuth |
| Browser pengguna | Chrome, Edge, Firefox, atau Safari versi terbaru |
Tidak perlu memasang database, Node.js, atau runtime lain. Basis data SQLite sudah tertanam. PostgreSQL bisa dipakai bila penggunanya banyak.
Mengunduh dan memeriksa berkas
Pilih berkas yang sesuai dengan komputer yang akan menjalankan aplikasi:
| Berkas | Untuk |
|---|---|
ruang-meeting-1.0.0-windows-x86_64.zip |
Windows 10/11 64-bit |
ruang-meeting-1.0.0-macos-apple-silicon.tar.gz |
Mac dengan chip M1, M2, M3, M4 |
ruang-meeting-1.0.0-macos-intel.tar.gz |
Mac dengan prosesor Intel |
ruang-meeting-1.0.0-linux-x86_64.tar.gz |
Server atau PC Linux 64-bit |
ruang-meeting-1.0.0-linux-arm64.tar.gz |
Linux ARM64 (mis. server ARM, Raspberry Pi 4/5 64-bit) |
Tidak yakin Mac Anda yang mana? Klik menu Apple → About This Mac. Jika tertulis "Chip Apple M…", pilih Apple Silicon.
Memeriksa keaslian berkas
Cocokkan sidik SHA-256 berkas dengan daftar SHA256SUMS.txt di halaman unduhan.
Windows (PowerShell):
Get-FileHash .\ruang-meeting-1.0.0-windows-x86_64.zip -Algorithm SHA256
macOS:
shasum -a 256 ruang-meeting-1.0.0-macos-apple-silicon.tar.gz
Linux:
sha256sum ruang-meeting-1.0.0-linux-x86_64.tar.gz
Jika hasilnya berbeda dengan daftar, jangan jalankan berkas itu. Unduh ulang dari halaman resmi.
Memeriksa keaslian executable
Selain arsip, setiap executable punya sidik SHA-256 resmi. Di dalam arsip ada
berkas ruang-meeting.sha256, dan daftar lengkapnya ada di
BINARY-SHA256SUMS.txt di halaman unduhan. Cara paling mudah memeriksanya:
./ruang-meeting verify
Hasil COCOK berarti executable sama persis dengan yang diterbitkan PT
Stellar Digital Innovations. Hasil TIDAK COCOK berarti berkas rusak atau
telah diubah: jangan jalankan, unduh ulang. Anda juga bisa membandingkan dengan
daftar resmi: ruang-meeting verify BINARY-SHA256SUMS.txt, atau menampilkan
sidiknya saja dengan ruang-meeting version.
Setelah aplikasi berjalan, administrator dapat melihat status yang sama di Pengaturan → Tentang → Keaslian berkas aplikasi. Aplikasi mencocokkan dirinya dengan checksum resmi dari pemeriksaan pembaruan harian.
Menjalankan pertama kali
Windows
- Klik kanan berkas
.zip→ Extract All, lalu pilih folder tetap, misalnyaC:\RuangMeeting. - Buka folder hasil ekstrak, klik dua kali
ruang-meeting.exe(berikon Ruang Meeting). - Jika muncul Windows protected your PC, klik More info → Run anyway. Peringatan ini muncul karena aplikasi baru belum memiliki reputasi di SmartScreen.
- Jika Windows Firewall bertanya, izinkan untuk jaringan Private agar rekan kerja bisa membuka aplikasi dari komputernya.
- Jendela terminal yang terbuka adalah server aplikasi. Isinya ringkasan status, alamat yang bisa dibuka, dan lokasi folder data. Biarkan jendela tetap terbuka; browser terbuka otomatis ke halaman aplikasi.
macOS
-
Klik dua kali berkas
.tar.gzuntuk mengekstrak. -
Buka folder hasil ekstrak, lalu klik dua kali
ruang-meeting(berikon Ruang Meeting). Terminal terbuka, menampilkan ringkasan status, dan browser terbuka otomatis ke halaman aplikasi. Bisa juga dari Terminal:cd ~/Downloads/ruang-meeting-1.0.0-macos-apple-silicon ./ruang-meeting -
Jika macOS menolak karena "developer tidak dikenal", klik kanan berkas → Open sekali, atau jalankan:
xattr -d com.apple.quarantine ruang-meetingAtau buka System Settings → Privacy & Security, lalu klik Open Anyway.
Linux
tar -xzf ruang-meeting-1.0.0-linux-x86_64.tar.gz
cd ruang-meeting-1.0.0-linux-x86_64
chmod +x ruang-meeting
./ruang-meeting
Executable Linux dibuat statis, jadi berjalan di Ubuntu, Debian, RHEL, Rocky, Alpine, dan distro lain tanpa pustaka tambahan.
Membuat akun administrator
- Di Windows dan macOS browser terbuka otomatis. Jika tidak, buka
http://localhost:8080. Dari komputer lain di jaringan kantor, pakai
alamat di baris Dari komputer lain pada jendela terminal, misalnya
http://192.168.1.20:8080. - Layar Penyiapan awal muncul. Isi nama organisasi, nama Anda, email, dan kata sandi (minimal 8 karakter, campuran huruf dan angka atau simbol).
- Klik Buat akun dan masuk.
Layar ini hanya muncul sekali. Setelah administrator pertama dibuat, semua pengguna lain masuk lewat layar Masuk.
Penting: fitur Lupa kata sandi lewat email baru aktif setelah email (SMTP) diatur di Pengaturan → Email. Pesan ini juga ditampilkan di layar penyiapan awal. Sebelum SMTP diatur, buat minimal dua akun administrator agar bisa saling mengatur ulang kata sandi.
Lokasi data
Aplikasi membuat folder data di samping executable:
| Berkas | Isi |
|---|---|
data/ruang.db |
Basis data jadwal, pengguna, dan pengaturan |
data/ruang-secret.key |
Kunci enkripsi kredensial Zoom, SMTP, dan SSO |
data/backups/ |
Cadangan otomatis harian |
data/ruang-meeting.env |
Pengaturan lanjutan (opsional) |
Simpan ruang-secret.key baik-baik. Tanpa berkas ini, kredensial yang
tersimpan tidak bisa dibuka dan harus dimasukkan ulang. Jangan kirim berkas ini
lewat email atau chat.
Keamanan data
| Data | Perlindungan |
|---|---|
| Client Secret Zoom, secret webhook, kata sandi SMTP, secret SSO, token kalender, kunci notifikasi | Dienkripsi AES-256-GCM dengan ruang-secret.key |
| Kata sandi pengguna | Hash Argon2id (tidak bisa dikembalikan) |
| Sesi login, token API, kode lupa kata sandi | Hash SHA-256 |
| Kode lupa kata sandi di antrean email | Dienkripsi, lalu dihapus setelah terkirim, gagal, atau kedaluwarsa |
| Cadangan manual / otomatis | Dienkripsi dengan kata sandi Anda / dengan kunci instalasi |
| Jadwal, nama dan email pengguna, riwayat aktivitas | Tersimpan apa adanya di database |
Di macOS dan Linux, folder data dan semua isinya otomatis hanya bisa dibaca
akun yang menjalankan aplikasi (izin 700/600). Di Windows, letakkan folder
aplikasi di lokasi yang hanya bisa diakses administrator atau akun layanan.
Untuk server produksi, aktifkan juga enkripsi disk sistem operasi: BitLocker (Windows), FileVault (macOS), atau LUKS (Linux). Dengan begitu seluruh isi database tetap terlindungi jika disk atau laptop dicuri.
Menghubungkan akun Zoom
Ruang Meeting terhubung melalui aplikasi Server-to-Server OAuth di akun Zoom kantor. Admin akun Zoom membuatnya sekali untuk setiap akun Zoom.
-
Di Ruang Meeting buka Akun Zoom → Hubungkan akun Zoom. Panduan langkah demi langkah tampil di layar.
-
Buka Zoom App Marketplace, pilih Develop → Build App → Server-to-Server OAuth App, beri nama (mis. "Ruang Meeting"), lalu Create.
-
App Credentials: catat Account ID, Client ID, dan Client Secret.
-
Information: isi Basic Information dan Developer Contact Information.
-
Feature (opsional): aktifkan Event Subscription agar status "sedang berlangsung" tampil seketika. Endpoint URL dan daftar event tampil di Ruang Meeting; klik nama event untuk menyalinnya, lalu tempel di kolom pencarian event Zoom. Fitur ini butuh alamat HTTPS publik (lihat Memasang di server kantor).
-
Scopes: klik Add Scopes. Zoom hanya menerima satu scope per pencarian, jadi tambahkan satu per satu: di Ruang Meeting, klik nama scope untuk menyalinnya (tanda centang menandai yang sudah disalin), tempel di kolom pencarian Zoom, lalu centang. Daftar lengkapnya:
user:read:list_users:admin user:read:settings:admin meeting:read:list_meetings:admin meeting:read:meeting:admin meeting:write:meeting:admin meeting:update:meeting:admin meeting:delete:meeting:admin meeting:read:list_past_instances:admin report:read:list_meeting_participants:adminDua scope terakhir dipakai untuk laporan kehadiran dan butuh paket Zoom Pro atau lebih tinggi.
-
Activation: klik Activate your app.
-
Kembali ke Ruang Meeting, isi Account ID, Client ID, dan Client Secret, lalu klik Uji dan hubungkan.
-
Pilih pengguna Zoom yang dijadikan host (jalur di papan jadwal), atur kapasitas peserta, lalu simpan.
Client Secret disimpan terenkripsi di server dan tidak pernah dikirim kembali ke browser.
Menambahkan pengguna dan peran
Buka Pengaturan → Pengguna → Tambah pengguna.
| Peran | Bisa melakukan |
|---|---|
| Administrator | Semua fitur, termasuk akun Zoom, pengguna, SSO, email, cadangan, dan pembaruan |
| Operator | Membuat, mengubah, memindah, dan membatalkan meeting; menyetujui permintaan; melihat laporan |
| Pemohon | Hanya portal pemohon: mengajukan meeting dan melihat status serta link milik sendiri |
Pengguna bisa mengganti kata sandi sendiri dari menu nama di pojok kiri bawah. Setelah 5 kali salah kata sandi, akun dikunci sementara selama 15 menit.
Lupa kata sandi
Syarat: email (SMTP) sudah diatur dan aktif di Pengaturan → Email. Tanpa SMTP, layar lupa kata sandi hanya menyarankan pengguna menghubungi administrator.
- Di layar Masuk, klik Lupa kata sandi?.
- Isi email akun, lalu klik Kirim kode. Kode 8 digit dikirim ke email tersebut.
- Isi kode dan kata sandi baru, lalu klik Simpan dan masuk.
Ketentuan keamanan:
- Kode berlaku 30 menit, hanya sekali pakai, dan hangus setelah 5 kali salah.
- Kode baru bisa diminta setiap 60 detik, maksimal 5 kali per jam per email.
- Jawaban layar selalu sama, baik email terdaftar maupun tidak, sehingga daftar akun tidak bisa ditebak.
- Setelah kata sandi diganti, semua sesi lama pengguna tersebut di perangkat lain otomatis keluar.
- Akun yang hanya memakai SSO juga bisa membuat kata sandi dengan cara ini.
Administrator tetap bisa mengatur ulang kata sandi pengguna lain dari Pengaturan → Pengguna.
Membuat dan mengelola meeting
Membuat meeting
- Klik Buat meeting (pintasan keyboard:
N), atau klik area kosong pada jalur akun di papan jadwal. - Isi judul, tanggal, jam, dan jumlah peserta. Panel kanan langsung menampilkan akun Zoom yang kosong. Yang paling cocok diberi tanda Disarankan.
- Opsional: divisi, pemohon, PIC, agenda, passcode khusus, rekam otomatis (tidak, lokal, atau cloud), dan bisukan peserta saat masuk.
- Klik Buat meeting. Meeting dibuat di Zoom dan link-nya bisa langsung disalin.
Setiap meeting otomatis diberi jeda persiapan 10 menit sebelum dan sesudahnya, sehingga akun yang sama tidak dipakai berdempetan.
Meeting berulang
Pada bagian Pengulangan pilih Harian, Mingguan, atau Bulanan, lalu tentukan Jumlah kali atau Tanggal akhir. Pratinjau menampilkan semua tanggal dan akun yang kosong untuk seluruh seri. Tanggal yang bentrok, atau jatuh di luar jam kerja dan hari libur saat aturan jam kerja diwajibkan, ditandai sebelum disimpan. Seluruh seri bisa dibatalkan sekaligus dari detail meeting.
Memindah, mengubah, dan membatalkan
Klik sebuah meeting untuk membuka detailnya:
- Pindah akun: memindahkan meeting ke akun Zoom lain yang kosong. Link baru dikirim ke pemohon.
- Ubah jadwal: mengganti judul, waktu, atau opsi Zoom. Perubahan langsung tercermin di Zoom.
- Ubah informasi pemohon: memperbarui divisi, pemohon, PIC, atau kontak.
- Batalkan meeting atau Batalkan seri: menghapus meeting di Zoom dan memberi tahu pemohon.
- Kehadiran: setelah meeting selesai, daftar peserta dan durasi hadir tampil dan bisa diunduh sebagai CSV.
Tampilan kalender
Pilih Hari, Minggu, Bulan, atau Agenda. Klik nama akun di atas
kalender untuk menyaring. Kotak pencarian (/) mencari judul, divisi, atau PIC.
Laporan
Menu Laporan menampilkan penggunaan per bulan: beban setiap akun, jam yang dipesan, rincian per divisi, serta menit terjadwal dibanding menit aktual dan jumlah peserta hadir. Klik Ekspor CSV untuk mengolahnya di spreadsheet.
Portal pemohon
Pengguna berperan Pemohon langsung masuk ke portal sederhana:
- Isi judul, waktu, jumlah peserta, dan pengulangan bila perlu.
- Klik Kirim permintaan. Permintaan masuk ke menu Permintaan milik operator.
- Setelah disetujui, link Zoom muncul di daftar Permintaan saya dan dikirim lewat email (jika email aktif).
Pemohon tidak pernah melihat link host atau kredensial Zoom.
Pengaturan organisasi
Pengaturan → Umum:
- Nama organisasi, tampil di layar masuk dan email.
- Zona waktu: WIB, WITA, atau WIT. Semua jam di aplikasi, email, dan undangan kalender mengikuti zona ini.
- Jam dan hari kerja, misalnya Senin–Jumat 07:00–18:00.
- Hari libur, misalnya libur nasional dan cuti bersama.
- Tolak pemesanan di luar jam kerja: jika aktif, pemesanan di luar jam kerja, akhir pekan, dan hari libur ditolak. Jika mati, jam kerja hanya menjadi panduan.
Email, SSO, dan sinkron kalender
Email (SMTP)
Pengaturan → Email. Isi server SMTP kantor (mis. smtp.office365.com
port 587 STARTTLS, atau smtp.gmail.com), akun pengirim, lalu klik
Kirim email uji. Pemohon akan menerima konfirmasi berisi link Zoom dan
undangan kalender .ics, serta kabar saat meeting diubah, dipindah, atau
dibatalkan. Email aktif juga menyalakan fitur Lupa kata sandi di layar
masuk.
Login SSO (Google Workspace dan Microsoft 365)
Pengaturan → Login SSO. Buat OAuth client di Google Cloud Console atau Microsoft Entra, tempel Redirect URI yang tampil di halaman ini, lalu isi Client ID dan Client Secret. Batasi domain email kantor dan tentukan apakah akun dibuat otomatis saat pertama masuk.
SSO membutuhkan alamat publik yang tetap (lihat PUBLIC_BASE_URL).
Sinkron kalender
Pengaturan → Kalender:
- Sinkron otomatis ke Google Calendar atau Outlook. Memakai aplikasi SSO yang sama; meeting baru, perubahan, dan pembatalan tercermin otomatis.
- Langganan ICS: alamat pribadi yang ditempel di aplikasi kalender apa pun tanpa login. Jangan bagikan alamat ini.
Cadangan dan pemulihan
-
Otomatis: cadangan terenkripsi dibuat setiap hari di
data/backups/. Empat belas cadangan terbaru disimpan. Cadangan otomatis hanya bisa dibuka denganruang-secret.keymilik instalasi yang sama. -
Manual: Pengaturan → Cadangan → Unduh cadangan, lalu beri kata sandi. Berkas
.rmbkberisi seluruh data termasuk kredensial, terenkripsi dengan kata sandi tersebut. -
Pulihkan: dari halaman yang sama, atau lewat baris perintah:
./ruang-meeting backup --out cadangan.rmbk --password "kata sandi kuat" ./ruang-meeting restore cadangan.rmbk --password "kata sandi kuat"
Simpan salinan cadangan di lokasi lain (NAS atau penyimpanan cloud kantor).
Memasang di server kantor
Pengaturan lanjutan
Salin ruang-meeting.env.example menjadi data/ruang-meeting.env, lalu ubah
baris yang diperlukan:
| Pengaturan | Kegunaan |
|---|---|
BIND_ADDR=0.0.0.0:8080 |
Alamat dan port server |
PUBLIC_BASE_URL=https://ruang.kantor.co.id |
Alamat publik untuk link email, SSO, dan webhook Zoom |
TLS_CERT_FILE, TLS_KEY_FILE |
HTTPS langsung tanpa reverse proxy (berkas PEM) |
DATABASE_URL=postgresql://… |
Memakai PostgreSQL alih-alih SQLite |
ENABLE_HOST_ACTIONS=false |
Menyembunyikan tombol "Mulai sebagai host" |
Opsi baris perintah:
ruang-meeting --bind 0.0.0.0:9000 port lain
ruang-meeting --data-dir D:\RuangData folder data lain
ruang-meeting --no-browser jangan buka browser otomatis
ruang-meeting version tampilkan versi dan SHA-256
ruang-meeting verify periksa keaslian berkas
HTTPS
Webhook Zoom dan SSO memerlukan HTTPS. Pilih salah satu:
-
Reverse proxy (Nginx, Caddy, IIS, Cloudflare Tunnel) di depan port 8080. Contoh Caddy:
ruang.kantor.co.id { reverse_proxy 127.0.0.1:8080 } -
Atau isi
TLS_CERT_FILEdanTLS_KEY_FILEdengan sertifikat kantor.
Berjalan otomatis saat server menyala
Linux (systemd), simpan sebagai /etc/systemd/system/ruang-meeting.service:
[Unit]
Description=Ruang Meeting
After=network-online.target
[Service]
ExecStart=/opt/ruang-meeting/ruang-meeting
WorkingDirectory=/opt/ruang-meeting
Restart=always
User=ruang
[Install]
WantedBy=multi-user.target
sudo systemctl enable --now ruang-meeting
Windows: gunakan Task Scheduler dengan pemicu At startup, atau NSSM untuk menjadikannya Windows Service.
Pembaruan aplikasi
Ruang Meeting memeriksa versi baru sekali sehari. Jika ada, administrator melihat pemberitahuan di aplikasi dan di Pengaturan → Tentang. Pembaruan tidak pernah dipasang otomatis.
Cara memperbarui:
- Buat cadangan (Pengaturan → Cadangan).
- Hentikan aplikasi.
- Unduh versi baru dan cocokkan SHA-256-nya.
- Ganti berkas
ruang-meeting(atauruang-meeting.exe) besertaruang-meeting.sha256. Folderdatajangan dihapus. - Jalankan
ruang-meeting verify, pastikan hasilnya COCOK. - Jalankan kembali. Basis data diperbarui otomatis.
Pertanyaan umum dan kendala
Halaman tidak terbuka dari komputer lain.
Pastikan firewall mengizinkan port 8080, dan aplikasi berjalan dengan
BIND_ADDR=0.0.0.0:8080 (bawaan).
"Gagal terhubung" saat menghubungkan akun Zoom. Periksa ketiga kredensial, pastikan aplikasi di Zoom sudah Activated, dan semua scope sudah ditambahkan. Pesan kesalahan di layar menyebut scope yang kurang.
Laporan kehadiran kosong. Butuh paket Zoom Pro ke atas dan dua scope laporan. Data tersedia beberapa menit setelah meeting berakhir.
"Port 8080 sudah dipakai aplikasi lain."
Biasanya Ruang Meeting sudah berjalan di jendela lain; tutup jendela itu. Atau
jalankan dengan port lain: ruang-meeting --bind 0.0.0.0:9000 (atau ubah
BIND_ADDR).
Angka merah/kuning di samping menu Aktivitas. Angka itu adalah jumlah proses ke Zoom yang gagal atau belum pasti hasilnya, bukan jumlah pesan yang belum dibaca, jadi tidak hilang hanya dengan membuka halamannya. Buka Aktivitas, lalu:
- Sinkronisasi gagal: klik Lihat akun dan perbaiki akun yang bermasalah. Masalah ini hilang sendiri setelah sinkronisasi berikutnya selesai.
- Masalah yang sudah ditangani: klik Tandai selesai.
- Status Perlu dicek: klik Periksa ulang di Zoom. Status ini tidak bisa ditandai selesai karena slot akun masih ditahan sampai hasilnya pasti.
Lupa kata sandi. Jika email (SMTP) sudah aktif, pakai Lupa kata sandi? di layar masuk (lihat Lupa kata sandi). Jika belum, administrator dapat mengatur ulang kata sandi pengguna lain dari Pengaturan → Pengguna. Karena itu, buat minimal dua akun administrator sejak awal.
"Tidak cocok dengan checksum resmi" di halaman Tentang.
Executable berbeda dari yang diterbitkan. Hentikan aplikasi, unduh ulang dari
halaman resmi, jalankan ruang-meeting verify, lalu ganti berkasnya. Data di
folder data tetap aman.
Apakah data dikirim ke Stellar?
Tidak. Satu-satunya koneksi ke Stellar adalah pemeriksaan versi harian yang
mengunduh berkas latest.json publik.
© 2026 PT Stellar Digital Innovations · stellardigitalinnovations.com