Panduan

Sore ini instal,
besok simulasi.

Panduan instalasi lengkap GoCBT — pilih platform Anda, ikuti langkahnya sampai aplikasi jalan.

Instalasi GoCBT di Windows

Panduan lengkap memasang GoCBT di komputer/laptop Windows 10/11 — cocok untuk pemula dan operator sekolah.

Glosarium

Istilah teknis di bawah ini akan sering muncul. Bacalah sekali agar tidak bingung di tengah jalan.

IstilahPenjelasan sederhana
Aplikasi / programPerangkat lunak yang dijalankan, dalam hal ini GoCBT.
File .exe / binaryFile program yang bisa langsung dijalankan dengan klik dua kali.
InstallerProgram pembantu yang memandu pemasangan GoCBT langkah demi langkah.
Web Install WizardHalaman web di browser untuk mengisi pengaturan instalasi (nama sekolah, database, akun admin).
BrowserPeramban internet seperti Chrome, Edge, atau Firefox.
DatabaseTempat penyimpanan semua data (siswa, soal, nilai). GoCBT memakai MySQL/MariaDB atau PostgreSQL.
PortNomor “pintu” koneksi di komputer, misalnya 8080 atau 18080.
DomainAlamat website, misalnya cbt.sekolah.sch.id.
license.keyFile lisensi resmi GoCBT milik sekolah Anda.

Isi paket yang Anda terima

Setelah pembelian, Anda menerima file-file berikut. Simpan semuanya di satu folder yang aman dan jangan dihapus:

Nama fileFungsi
gocbt-install.exeInstaller. Dijalankan pertama kali untuk memandu pemasangan lewat wizard di browser.
gocbt.exeAplikasi utama GoCBT. Dijalankan setiap hari saat aplikasi dipakai ujian.
license.keyFile lisensi resmi untuk sekolah Anda. Satu file untuk satu sekolah, jangan diubah isinya.

File installer (gocbt-install.exe) dan aplikasi utama (gocbt.exe) adalah dua file yang BERBEDA. Installer hanya dipakai saat pemasangan pertama kali, sedangkan gocbt.exe dipakai untuk menjalankan aplikasi sehari-hari.

Yang perlu disiapkan

  • Komputer/laptop Windows 10 atau Windows 11, 64-bit.
  • RAM minimal 4 GB (8 GB lebih nyaman untuk ujian banyak peserta).
  • Koneksi internet (untuk mengunduh dan aktivasi awal).
  • File-file GoCBT: gocbt-install.exe, gocbt.exe, dan license.key.
  • Waktu sekitar 30–60 menit.

Langkah 1 — Pilih dan siapkan database

GoCBT menyimpan semua data (siswa, soal, nilai) di database. Anda bebas memilih SALAH SATU dari dua jenis berikut — keduanya didukung penuh. Tabel di bawah membantu Anda memutuskan:

AspekMySQL / MariaDBPostgreSQL
Kemudahan instalasiSangat mudah — sudah termasuk di Laragon/XAMPP, sekali klik jalan.Perlu installer terpisah + pengaturan awal.
Cocok untukSekolah, pemula, ujian hingga ratusan siswa.Data besar, ribuan siswa, atau yang sudah terbiasa.
Performa ujianCukup untuk ujian sekolah biasa.Lebih baik untuk beban berat / query kompleks.
Ketepatan waktuPresisi detik (cukup untuk ujian).Presisi mikrodetik (lebih akurat).
Backup dataMudah via HeidiSQL / phpMyAdmin.Mudah via pgAdmin.
Kebutuhan RAMLebih ringan untuk VPS kecil (1–2 GB).Butuh RAM sedikit lebih besar.

Rekomendasi: pemula atau sekolah biasa pilih MySQL/MariaDB (Pilihan 1) — paling mudah dan sudah terbukti untuk ratusan siswa. Pilih PostgreSQL (Pilihan 2) jika Anda sudah terbiasa atau mengelola data sangat besar.

Cukup pilih SATU: ikuti “Pilihan 1” ATAU “Pilihan 2” di bawah ini. Tidak perlu menginstal keduanya.

Pilihan 1 — MySQL / MariaDB (disarankan untuk pemula)

Gunakan Laragon atau XAMPP (keduanya gratis dan sudah berisi MySQL/MariaDB siap pakai).

