Lewati ke konten
Versi 1.0.0 · PT Stellar Digital Innovations

Panduan Ruang Meeting

Langkah demi langkah memasang Ruang Meeting, menghubungkan akun Zoom kantor, dan mengelola tim Anda.

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

  1. Kebutuhan sistem
  2. Mengunduh dan memeriksa berkas
  3. Menjalankan pertama kali
  4. Menghubungkan akun Zoom
  5. Menambahkan pengguna dan peran
  6. Membuat dan mengelola meeting
  7. Portal pemohon
  8. Pengaturan organisasi
  9. Email, SSO, dan sinkron kalender
  10. Cadangan dan pemulihan
  11. Memasang di server kantor
  12. Pembaruan aplikasi
  13. 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

  1. Klik kanan berkas .zip → Extract All, lalu pilih folder tetap, misalnya C:\RuangMeeting.
  2. Buka folder hasil ekstrak, klik dua kali ruang-meeting.exe (berikon Ruang Meeting).
  3. Jika muncul Windows protected your PC, klik More info → Run anyway. Peringatan ini muncul karena aplikasi baru belum memiliki reputasi di SmartScreen.
  4. Jika Windows Firewall bertanya, izinkan untuk jaringan Private agar rekan kerja bisa membuka aplikasi dari komputernya.
  5. 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

  1. Klik dua kali berkas .tar.gz untuk mengekstrak.

  2. 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
    
  3. Jika macOS menolak karena "developer tidak dikenal", klik kanan berkas → Open sekali, atau jalankan:

    xattr -d com.apple.quarantine ruang-meeting
    

    Atau 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

  1. 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.
  2. Layar Penyiapan awal muncul. Isi nama organisasi, nama Anda, email, dan kata sandi (minimal 8 karakter, campuran huruf dan angka atau simbol).
  3. 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.

  1. Di Ruang Meeting buka Akun Zoom → Hubungkan akun Zoom. Panduan langkah demi langkah tampil di layar.

  2. Buka Zoom App Marketplace, pilih Develop → Build App → Server-to-Server OAuth App, beri nama (mis. "Ruang Meeting"), lalu Create.

  3. App Credentials: catat Account ID, Client ID, dan Client Secret.

  4. Information: isi Basic Information dan Developer Contact Information.

  5. 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).

  6. 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:admin
    

    Dua scope terakhir dipakai untuk laporan kehadiran dan butuh paket Zoom Pro atau lebih tinggi.

  7. Activation: klik Activate your app.

  8. Kembali ke Ruang Meeting, isi Account ID, Client ID, dan Client Secret, lalu klik Uji dan hubungkan.

  9. 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.

  1. Di layar Masuk, klik Lupa kata sandi?.
  2. Isi email akun, lalu klik Kirim kode. Kode 8 digit dikirim ke email tersebut.
  3. 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

  1. Klik Buat meeting (pintasan keyboard: N), atau klik area kosong pada jalur akun di papan jadwal.
  2. Isi judul, tanggal, jam, dan jumlah peserta. Panel kanan langsung menampilkan akun Zoom yang kosong. Yang paling cocok diberi tanda Disarankan.
  3. Opsional: divisi, pemohon, PIC, agenda, passcode khusus, rekam otomatis (tidak, lokal, atau cloud), dan bisukan peserta saat masuk.
  4. 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:

  1. Isi judul, waktu, jumlah peserta, dan pengulangan bila perlu.
  2. Klik Kirim permintaan. Permintaan masuk ke menu Permintaan milik operator.
  3. 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 dengan ruang-secret.key milik instalasi yang sama.

  • Manual: Pengaturan → Cadangan → Unduh cadangan, lalu beri kata sandi. Berkas .rmbk berisi 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_FILE dan TLS_KEY_FILE dengan 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:

  1. Buat cadangan (Pengaturan → Cadangan).
  2. Hentikan aplikasi.
  3. Unduh versi baru dan cocokkan SHA-256-nya.
  4. Ganti berkas ruang-meeting (atau ruang-meeting.exe) beserta ruang-meeting.sha256. Folder data jangan dihapus.
  5. Jalankan ruang-meeting verify, pastikan hasilnya COCOK.
  6. 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

Kembali ke atas

Dukung Tools Gratis Suka tools-nya? Dukung pengembangan kami

Tools Stellar gratis untuk publik. Dukungan sukarela membantu operasional server, maintenance, dan fitur baru.

Berikan Dukungan
Chat Sekarang