Dari API token Proxmox sampai aksi pertama yang dikonfirmasi.

01Aturan kredensial

Halaman ini tidak berisi kredensial apa pun. Setiap nilai rahasia ditulis sebagai placeholder, misalnya <TOKEN-SECRET>.

• Gunakan token khusus pmxapps@pve, bukan root@pam.
• Mulai dari read-only. Tambahkan role operator hanya jika ingin membuat VM dan template, memperbesar disk, atau me-reboot node.
• Berikan role storage admin hanya jika Proxmox Apps boleh menjadikan disk baru sebagai storage.
• Jika sebuah rahasia pernah terekspos, anggap sudah bocor: cabut dan buat ulang (bagian 15).

02Prasyarat

• Node Proxmox VE (disarankan 8.x atau 9.x) yang bisa diakses lewat web UI.
• Akses shell root ke node tersebut (SSH atau menu Shell di web UI).
• Alamat IP atau hostname node yang bisa dijangkau dari server Proxmox Apps.
• Akun dashboard — lewat undangan email dari Superadmin tenant Anda (bagian 13).
• Akses jaringan: halaman login organisasi (/t/<slug>), dashboard anggota, serta link undangan dan reset password anggota bisa dibuka dari internet. Administrasi platform dan panduan ini hanya bisa dibuka dari VPN yang diizinkan; dari jaringan lain muncul halaman “akses terbatas”.
• Untuk template: node bisa mengakses HTTPS keluar ke cloud-images.ubuntu.com.

03User & API token (read-only)

Jalankan di shell node. Untuk cluster, cukup jalankan sekali di node mana saja — konfigurasinya berlaku untuk semua node.

# 1. User khusus (realm pve)
pveum user add pmxapps@pve --comment "Proxmox Apps"

# 2. Hak baca ke seluruh datacenter
pveum acl modify / --users pmxapps@pve --roles PVEAuditor

# 3. API token; --privsep 0 = token mewarisi hak user
pveum user token add pmxapps@pve dashboard --privsep 0

Perintah ketiga menampilkan full-tokenid dan value:

04Role operator & storage

Hanya dibutuhkan untuk aksi yang mengubah infrastruktur. Dashboard, monitoring, laporan, dan semua pertanyaan read-only ke asisten tetap jalan tanpa role ini.

Operator — VM, template cloud-init, resize disk, reboot

pveum role add PMXAppsOperator --privs "VM.Audit VM.Allocate VM.Clone VM.Config.CPU VM.Config.Memory VM.Config.Disk VM.Config.Network VM.Config.Options VM.Config.HWType VM.Config.Cloudinit VM.PowerMgmt VM.Console VM.Config.CDROM Datastore.Audit Datastore.AllocateSpace Datastore.AllocateTemplate Sys.Audit Sys.PowerMgmt Sys.AccessNetwork SDN.Use"
# role sudah ada? ganti daftar privilege-nya:
pveum role modify PMXAppsOperator --privs "VM.Audit VM.Allocate VM.Clone VM.Config.CPU VM.Config.Memory VM.Config.Disk VM.Config.Network VM.Config.Options VM.Config.HWType VM.Config.Cloudinit VM.PowerMgmt VM.Console VM.Config.CDROM Datastore.Audit Datastore.AllocateSpace Datastore.AllocateTemplate Sys.Audit Sys.PowerMgmt Sys.AccessNetwork SDN.Use"

pveum acl modify / --users pmxapps@pve --roles PMXAppsOperator

pveum acl modify / --tokens 'pmxapps@pve!<nama-token>' --roles PMXAppsOperator
pveum user token permissions pmxapps@pve <nama-token>

VM.Console dipakai menu Console (terminal dan layar VM di browser). VM.Config.CDROM dipakai saat membuat template: VM di-boot sekali dengan disk setup kecil untuk memasang qemu-guest-agent. Tanpa privilege ini template tetap bisa dibuat, hanya tanpa guest agent.

Sys.AccessNetwork (untuk mengunduh cloud image) ada di PVE 8.4+/9; di versi lebih lama gunakan Sys.Modify. SDN.Use tidak ada di PVE 7 — hapus dari daftar di sana.

Opsional: storage admin — menjadikan disk baru sebagai storage

pveum role add PMXAppsStorageAdmin --privs "Sys.Modify Datastore.Allocate"
pveum acl modify / --users pmxapps@pve --roles PMXAppsStorageAdmin
pveum acl modify / --tokens 'pmxapps@pve!<nama-token>' --roles PMXAppsStorageAdmin

05Akses jaringan ke port 8006

Server Proxmox Apps memanggil API Proxmox lewat HTTPS di port 8006. Buka port ini hanya untuk IP server Proxmox Apps.

curl -k -s -o /dev/null -w "%{http_code}\n" https://<PROXMOX-IP>:8006/api2/json/version
# 401 = API terjangkau (wajar tanpa token) · 000 = tidak terjangkau / diblokir

1. Buka Datacenter → Firewall → Add.
2. Isi Direction in, Action ACCEPT, Protocol tcp, Dest. port 8006, Source 161.248.116.4 (server Proxmox Apps).
3. Pastikan aturan untuk akses admin Anda sendiri (web UI dan SSH) sudah ada sebelum firewall diaktifkan.

06Menambah target

Masuk ke dashboard lewat halaman login organisasi Anda (link dari email undangan) sebagai Superadmin tenant, buka Proxmox connections, lalu klik + Add target. Target hanya milik tenant yang sedang dipilih.

Target yang belum lolos tes tidak dipakai oleh dashboard maupun asisten. Mengubah URL, token, atau opsi TLS menonaktifkan target sampai dites ulang.

07Overview & monitoring

Overview hanya untuk melihat. Semua aksi ada di Operations dan Storage & disks. Data node, VM, dan cluster diperbarui otomatis setiap 5 detik (indikator Live di menu).

08AI settings & asisten

Setiap tenant memakai akun penyedia AI dan API key-nya sendiri. Pengaturan ini hanya bisa diubah oleh Superadmin tenant.