Opsi A — Laragon (disarankan):

  1. 1Unduh Laragon dari situs resminya (laragon.org), lalu install seperti program biasa (klik Next sampai selesai).
  2. 2Buka Laragon, klik tombol “Start All”. Tunggu sampai layanan Apache dan MySQL tertulis “Running” (berwarna hijau).
  3. 3Buat database kosong: di jendela Laragon klik tombol “Database” (membuka HeidiSQL). Di panel kiri, klik kanan > Create new > Database, beri nama: gocbt lalu OK.
  4. 4Catat baik-baik: host = localhost, port = 3306, nama database = gocbt, username = root, password = (kosongkan).

Opsi B — XAMPP:

  1. 1Unduh XAMPP untuk Windows dari situs resminya (apachefriends.org), lalu install seperti program biasa.
  2. 2Buka XAMPP Control Panel dari menu Start.
  3. 3Pada baris “MySQL”, klik tombol Start. Tunggu sampai tertulis “Running”.
  4. 4Buat database kosong: pada baris MySQL klik tombol Admin (browser membuka phpMyAdmin). Klik menu “Databases”, pada kolom “Create database” ketik: gocbt lalu klik Create.
  5. 5Catat baik-baik: host = localhost, port = 3306, nama database = gocbt, username = root, password = (kosongkan).

Biarkan Laragon/XAMPP tetap terbuka dan layanan database berstatus Running selama GoCBT dipakai. Jika MySQL tidak mau Start (biasanya port 3306 dipakai program lain), tutup program tersebut atau hubungi tim support GoCBT.

Pilihan 2 — PostgreSQL

Opsi A — Installer resmi PostgreSQL (paling mudah):

  1. 1Unduh installer PostgreSQL untuk Windows dari postgresql.org/download/windows.
  2. 2Jalankan installer, ikuti langkahnya (klik Next). Saat diminta password untuk user “postgres”, buat password yang kuat dan CATAT baik-baik.
  3. 3Port biarkan bawaan: 5432. Komponen lain biarkan bawaan, klik Next sampai selesai.
  4. 4Buka “pgAdmin” dari menu Start, login dengan password yang tadi dibuat.
  5. 5Buat database kosong: di panel kiri klik kanan “Databases” > Create > Database, beri nama: gocbt lalu Save.
  6. 6Catat baik-baik: host = localhost, port = 5432, nama database = gocbt, username = postgres, password = (yang Anda buat tadi).

Opsi B — Laragon + PostgreSQL:

  1. 1Laragon juga mendukung PostgreSQL sebagai layanan tambahan. Buka menu Laragon > PostgreSQL, lalu ikuti petunjuk untuk menambahkan PostgreSQL.
  2. 2Setelah terpasang, klik “Start All” agar layanan PostgreSQL ikut berjalan.
  3. 3Buat database kosong bernama gocbt lewat HeidiSQL (tombol “Database” di Laragon).
  4. 4Catat: host = localhost, port = 5432, nama database = gocbt, username = postgres, password = (sesuai yang Anda atur).

Data database yang Anda catat (nama database, username, password, port) akan dipakai untuk mengisi wizard instalasi di Langkah 4.

Langkah 2 — Siapkan folder & file

  1. 1Buat folder baru, misalnya di C:\gocbt (atau D:\gocbt jika ingin di drive lain).
  2. 2Salin (copy) ketiga file ke dalam folder tersebut: gocbt-install.exe, gocbt.exe, dan license.key.
  3. 3Pastikan ketiga file berada dalam SATU folder yang sama.
  4. 4Catatan: GoCBT memakai tata letak portable — file .env, folder uploads/, dan backups/ otomatis dibuat di folder yang SAMA dengan file gocbt.exe. Jadi jangan pindahkan file-nya setelah instalasi.

Langkah 3 — Jalankan installer & buka wizard

  1. 1Klik kanan file gocbt-install.exe, pilih “Run as administrator”. Jika muncul peringatan Windows, klik “More info” lalu “Run anyway”.
  2. 2Akan muncul jendela hitam (command prompt). JANGAN ditutup. Perhatikan tulisan di dalamnya: ada alamat (URL) yang harus dibuka di browser, biasanya http://localhost:18080
  3. 3Buka Chrome / Edge, ketik alamat tersebut persis seperti yang tertulis, lalu tekan Enter.
  4. 4Halaman Web Install Wizard akan terbuka dan memandu 6 langkah instalasi.