1. Buka AI settings dan pilih penyedia: Anthropic, SumoPod, OpenAI, atau Other untuk endpoint lain yang kompatibel dengan OpenAI.
2. Tempel API key dari dashboard penyedia. Key dienkripsi di server dan tidak pernah ditampilkan lagi.
3. Isi model atau klik Load the model list from the provider.
4. Klik Test connection — hasil yang diharapkan “tool calling works”. Asisten membutuhkan tool calling.
5. Klik Save. Asisten langsung memakai pengaturan baru.

Asisten menjawab dari data Proxmox saat itu dan membalas dengan bahasa yang Anda pakai. Contoh:

• “Buatkan health report hari ini dan apa yang harus saya perbaiki dulu.”
• “Seberapa sibuk pve01 selama 7 hari terakhir?”
• “VM mana yang punya IP 10.0.0.25?”
• “Ada disk baru yang bisa dipakai untuk storage?”
• “Buat template Ubuntu 24.04 cloud-init di pve01.”
• “Buat template Ubuntu 24.04 di pve01 lalu langsung buat VM web01 dari template itu, 2 vCPU, 4 GB RAM, disk 40 GB.”

Menu Tools — tanpa perlu menghafal command

Klik tombol Tools di sebelah kotak chat. Aksi dikelompokkan per kategori — Monitoring, VMs, Power, Storage, Provisioning, Reports, General — dan bisa dicari (misalnya “backup”, “restart”, “iso”).

• Aksi tanpa isian langsung jalan. Aksi yang butuh data membuka form singkat: node dan VM dipilih dari daftar live (Start hanya menampilkan guest yang mati, Shutdown/Restart/Stop hanya yang menyala), jenis laporan, rentang, distro, dan jenis download berupa pilihan.
• Form menampilkan command yang akan dikirim (misalnya /tasks 48) — tombol Run atau Create proposal mengirimkannya.
• Percakapan kosong menampilkan kartu “What do you want to do?” per kategori dengan aksi yang paling sering dipakai.
• Keyboard: Esc kembali ke daftar lalu menutup panel. Mengetik / tetap bekerja seperti biasa.

Command chat untuk pekerjaan harian

Ketik / di kotak chat untuk memunculkan daftar command, pilih dengan panah lalu Tab atau Enter (command tanpa argumen langsung jalan). Ketik /help untuk daftar lengkap.

• Instan dan proposal tidak memakai AI — cepat, tanpa biaya token, dan tetap jalan walau AI belum diatur.
• Command AI memakai instruksi, format jawaban, dan daftar tool yang tetap sehingga hasilnya konsisten.
• Command yang membuat proposal butuh role Operator atau Superadmin.
• Superadmin bisa mewajibkan command saja di Team & roles → Tenant settings, sehingga chat bebas ditolak.

Template lalu VM dalam satu perintah