Kode keamanan (token) wizard hanya berlaku 60 menit sejak installer dijalankan. Jika kedaluwarsa, tutup jendela hitam installer lalu jalankan lagi gocbt-install.exe dari awal.

Langkah 4 — Isi wizard instalasi

Ikuti penjelasan lengkap tiap langkah wizard di bagian “Web Install Wizard”. Untuk isian database, gunakan data yang Anda catat di Langkah 1:

Kolom di wizardJika pakai MySQL / MariaDBJika pakai PostgreSQL
Tipe databaseMySQL / MariaDBPostgreSQL
Hostlocalhostlocalhost
Port33065432
Nama databasegocbtgocbt
Usernamerootpostgres
Password(kosongkan)(yang Anda buat saat instalasi)

Klik tombol “Tes Koneksi”. Lanjut hanya jika tes berhasil. Jika gagal, pastikan layanan database berstatus Running (kembali ke Langkah 1).

Langkah 5 — Pasang file lisensi

Ada dua cara memasang license.key:

Cara 1 — Otomatis (paling mudah)

File license.key sudah berada di folder yang sama dengan gocbt.exe (Langkah 2), jadi biasanya otomatis terbaca. Jika belum, tutup dan jalankan ulang aplikasinya.

Cara 2 — Lewat panel admin

  1. 1Login sebagai admin ke aplikasi GoCBT.
  2. 2Buka menu Lisensi.
  3. 3Unggah (upload) file license.key, lalu simpan.
AturanKeterangan
Satu file untuk satu sekolahHanya berlaku untuk sekolah yang tertera di dalamnya.
Jangan diubah isinyaMengedit isi file akan merusaknya sehingga tidak terbaca.
Jangan disebarluaskanFile ini adalah bukti pembelian resmi sekolah Anda.

Langkah 6 — Jalankan aplikasi & login

  1. 1Tutup jendela hitam installer (wizard sudah selesai).
  2. 2Klik dua kali file gocbt.exe. Akan muncul jendela hitam baru — ini jendela aplikasinya. JANGAN ditutup selama aplikasi dipakai.
  3. 3Buka browser, ketik: http://localhost:8080 lalu tekan Enter.
  4. 4Halaman login GoCBT terbuka. Masuk dengan username dan password admin yang Anda buat di wizard.

Saat pertama menjalankan gocbt.exe, Windows Firewall biasanya bertanya “Allow access?”. Centang kedua kotak (Private dan Public) lalu klik “Allow access” agar komputer lain bisa membuka aplikasi lewat jaringan.

Pemakaian harian

  • Pastikan Laragon/XAMPP terbuka dan layanan database (MySQL/PostgreSQL) berstatus Running.
  • Klik dua kali gocbt.exe, biarkan jendela hitamnya terbuka (boleh di-minimize, jangan di-close).
  • Buka browser ke http://localhost:8080 untuk memakai aplikasi.
  • Komputer lain di jaringan sekolah bisa membuka lewat http://IP-komputer-ini:8080 (IP komputer bisa dilihat di pengaturan WiFi/LAN).
  • Tips: buat shortcut gocbt.exe di Desktop agar mudah ditemukan (klik kanan > Send to > Desktop).

Web Install Wizard — 6 langkah detail

Langkah 1 — Pemeriksaan Sistem

Wizard memeriksa kesiapan komputer (sistem operasi, hak akses, koneksi database). Pastikan semua item bertanda hijau. Jika ada yang merah, perbaiki dulu sesuai pesan yang tampil.

Langkah 2 — Domain & Institusi

  • Domain / alamat akses: untuk komputer lokal, biarkan bawaan (localhost/IP).
  • Nama institusi: nama sekolah Anda, misalnya “SMAN 1 Bantul”.
  • Jenis institusi: pilih “Sekolah” atau “Kampus” — mengatur istilah yang tampil di aplikasi (“Siswa” vs “Mahasiswa”).

Langkah 3 — Koneksi Database

  • Tipe database: “MySQL / MariaDB” atau “PostgreSQL” (sesuai yang Anda siapkan).
  • Host: localhost. Port: 3306 (MySQL) atau 5432 (PostgreSQL).
  • Nama database, username, password: sesuai yang Anda buat sebelumnya.
  • Klik “Tes Koneksi”. Lanjut hanya jika berhasil.

Database harus sudah dibuat SEBELUM mengisi langkah ini. Wizard hanya mengetes koneksi, tidak membuatkan database.

Langkah 4 — Redis & Akun Admin

  • Redis: boleh dikosongkan jika tidak dipakai. Aplikasi tetap berjalan normal.
  • Buat username dan password admin yang kuat, lalu CATAT di tempat aman. Inilah akun login pertama Anda.

Langkah 5 — Layanan Sistem Otomatis

Langkah ini hanya tersedia di Linux yang dijalankan sebagai root. Di Windows tidak tersedia — lewati saja, tidak masalah.

Langkah 6 — Ringkasan Instalasi

  1. 1Periksa kembali semua isian: nama sekolah, database, dan akun admin.
  2. 2Klik “Install” dan tunggu sampai muncul “Instalasi Berhasil!”. Jangan menutup atau me-refresh tab browser.

Login pertama & persiapan ujian

  1. 1Buka http://localhost:8080 di browser dan login sebagai admin.
  2. 2Lengkapi profil sekolah di menu Pengaturan.
  3. 3Buat tahun ajaran/semester yang aktif.
  4. 4Masukkan data siswa (bisa lewat import file Excel).
  5. 5Buat bank soal dan jadwal ujian, lalu simulasi dengan 1–2 siswa sebelum ujian sesungguhnya.

Selalu lakukan simulasi kecil sebelum hari-H ujian agar panitia terbiasa dengan alurnya.

Mengatasi masalah

GejalaPenyebab & solusi
Halaman wizard tidak terbukaInstaller belum dijalankan / alamat salah ketik. Pastikan jendela hitam installer masih terbuka dan alamat diketik persis seperti yang tertulis.
Pesan “token kedaluwarsa”Sudah lebih dari 60 menit sejak installer dijalankan. Tutup installer lalu jalankan ulang gocbt-install.exe.
Tes koneksi database gagalDatabase belum dibuat / username-password salah / layanan database belum Running. Periksa kembali Langkah 1.
Ingin instal ulang dari awalInstaller menolak jika file .env sudah ada. Hapus file .env di folder aplikasi, atau jalankan: gocbt-install.exe --force
Lupa password adminHubungi tim support GoCBT dengan bukti pembelian. Jangan membuat database baru karena data akan hilang.
Komputer lain tidak bisa membuka aplikasiWindows Firewall memblokir. Klik “Allow access” saat pertama menjalankan gocbt.exe. Pastikan satu jaringan (WiFi/LAN) yang sama.
Aplikasi mati sendiriJendela hitam gocbt.exe tertutup. Jalankan lagi dan biarkan jendelanya terbuka (boleh di-minimize).

Tanya jawab

Apakah bisa dipasang di hosting murah (shared hosting)?

Tidak bisa. GoCBT harus berjalan sebagai program yang menyala terus, sedangkan shared hosting biasa tidak mengizinkannya. Gunakan komputer Windows sendiri atau VPS.

Apakah komputer harus selalu menyala dan terkoneksi internet?

Komputer harus menyala selama ujian berlangsung. Untuk ujian di jaringan lokal sekolah (WiFi/LAN), internet tidak wajib saat ujian berjalan. Internet dibutuhkan saat instalasi dan aktivasi lisensi.

Berapa banyak peserta yang bisa ditangani?

Tergantung spesifikasi. Komputer standar (4 GB RAM) nyaman untuk ratusan peserta bersamaan. Untuk ribuan peserta, gunakan RAM 8 GB atau lebih.

Apakah data aman?

Ya. Seluruh data tersimpan di database milik Anda sendiri. Rutin lakukan backup, terutama sebelum ujian besar, lewat menu Backup di panel admin.

Ganti komputer, apakah lisensi hangus?

Tidak. File license.key dapat dipindahkan ke komputer baru (satu lisensi untuk satu sekolah).

Mentok di salah satu langkah? Instalasi pertama didampingi gratis.

Chat tim kami