Minta asisten membuat template sekaligus VM dari template itu. Asisten membuat dua kartu proposal: template dan VM (bertanda built by #…). Konfirmasi kartu template dulu, lalu kartu VM — VM menunggu template selesai (hingga 60 menit), mengecek ulang kondisi Proxmox, lalu clone otomatis. Kartu VM tidak bisa dikonfirmasi sebelum template dikonfirmasi, dan otomatis gagal bila proposal template dibatalkan atau gagal.

Asisten yang benar-benar mengecek

Selain tool khusus (node, VM, laporan, disk, template), asisten punya akses baca ke seluruh API Proxmox lewat tool proxmox_get. Ia bisa memanggil beberapa endpoint berturut-turut untuk menyelidiki, misalnya: update paket yang pending, konfigurasi dan snapshot VM, isi storage backup, log task yang gagal, interface jaringan node, service, firewall, status HA, replication, Ceph, sertifikat, hingga info OS dan filesystem dari guest agent.

• Hanya permintaan GET (membaca); endpoint konsol, akses file, dan eksekusi perintah di dalam guest diblokir.
• Nilai rahasia di hasil (password, token, key) disamarkan; daftar yang terlalu besar dipotong.
• Hak akses mengikuti token Proxmox. Info dari guest agent butuh VM.GuestAgent.Audit (PVE 9) atau VM.Monitor (PVE 8), dan agent harus berjalan di dalam VM.
• Contoh: “Cek apakah ada update paket di pve01, konfigurasi VM 101, dan backup job yang terjadwal.”

Apa pun yang mengubah infrastruktur menjadi kartu proposal di bawah jawaban; tidak ada yang dijalankan sebelum dikonfirmasi. Pengguna dengan role Readonly tetap bisa bertanya, tetapi asisten tidak membuat proposal untuk mereka.

09Operations

• Baca rencana dan setiap peringatan sebelum konfirmasi. Proposal kedaluwarsa setelah 15 menit.
• Membuat, mengonfirmasi, dan membatalkan proposal membutuhkan role Operator atau Superadmin.
• Jika tenant mengaktifkan four-eyes, reboot node dan create storage harus dikonfirmasi oleh orang lain selain pembuat proposal.
• Progres tampil di kartu; hasil dan error disimpan di audit log.
• Jika token kurang hak untuk sebuah tab, Operations menampilkan privilege apa saja yang kurang.

Create template (cloud-init Ubuntu / Debian)

Pilih distro dan node di form, atau minta lewat chat: /template debian latest atau “buatkan template debian terbaru di pve01”. Untuk Debian, Proxmox Apps selalu memakai build bertanggal terbaru dari cloud.debian.org sehingga URL dan checksum pasti cocok. Pilih node — Proxmox Apps mendeteksi storage image (content import), storage disk, bridge, VMID kosong mulai 9000, dan tipe CPU (host untuk standalone, x86-64-v2-AES untuk cluster). Saat dikonfirmasi, image resmi diunduh dengan verifikasi SHA-256 (atau dipakai ulang), VM dibuat dengan serial console, flag guest agent, drive cloud-init, dan DHCP, disk diperbesar, lalu dijadikan template.

Download (ISO, cloud image, template LXC)

Tab Download mengunduh file ke storage node, dan node sendiri yang mengunduh serta memverifikasi checksum. Tidak ada yang berjalan sebelum dikonfirmasi.

Rencana mengecek storage yang mendukung jenis file, sisa ruang (ukuran dibaca langsung dari node), file yang sudah ada, dan unduhan ganda. Lewat chat: /download iso debian latest.

Create VM

Full clone dari template, lalu atur vCPU, RAM, dan disk. Centang Customize cloud-init untuk template cloud-init:

• User — terisi otomatis dari template (ubuntu untuk Ubuntu, debian untuk Debian) dan bisa diganti.
• Password (opsional, dengan konfirmasi) — disimpan hanya sebagai hash SHA-512; tidak pernah tampil atau tercatat polos di audit log. SSH key tetap lebih aman.
• SSH public keys — boleh lebih dari satu, satu key per baris. Key milik Anda sendiri (disimpan di My account → SSH keys) muncul sebagai tombol sekali klik di atas kotak ini, jadi tiap member memakai key-nya masing-masing tanpa saling berbagi.
• Jaringan DHCP atau IP statis + gateway, DNS server dan search domain (kosong = mengikuti DNS host Proxmox).
• Upgrade packages on first boot — memperbarui paket saat VM pertama kali menyala.

Asisten AI tidak menerima password lewat chat; password hanya diisi di form ini. Tab Templates di Overview punya tombol Create VM yang langsung membuka form ini dengan template terpilih.

Reboot node

Cluster: ditolak bila quorum akan hilang; dampak HA dijelaskan. Standalone: peringatan bahwa semua guest ikut mati.

Start / stop guest

Tab Start / stop guest menampilkan semua VM dengan pencarian. Pilih Start, Shutdown (mematikan dengan rapi, batas 3 menit), Reboot, atau Stop (cabut daya — hanya untuk guest yang hang). Rencana mengecek status saat ini, lock (backup/migrasi/snapshot), HA, dan sisa RAM node sebelum Anda konfirmasi. Asisten juga bisa mengusulkannya: “Shutdown VM 105”.

10Reports

• Buat kapan saja untuk 24 jam, 7 hari, atau 30 hari terakhir, atau minta lewat asisten.
• AI summary menambahkan ringkasan eksekutif dan daftar tindakan berprioritas, hanya berdasarkan data laporan.
• Grafik tampil di setiap laporan dan ikut tercetak di Print / PDF: health (pemakaian per storage pool, CPU/RAM sekarang vs rata-rata vs p95 per node), capacity (alokasi vCPU/RAM vs kapasitas fisik, sisa vs terpakai), backup (guest sudah vs belum dibackup 7 hari), activity (aksi per hari per status), inventory (VM per node). Laporan lama juga ikut punya grafik.
• Ekspor sebagai Markdown, CSV, atau Print / PDF. Markdown dan CSV hanya berisi data; angka di balik setiap grafik ada di tabel laporan.
• Company profile (menu Tenant admin, khusus Superadmin): nama perusahaan, logo PNG/JPG/SVG maks. 2 MB, dan alamat. Kalau diisi, header semua laporan tenant memakai logo di kiri atas beserta nama dan alamat — di layar, Print / PDF, dan Markdown (nama & alamat). Kalau kosong, header laporan tetap polos. SVG yang berisi script atau link eksternal ditolak.
• Jadwal harian (zona Asia/Jakarta) membuat laporan pilihan setiap pagi, opsional dengan AI summary. Laporan disimpan 180 hari dan terpisah per tenant.

11Storage & disks

Proxmox Apps memindai disk, volume group LVM, dan thin pool di setiap node lalu menjelaskan temuannya.

Resize disk VM memperbesar disk (tidak bisa mengecil). Setelahnya perluas partisi dan filesystem di dalam VM — image cloud Ubuntu melakukannya saat reboot berikutnya.

11bvRouter

Menu vRouter mengelola gateway jaringan di depan Proxmox: interface, port forward (NAT), firewall, dan daftar IP address (DHCP, reservasi, IP statis) — dengan pola usulan → konfirmasi yang sama seperti Operations.

Menyiapkan vRouter (sekali, lewat SSH)

1. Aktifkan HTTPS API dengan key acak yang panjang (buat sendiri, misalnya openssl rand -hex 32). Jangan pernah menempel key di chat.
2. Izinkan IP server Proxmox Apps ke port API di interface WAN. Aturannya hanya membuka satu port untuk satu alamat, jadi cukup commit lalu save — perhatikan keluarannya, jangan sampai ada error.
3. Superadmin menambahkan vRouter di vRouter → Connections (nama, API URL, API key, verifikasi TLS) lalu klik Test.

set service https api rest
set service https api keys id proxmox-apps key '<key-acak>'
set firewall ipv4 input filter rule 25 action 'accept'
set firewall ipv4 input filter rule 25 protocol 'tcp'
set firewall ipv4 input filter rule 25 destination port '443'
set firewall ipv4 input filter rule 25 source address '<ip-server-proxmox-apps>'
set firewall ipv4 input filter rule 25 inbound-interface name '<interface-wan>'
commit
save
exit

Kalau API tetap tidak terjangkau: masuk configuration mode (configure) lalu periksa show service https — harus ada api rest dan satu keys id — dan show firewall ipv4 input filter — harus ada aturan accept untuk alamat server Proxmox Apps di interface WAN. Perhatikan juga default-action: bila drop, ping memang tidak akan menjawab, dan itu normal. Di operational mode, konfigurasi bisa dilihat dengan show configuration commands | grep https.

Yang bisa dilakukan

Membuka akses VM dari internet (paling mudah)

Contoh: ingin SSH ke poc-01 dari laptop, atau membuka website di sebuah VM. Ada tiga cara, hasilnya sama:

1. Operations → Manage VMs → ⋯ → Internet access… pada VM yang dimaksud, atau tab vRouter → Port forwards.
2. Pilih apa yang ingin diakses (SSH, Website, Secure website, Remote Desktop, atau port lain), port publik (kosongkan untuk otomatis, misalnya 2257 untuk VM berakhiran .57), dan siapa yang boleh terhubung: hanya IP saya saat ini (disarankan), IP/jaringan tertentu, atau semua orang (tidak disarankan untuk SSH, wajib mengetik public N).
3. Klik Prepare access, periksa kartu usulan (alamat publik, siapa yang boleh masuk, IP tetap, dan cara terhubung), lalu Confirm.

Proxmox Apps mencari IP VM, membuat port forward, dan memasang reservasi DHCP (MAC → IP) agar akses tidak putus saat IP berubah. Setelah selesai, kartu menampilkan perintah siap pakai, misalnya ssh ubuntu@161.248.116.70 -p 2257. Detail VM di Manage VMs menampilkan bagian Internet access berisi semua akses yang aktif.

Port forward ke perangkat di luar Proxmox

Untuk server yang bukan VM di Proxmox VE, misalnya Proxmox Backup Server terpisah, NAS, kamera atau server fisik di belakang vRouter, buka vRouter → Port forwards → Add port forward → Other device (IP address). Tidak perlu lagi SSH ke vRouter.

1. Isi IP perangkat (saran diambil dari tab IP addresses) dan nama untuk rule, misalnya Proxmox Backup Server. Keterangan di bawah kolom menunjukkan apakah vRouter melihat perangkat itu (online, statis, DHCP, atau tidak terlihat).
2. Pilih layanan: HTTPS 443, Proxmox Backup Server 8007, SSH 22, HTTP 80, Remote Desktop 3389, atau port lain.
3. Port publik terisi otomatis dengan port bebas; bisa diganti.
4. Tentukan siapa yang boleh terhubung: hanya IP Anda, IP/jaringan tertentu, atau semua orang (tidak disarankan untuk halaman manajemen).

Perangkat harus memakai vRouter sebagai default gateway agar balasannya kembali. Usulan memberi peringatan bila IP tidak terlihat di tabel ARP vRouter, atau bila IP berada di pool DHCP tanpa reservasi. Nama perangkat disimpan di deskripsi rule NAT.

Lewat asisten AI cukup menulis, misalnya: "akses poc-01 lewat SSH port 2222 dari IP 203.0.113.10" atau perintah /akses poc-01 ssh 2222; ada juga di menu Tools → Network (vRouter). Login SSH tetap butuh password atau SSH key di VM (atur lewat Set login).

Login SSH dengan password: image resmi Ubuntu/Debian menolak password lewat SSH (PasswordAuthentication no). Template yang dibuat dengan opsi Allow SSH login with a password (bawaan aktif) sudah mengizinkannya. Untuk VM dari template lama, login sekali di console lalu jalankan:

sudo sh -c "echo 'PasswordAuthentication yes' > /etc/ssh/sshd_config.d/10-pmxapps-password-auth.conf && systemctl reload ssh"

VPN untuk remote akses (WireGuard)

Cara paling aman untuk mengakses VM dari luar tanpa membuka port SSH/web ke internet. Buka vRouter → VPN:

1. Isi nama perangkat (misalnya laptop-hamim) dan pilih yang bisa dijangkau: hanya jaringan VM (disarankan) atau semua trafik internet lewat vRouter. Klik Prepare device, lalu Confirm. Perangkat pertama sekaligus menyiapkan VPN di vRouter (wg0, jaringan 10.20.0.0/24, UDP 51820).
2. Di kartu yang sudah selesai klik Show device configuration: scan QR code dengan aplikasi WireGuard di HP, atau download file .conf dan pilih Import tunnel(s) from file di laptop. Konfigurasi berisi private key perangkat, hanya bisa dibuka Operator selama 24 jam dan tercatat di audit log.
3. Nyalakan tunnel, lalu akses VM dengan IP lokalnya, misalnya ssh ubuntu@10.10.99.57.

Tab VPN adalah monitor koneksi: setiap perangkat menampilkan online/offline (handshake dalam 3 menit terakhir), terakhir terlihat, asal koneksi, kecepatan saat ini, total trafik, serta grafik jumlah perangkat online satu jam terakhir (diperbarui tiap 15 detik). Selama 24 jam setelah dibuat, tombol Download profile dan QR ada langsung di baris perangkat — tinggal impor ke aplikasi WireGuard. Internet tetap jalan: mode jaringan VM hanya melewatkan subnet VM lewat VPN (internet memakai koneksi perangkat sendiri); mode semua trafik memakai NAT vRouter dengan DNS dari DHCP vRouter (atau 1.1.1.1). Tombol Remove mencabut akses. Lewat asisten AI: "buatkan VPN untuk laptop saya" atau /vpn add laptop-hamim, /vpn status, /vpn remove laptop-hamim. Private key tidak pernah ditampilkan di chat.

Pengaman

• Commit-confirm: setiap perubahan diterapkan dengan commit-confirm 5, lalu Proxmox Apps mengecek API vRouter dan semua target Proxmox tenant masih bisa dihubungi. Baru setelah itu confirm dan save. Kalau tidak bisa dicek, perubahan tidak dikonfirmasi dan vRouter kembali ke konfigurasi sebelumnya sendiri (di VyOS bawaan dengan reboot).
• Rule protected: rule yang dipakai Proxmox Apps sendiri (akses ke API vRouter, forward dan whitelist ke Proxmox, established/related) ditandai protected. Menghapusnya wajib mengetik remove rule N dan menampilkan peringatan.
• Port terlarang: port forward ke port API atau SSH vRouter di WAN ditolak karena akan memutus akses.
• Tanpa pembatasan sumber (terbuka ke internet) wajib mengetik open N / forward N.
• Four-eyes wajib untuk semua perubahan vRouter bila tenant punya lebih dari satu Operator/Superadmin, apa pun pengaturan four-eyes tenant — API key vRouter tidak bisa dibatasi read-only.
• Asisten AI bisa membaca vRouter (vrouter_show_*) dan membuat usulan yang sama; eksekusi tetap lewat tombol Confirm.

11cBackups (Proxmox Backup Server)

Menu Backups menampilkan status backup setiap VM, dan mengelola datastore Proxmox Backup Server (PBS) milik organisasi. Koneksi PBS ada di Tenant admin → Backup connections, sejajar dengan Proxmox connections: setiap organisasi menambahkan PBS-nya sendiri (boleh URL yang sama dengan organisasi lain) dan tidak bisa melihat koneksi atau datastore organisasi lain.

Selama organisasi belum punya koneksi PBS yang lolos tes, menu Backups tampil Coming soon (Superadmin melihat tombol untuk menambah koneksi).

1 · Dua kondisi pemakaian PBS

Contoh perintah di shell PBS untuk kondisi 1:

proxmox-backup-manager user create pmxapps@pbs
proxmox-backup-manager acl update / Admin --auth-id pmxapps@pbs
proxmox-backup-manager user generate-token pmxapps@pbs apps
proxmox-backup-manager acl update / Admin --auth-id 'pmxapps@pbs!apps'
proxmox-backup-manager cert info | grep Fingerprint

Untuk kondisi 2 (datastore acme-backup sudah ada):

proxmox-backup-manager user create acme@pbs
proxmox-backup-manager acl update /datastore/acme-backup DatastorePowerUser --auth-id acme@pbs
proxmox-backup-manager user generate-token acme@pbs apps
proxmox-backup-manager acl update /datastore/acme-backup DatastorePowerUser --auth-id 'acme@pbs!apps'

Secret token hanya tampil sekali: salin langsung ke form, jangan kirim lewat chat. Buka port 8007 PBS untuk server Proxmox Apps dan untuk semua node Proxmox VE yang mengirim backup.

2 · Menghubungkan backup server (provider, Platform → Dedicated-Backups)

Backup server (PBS) milik customer dihubungkan oleh provider di Platform → Dedicated-Backups: pilih organisasi, lalu + Add backup server. Organisasi melihat hasilnya di Tenant admin → Backup connections (baca-saja, dengan tombol Test dan tab Proxmox VE access), lalu membuat datastore, jadwal, dan restore sendiri di menu Backups. Wizard provider:

1. Backup server: isi alamat yang dipakai Proxmox Apps (misalnya https://161.248.116.70:18007), klik Check the server, lalu centang bahwa fingerprint sama dengan Dashboard → Show Fingerprint di PBS. Kalau yang diisi alamat privat, wizard menjelaskan perlunya port forward yang mengizinkan IP Proxmox Apps.
2. Access token: pilih kondisi (Proxmox Apps mengelola datastore, atau datastore yang sudah ada), salin perintah yang ditampilkan ke shell PBS, lalu tempel token ID dan secret. Connect and test langsung menyimpan dan mengetes koneksi.
3. Proxmox VE access: untuk setiap koneksi Proxmox pilih Same network, Through the internet, atau Through a VPN, dan isi alamat PBS yang dipakai node (misalnya 10.10.99.11:8007). Alamat dengan port 8006 (port Proxmox VE) ditolak.
4. Done: server terhubung ke organisasi; datastore dibuat organisasi sendiri di Backups → Datastores (membuat baru bila token boleh, atau memakai yang sudah ada).

Tab Proxmox VE access di Dedicated-Backups dipakai provider untuk mengubah alamat PBS per koneksi Proxmox setelah setup; organisasi hanya melihatnya. Fingerprint sertifikat dikunci dan token disimpan terenkripsi.

3 · Datastore (Backups → Datastores)

• + New datastore (kondisi 1): tentukan nama sendiri (3–30 karakter, unik di PBS), tempat penyimpanan, retention, jadwal cleanup dan verify. Proxmox Apps juga membuat retention job p-<nama>, verify job v-<nama>, serta user pmx-<nama>@pbs + token pve yang hanya berhak pada datastore itu. Kalau ada langkah yang gagal, semuanya dihapus lagi.

  Tempat penyimpanan	Yang terjadi
  Format an unused disk (disarankan)	Pilih disk yang belum terpakai (daftar menampilkan ukuran, model, serial, SMART). ext4/XFS untuk satu disk, atau ZFS (single, mirror, raidz, raidz2, raid10, raidz3) untuk satu atau beberapa disk. PBS memformat dan me-mount disk di /mnt/datastore/<nama>. Semua data di disk terhapus, jadi kartu usulan meminta Anda mengetik path disk, misalnya /dev/sdb.
  Disk atau ZFS pool yang sudah ter-mount	Datastore dibuat sebagai folder di dalamnya. Mount yang sudah menjadi datastore tidak bisa dipakai (datastore tidak boleh bersarang).
  Another folder	Folder pada disk yang Anda mount sendiri, misalnya /mnt/backup/acme. Folder sistem ditolak.
  System disk	Folder di bawah Datastore folder koneksi, di disk sistem PBS. Tidak disarankan karena backup berebut ruang dengan sistem operasi.

  Saat datastore yang dibuat di disk baru di-destroy, disk di-unmount dan di-wipe sehingga bisa dipakai lagi. Untuk ZFS, pool tetap ada dan dihapus manual dengan zpool destroy <nama>.
• + Add existing datastore (kondisi 2): pilih dari datastore yang terlihat oleh token. Tidak ada perubahan di PBS. Storage Proxmox VE yang sudah menunjuk ke datastore itu otomatis ditautkan.
• Remove: remove from Proxmox Apps only (datastore dan backup tetap), atau untuk datastore buatan Proxmox Apps: delete (file backup tetap di disk) / destroy (hapus semua backup, ketik nama datastore).

4 · Koneksi PBS ke Proxmox VE (standalone dan cluster)

Ada dua jalur yang berbeda: Proxmox Apps → PBS (URL koneksi, dari IP keluar server Proxmox Apps) dan node Proxmox VE → PBS (dipakai saat backup dan restore). Keduanya boleh memakai alamat berbeda.

• Di Platform → Dedicated-Backups (diatur provider; organisasi melihatnya di Tenant admin → Backup connections), setiap koneksi PBS punya tabel How each Proxmox VE connection reaches this backup server. Urutan prioritasnya: alamat untuk koneksi Proxmox tersebut, lalu Address for Proxmox VE (default semua koneksi Proxmox), lalu URL koneksi.
• Saat membuat/menambah datastore atau Connect to Proxmox, pilih koneksi Proxmox (standalone atau cluster), storage id, dan untuk cluster node yang mendapat storage. Form dan usulan menyebut alamat yang akan dipakai beserta asalnya. Storage PBS yang sudah ada di Proxmox VE otomatis ditautkan.
• Setelah storage ditambahkan, Proxmox Apps menunggu laporan status dari setiap node dan menyebut node yang belum bisa memakainya.
• Di Backups → Datastores, setiap tautan tampil dengan titik status (hijau: semua node bisa memakai storage, kuning: sebagian, merah: tidak ada / storage hilang), alamat yang dipakai, dan pesan masalah. Bila alamatnya berbeda dari yang seharusnya, tombol use <alamat> membuat usulan untuk memindahkan storage ke alamat itu (storage dibuat ulang dengan id yang sama; backup di PBS tidak tersentuh).
• Satu datastore bisa terhubung ke beberapa koneksi Proxmox sekaligus. Tombol × memutus tautan (storage buatan Proxmox Apps dihapus dari Proxmox VE, storage buatan manual dibiarkan).
• Proxmox VE memakai token datastore itu sendiri (kondisi 1) atau token koneksi (kondisi 2), dengan prune-backups keep-all karena retention diatur PBS. Token Proxmox perlu hak Datastore.Allocate pada /storage. Jadwal backup rutin dibuat di Proxmox VE (Datacenter → Backup).

5 · Backup dan snapshot dari Manage VMs

• Di Operations → Manage VMs, menu ⋯ setiap VM/CT (dan panel Details) punya Backup now… dan Snapshots….
• Backup now memakai datastore yang terhubung ke koneksi Proxmox tempat VM berada; pilih mode snapshot/suspend/stop dan opsi protect. Kalau organisasi belum terhubung ke PBS, datastore belum ada, atau belum terhubung ke Proxmox tersebut, muncul popup yang menjelaskan penyebabnya (Superadmin langsung mendapat tombol ke halaman yang tepat).
• Snapshots menampilkan daftar snapshot, membuat snapshot baru (opsional termasuk RAM untuk VM yang berjalan), rollback (ketik nama snapshot untuk konfirmasi, opsi start setelahnya), dan hapus. Snapshot hanya bisa dibuat bila semua disk berada di storage yang mendukung (LVM-thin, ZFS, Ceph RBD, atau disk qcow2); kalau tidak, dialog menjelaskan disk mana penyebabnya.
• Snapshot adalah titik pulih cepat di storage yang sama, bukan backup. Pakai sebelum upgrade atau perubahan berisiko, lalu hapus setelah aman.
• Token Proxmox perlu VM.Snapshot (buat/hapus) dan VM.Snapshot.Rollback (rollback).

6 · Pemakaian sehari-hari

• Readonly hanya melihat. Operator: backup now, restore, protect, hapus backup, jalankan job. Superadmin: koneksi PBS, datastore, tautan Proxmox VE, retention.
• Tombol yang tidak diizinkan token di PBS (misalnya garbage collection pada token kondisi 2) dinonaktifkan dengan keterangan.
• Restore selalu ke VM/CT baru (VMID baru, MAC baru); VM asli tidak disentuh.
• AI assistant bisa menjawab “VM mana yang belum di-backup?” dan membuat usulan backup atau restore.

12Audit log

• Kolom Actor membedakan aksi yang diusulkan asisten (agent) dan yang dibuat di dashboard (manual), beserta email penggunanya.
• Filter berdasarkan email aktor, tipe aktor, status, nama action, dan rentang tanggal (zona Asia/Jakarta); tombol Export CSV mengunduh hasil filter.
• Setiap tenant hanya melihat audit miliknya. Platform Admin punya Platform audit untuk semua tenant plus event platform (login, reset password, perubahan tenant, user, dan SMTP).
• Rahasia dan API key tidak pernah dicatat.

13Tenant, tim & role

Satu tenant = satu pelanggan dengan infrastruktur Proxmox, anggota, pengaturan AI, laporan, dan audit log sendiri. Data antar tenant dipisahkan di aplikasi dan di database (PostgreSQL Row-Level Security). Platform Admin memilih tenant aktif lewat pemilih Tenant di atas menu samping; anggota tenant masuk lewat halaman login organisasinya sendiri.

Satu orang bisa punya role berbeda di tenant yang berbeda.

Halaman login organisasi

Setiap tenant punya alamat login sendiri: /t/<slug> (lihat kolom Member sign-in page di Platform → Tenants, atau kartu di Team & roles, lalu klik Copy link).

Membuat user manual dan meng-assign ke tenant (Platform Admin)

1. Buka Platform → Users → + Add user. Pilih No organization — assign later untuk membuat akun tanpa akses (tidak ada email yang dikirim), atau langsung pilih tenant dan role.
2. Untuk undangan, centang Send invitation email; hapus centang untuk mendapat link undangan sekali tampil yang Anda bagikan sendiri.
3. Di tabel, klik + Assign to organization pada baris user, pilih tenant dan role, lalu Add. Kotak Email mengirim undangan (akun belum punya password) atau email akses (akun sudah aktif); tanpa centang, akun yang belum aktif mendapat link undangan untuk dibagikan.
4. Satu user bisa di-assign ke beberapa tenant dengan role berbeda. Role diubah lewat dropdown, dan tombol × mencabut akses dari tenant itu.

Mengundang anggota (Superadmin)

1. Buka Team & roles, isi email dan role di Invite a member, lalu klik Send invitation. Platform Admin juga bisa lewat Platform → Users → + Add user, atau mengisi Superadmin pertama saat membuat tenant.
2. Pengguna baru menerima email undangan bermerek tenant (nama, logo, role, alamat login, batas waktu) berisi tombol Accept invitation — berlaku 72 jam, sekali pakai. Setelah membuat password, pengguna langsung masuk ke tenant itu. Pengguna yang sudah punya akun menerima email access granted dengan link login tenant.
3. Resend invite membuat link baru dan membatalkan link sebelumnya — pakai email yang paling baru.
4. Kolom Status menampilkan hasil pengiriman: accepted by mail server (sudah diterima server email; jika tidak ada di inbox, cek folder Spam), email failed beserta alasannya, atau invitation expired.
5. Jika SMTP belum diatur, link undangan ditampilkan sekali di halaman itu — bagikan sendiri lewat saluran yang aman.
6. Role bisa diubah atau anggota dihapus kapan saja. Setiap tenant wajib punya minimal satu Superadmin.

Two-factor authentication (2FA)

Memakai aplikasi authenticator: Google Authenticator, Microsoft Authenticator, 1Password, Bitwarden, atau Authy. Kapan 2FA wajib diatur Platform Admin di Platform → Sign-in security:

Akun yang sudah mengaktifkan 2FA selalu diminta kode walaupun kebijakan tidak mewajibkan. Saat kewajiban dinyalakan, sesi orang yang belum memakai 2FA langsung berakhir dan mereka mendaftar saat login berikutnya. Halaman Adoption menampilkan berapa anggota tiap organisasi yang sudah memakai 2FA. Semua perubahan kebijakan tercatat di Platform audit.

1. Pertama kali: setelah password/Google/undangan, halaman Set up two-factor authentication menampilkan QR code dan setup key. Scan di aplikasi, masukkan kode 6 digit, lalu simpan 10 recovery code (sekali tampil; centang I saved my recovery codes untuk lanjut).
2. Login berikutnya: masukkan kode 6 digit dari aplikasi. Kode yang sama tidak bisa dipakai dua kali.
3. HP hilang: klik Lost your phone? Use a recovery code. Setiap recovery code hanya berlaku sekali. Buat kode baru di My account → Two-factor authentication.
4. Reset: Superadmin tenant bisa klik Reset 2FA di Team & roles (tidak untuk dirinya sendiri atau akun Platform Admin); Platform Admin bisa di Platform → Users. Orang tersebut langsung keluar dari semua sesi dan mendaftar ulang saat login berikutnya. Semua tercatat di audit log.
5. Sesi yang dibuka sebelum 2FA aktif otomatis berakhir, sehingga setiap anggota yang sedang login ikut memakai 2FA.
6. Mematikan 2FA: di My account → Two-factor authentication → Turn off (butuh kode yang berlaku), hanya jika kebijakan tidak mewajibkan untuk akun tersebut.
7. Platform Admin: aktifkan di My account → Two-factor authentication; setelah aktif, login halaman platform juga meminta kode.

Sign in with Google (anggota tenant)

1. Platform Admin menghubungkan Google di Platform → Google sign-in: buat OAuth client tipe Web application di Google Cloud Console, daftarkan Authorized redirect URI yang ditampilkan di halaman itu, lalu isi Client ID dan Client secret (secret dienkripsi dan tidak pernah ditampilkan lagi).
2. Tombol Sign in with Google muncul di halaman login organisasi. Hanya tersedia untuk anggota tenant — tidak ada di halaman platform.
3. Hanya anggota yang sudah terdaftar: email Google yang terverifikasi harus sama dengan email akun di tenant itu. Login Google tidak pernah membuat akun baru.
4. Login Google pertama mengikat akun Google tersebut ke anggota; login berikutnya harus memakai akun Google yang sama.
5. Superadmin dapat mematikan Google atau membatasi ke satu domain Google Workspace di Team & roles → Tenant settings → Sign-in security.
6. Setelah Google, anggota tetap memasukkan kode 2FA.

Four-eyes

Aktifkan di Team & roles → Tenant settings. Aksi berisiko tinggi (reboot node dan create storage) lalu wajib dikonfirmasi oleh Operator atau Superadmin yang berbeda dari pembuat proposal. Aturan ini tidak berlaku selama tenant hanya punya satu anggota yang bisa mengonfirmasi.

Password

• Lupa password: klik Forgot password? di halaman login; link reset berlaku 1 jam dan hanya bisa dipakai sekali. Membutuhkan SMTP yang sudah diatur.
• Ganti password: buka My account. Sesi di perangkat lain otomatis keluar.
• Sesi aktif: My account → Sessions menampilkan setiap perangkat yang sedang login (browser, organisasi, IP, terakhir aktif). Klik Sign out per perangkat atau Sign out other sessions. Logout langsung membatalkan sesi di server, sehingga salinan cookie tidak bisa dipakai lagi. Platform Admin dapat memakai Sign out everywhere di menu Users untuk perangkat yang hilang.
• Password minimal 12 karakter.

Administrasi platform (Platform Admin)

13bqDC (paket resource) & API publik

Dengan qDC, platform menyediakan host Proxmox (standalone atau cluster) lalu menjualnya ke organisasi dalam bentuk paket berisi vCPU, memory, disk, dan jumlah guest. Organisasi tidak perlu membuat koneksi Proxmox sendiri: saat paket di-assign, Proxmox Apps membuat resource pool, user, dan token Proxmox yang hanya bisa mengakses pool, storage, dan bridge paket itu, lalu menambahkan koneksi managed ke organisasi tersebut.

• Token organisasi hanya mendapat PVEVMAdmin di pool-nya sendiri, PVEDatastoreUser di storage paket, PVESDNUser di bridge paket, dan PVETemplateUser di template pool — tidak pernah di / atau /nodes. Subscription lama dirapikan dengan tombol Sync, yang juga menghapus izin yang tidak lagi termasuk paket.
• Isolasi antar customer: setiap customer punya pool sendiri (misalnya qDC_customerA dan qDC_customerB) walaupun berada di node yang sama. Customer tidak melihat node provider sama sekali: di Overview, Operations, API, dan asisten AI, pool-nya tampil sebagai satu node dedicated (misalnya qDC_customerA) dengan kapasitas vCPU, memory, dan disk sesuai paket + add-on. CPU/RAM menunjukkan pemakaian VM customer yang berjalan, disk menunjukkan yang teralokasi. Customer bebas membuat VM sebanyak apa pun selama resource-nya masih tersedia; node asli dipilih otomatis oleh platform (node dengan memory kosong terbanyak). Customer tidak bisa melihat, mengubah, atau membaca snapshot VM milik pool lain, dan task/event hanya milik customer itu sendiri. Nama node, nama host, dan alamat host provider juga disamarkan dari semua respons (ringkasan proposal, error, audit log, chat).
• vRouter per customer: setiap customer qDC memakai VM vRouter miliknya sendiri (dikelola di qDC-Routers), jadi paket qDC sudah termasuk vRouter. Di aplikasi, customer mendapat semua fitur vRouter — Overview, utilization dan resource vRouter, interfaces, firewall, port forwards, IP addresses, dan VPN — persis seperti organisasi Proxmox Dedicated. Yang tetap milik platform hanya koneksinya: customer tidak bisa mengubah alamat/API key atau menghapus koneksi itu, dan tidak pernah melihat vRouter customer lain. Platform mengelola semuanya di qDC → vRouters.
• Snapshot termasuk dalam paket dan gratis: tidak dihitung ke batas disk. Jumlah per VM mengikuti Snapshots per guest di paket.
• Batas dihitung dari semua VM di pool, baik yang berjalan maupun tidak (template dihitung untuk disk). Create VM, Resize disk, dan Restore ditolak bila melebihi paket, dan dicek ulang tepat sebelum dijalankan.
• Pada koneksi qDC, reboot node, create storage, download image, build template, dan perubahan storage backup tidak tersedia karena host dikelola provider.
• Backup: bila provider sudah memberi ruang backup, di menu Package muncul bagian Backups — ruang terpakai dibanding kuota, jumlah backup, dan jadwal yang ditentukan sendiri oleh customer: setiap guest di paket atau hanya yang dipilih, waktunya (02:30, sat 03:00, atau 02:30,14:30), mode snapshot/suspend/stop, email bila gagal, dan tombol untuk membackup satu guest sekarang. Jadwalnya dijalankan provider dengan batasan pool dan storage customer itu, jadi guest milik organisasi lain tidak bisa ikut dibackup.
• Organisasi melihat kartu paket di Overview dan menu Package (rincian paket, add-on, total, terpakai, sisa, snapshot, dan daftar VM). Laporan Package ada di Reports, dan perintah /package di asisten menampilkan ringkasan tanpa perlu AI. Koneksinya di Proxmox connections ditandai managed (tidak bisa diedit atau dihapus).
• AI assistant customer tetap memakai provider AI milik customer (AI settings), dan memahami paket dedicated: sisa resource, add-on, snapshot, dan bahwa node provider tidak bisa diakses.

API publik

Semua fitur di atas, plus data fleet, aksi (propose → confirm), backup, vRouter, laporan, asisten AI, dan pengaturan platform, tersedia lewat REST API di /api/v1 — 167 operasi pada 124 path. Singkatnya: apa pun yang bisa dilakukan lewat konsol, bisa dilakukan lewat API, kecuali empat hal yang sengaja ditutup: 2FA dan sesi milik orang (/account/…), membuat atau mencabut API key (key tidak boleh membuat key), tiket konsol guest, dan stream dashboard.

Cara membuka referensi API (Swagger): dari perangkat yang tersambung VPN provider, buka https://proxmox.ai.id/api/v1/docs — atau dari Platform Admin, menu API & branding → Documentation → Open API reference. Tersedia juga per produk: /api/v1/qdc/docs dan /api/v1/dedicated/docs, masing-masing dengan dokumen OpenAPI 3.1 di /api/v1/openapi.json, /api/v1/qdc/openapi.json, dan /api/v1/dedicated/openapi.json (untuk Postman, Insomnia, atau generator klien).

Dokumentasinya VPN-only. Di luar jaringan provider, /api/v1/docs dan openapi.json dijawab 403 — dijaga dua lapis, di nginx dan di aplikasi. Yang dibatasi hanya dokumentasinya; API-nya sendiri tetap bisa dipanggil dari mana saja selama alamat itu terdaftar pada whitelist key. Jadi customer tetap bisa memakai API dari server mereka, sedangkan daftar lengkap endpoint platform hanya terbaca dari VPN.

• Kirim header Authorization: Bearer <API key>. Key hanya ditampilkan sekali; simpan di secret manager.
• Whitelist IP wajib: setiap key hanya bisa dipakai dari alamat IP yang didaftarkan (alamat tunggal, atau rentang maksimal IPv4 /24 dan IPv6 /48). Dari alamat lain, request ditolak dengan 403 walaupun key-nya benar.
• Setiap key punya masa berlaku, batas request per menit (header X-RateLimit-*, 429 bila terlampaui), dan bisa di-Revoke kapan saja. Key tidak bisa membuat key lain atau mengubah branding.
• Setiap perubahan lewat API tercatat di Audit log dengan actor type api, nama key, alamat klien, dan request id.
• White-label: di Platform → API & branding → Branding, atur nama produk (misalnya ganti “qDC”), judul API, nama perusahaan, email support, website, warna, logo, base URL API, dan pengantar dokumentasi.

14Pemecahan masalah

15Rotasi & pencabutan token

# 1. Cabut token lama (akses langsung berhenti)
pveum user token remove pmxapps@pve dashboard

# 2. Buat token baru; secret baru hanya tampil sekali
pveum user token add pmxapps@pve dashboard --privsep 0

1. Provider membuka Platform → Dedicated-Hosts → Edit… pada host tersebut.
2. Tempel Token secret yang baru; field lain bisa dibiarkan.
3. Simpan; host aktif kembali setelah tes berhasil. Organisasi bisa memastikannya dengan Test connection di Proxmox connections.

Untuk mencabut akses Proxmox Apps sepenuhnya, provider menghapus host di Dedicated-Hosts, lalu jalankan jalankan pveum user delete pmxapps@pve di node.

16Daftar fitur yang tersedia saat ini

Ringkasan semua menu dan fitur Proxmox Apps yang sudah terpasang, beserta status pengujiannya. Bagian ini ditulis dalam Bahasa Indonesia; nama menu dan tombol di aplikasi tetap dalam bahasa Inggris.

Menu aplikasi

Akses & keamanan

Overview (real-time)

Operations

Reports

Storage & disks

AI assistant

Proxmox connections & AI settings

Tampilan

Tenant, akun & audit

Yang direncanakan