Cara Instal dan Setup Point Arsip dari Nol

Posted on
Panduan instalasi Point Arsip dari nol: setup backend Apps Script, konfigurasi frontend, login pertama, hingga keamanan akun.

PoinTru.com – Salah satu hal yang bikin Saya langsung jatuh hati denganPoint Arsip adalah proses instalasinya yang jauh lebih simpel dari yang dibayangkan. Tidak ada server Linux yang harus dikonfigurasi, tidak ada perintah terminal yang menakutkan, tidak ada domain khusus yang harus dibeli. Cukup akun Google yang aktif, dan Anda bisa mulai dalam waktu kurang dari satu jam.

Di artikel ini, Saya akan walk through proses instalasi dan setup Point Arsip dari nol secara detail. Panduan ini ditujukan bahkan bagi Anda yang belum pernah bersentuhan dengan Google Apps Script sebelumnya. Selama Anda bisa mengikuti langkah demi langkah, pasti berhasil.

Persiapan Sebelum Instalasi

Sebelum memulai, pastikan Anda sudah menyiapkan beberapa hal berikut:

  • Akun Google yang aktif (Gmail biasa sudah cukup)
  • FileCode.gs berisi kode backend Point Arsip
  • Fileindex.html berisi antarmuka frontend Point Arsip
  • Browser modern (Chrome, Firefox, atau Edge versi terbaru)
  • Koneksi internet yang stabil

Tidak perlu modal lebih dari itu. Tidak ada software tambahan yang perlu diinstal di komputer Anda. Semua prosesnya terjadi di browser.

Yang Dibutuhkan Keterangan Biaya
Akun Google Untuk Apps Script, Sheets, Drive Gratis
File Code.gs Kode backend Point Arsip Sudah tersedia
File index.html Antarmuka frontend Point Arsip Sudah tersedia
Browser Chrome/Firefox/Edge versi terbaru Gratis

Langkah 1 – Setup Backend Google Apps Script

Ini adalah langkah paling penting karena di sinilah “otak” dari Point Arsip tinggal. Ikuti langkah-langkah ini dengan teliti:

  • Buka script.google.com di browser Anda dan login dengan akun Google yang akan digunakan
  • Klik tombol “New Project” untuk membuat project Apps Script baru. Beri nama project yang mudah diingat, misalnya “Point Arsip Backend”
  • Hapus kode bawaan yang ada di editor (biasanya berisi fungsimyFunction() yang kosong)
  • Buka file Code.gs yang sudah Anda miliki, salin seluruh isinya, lalu paste ke editor Apps Script
  • Klik tombol Save (ikon disket atau Ctrl+S) untuk menyimpan kode
  • Klik menu “Deploy” > “New Deployment” di bagian atas halaman
  • Klik ikon roda gigi di dialog yang muncul, lalu pilih “Web App”
  • Atur “Execute as: Me” dan“Who has access: Anyone” – kedua pengaturan ini wajib sesuai
  • Klik “Deploy” dan ikuti alur otorisasi yang muncul. Google akan meminta izin akses ke Drive dan Sheets atas nama Anda-klik “Authorize access” dan izinkan semua
  • Salin Web App URL yang ditampilkan setelah deploy berhasil. URL ini terlihat seperti:https://script.google.com/macros/s/AKfyc.../exec
Jangan tutup halaman sebelum menyalin Web App URL! URL ini adalah kunci koneksi antara frontend dan backend Point Arsip. Simpan di tempat aman seperti catatan atau password manager.

Langkah 2 – Setup Frontend dan Login Pertama

Setelah backend siap, saatnya menyiapkan sisi frontend yang akan Anda gunakan sehari-hari:

  • Buka file index.html yang sudah Anda miliki langsung di browser (bisa dengan dobel klik file tersebut, atau drag-drop ke browser)
  • Pada halaman login, Anda akan melihat kolom “URL Cloud Apps Script”. Masukkan Web App URL yang sudah Anda salin di Langkah 1
  • Masukkan kredensial default: Usernameadmin dan Passwordadmin123
  • Klik tombol “Masuk” dan tunggu beberapa detik

Saat pertama kali melakukan request, sistem Point Arsip akan secara otomatis membuat semua infrastruktur yang dibutuhkan di balik layar: Google Sheet database dengan semua sheet yang diperlukan (USERS, DATA_SURAT, DATA_ARSIP, dll) dan folder Google Drive untuk penyimpanan file. Anda tidak perlu setup apapun secara manual!

Oh iya, satu hal yang perlu Anda ketahui: setelah URL berhasil disimpan dan login pertama berhasil, di sesi berikutnya kolom input URL tidak akan muncul lagi secara otomatis. Itu karena URL sudah tersimpan di browser. Kalau suatu saat perlu menggantinya, ada tautan “Ubah Server” kecil di bawah status koneksi.

Saat ini URL Web App disimpan di localStorage browser Anda. Artinya URL hanya tersimpan di browser dan perangkat yang sama. Jika Anda membuka index.html di perangkat lain, Anda perlu memasukkan URL kembali saat pertama kali.

Langkah 3 – Keamanan Pertama: Ganti Password Default

Langkah ini wajib dilakukan sebelum Anda mulai menggunakan aplikasi secara aktif. Kredensial default admin/admin123 adalah kombinasi yang sangat mudah ditebak dan berpotensi disalahgunakan jika aplikasi Anda diakses orang lain.

  • Setelah login berhasil, klik menu“Sistem” (ikon ️) di navigasi
  • Di bagian“Ubah Password”, masukkan password lama (admin123) dan password baru pilihan Anda
  • Klik“Perbarui Password” dan tunggu konfirmasi berhasil
  • Keluar dari aplikasi dan login ulang menggunakan password baru untuk memastikan perubahan berhasil

Langkah 4 – Konfigurasi ImageKit (Opsional)

Jika Anda berencana menyimpan banyak foto dokumen sebagai foto bukti arsip, sangat direkomendasikan untuk mengonfigurasi ImageKit CDN. Ini akan mengompresi gambar secara otomatis dan menghemat storage Google Drive Anda secara signifikan.

  • Daftar akun gratis di imagekit.io (tidak butuh kartu kredit)
  • Dapatkan Public Key, Private Key, dan URL Endpoint dari dashboard ImageKit
  • Di aplikasi Point Arsip, buka menu Sistem
  • Di bagian “Pengaturan ImageKit CDN”, isi detail untuk Akun CDN 1 (Utama)
  • Opsional: isi juga Akun CDN 2 (Cadangan) sebagai backup
  • Klik “Simpan Konfigurasi”
Berapa lama proses instalasi Point Arsip dari awal?
Jika semua file sudah tersedia dan Anda mengikuti panduan dengan teliti, proses instalasi biasanya selesai dalam 15-30 menit. Waktu terlama biasanya dihabiskan di proses otorisasi Google Apps Script yang kadang perlu beberapa klik konfirmasi.
Apakah Web App URL bisa berubah setelah deployment?
URL akan berubah jika Anda membuat “New Deployment” baru. Untuk menghindari URL berubah setiap update kode, gunakan opsi “Update existing deployment” di Google Apps Script. Dengan begitu, URL tetap sama meski kode backend sudah diperbarui.
Apa yang terjadi jika saya membuka index.html di perangkat berbeda?
Anda perlu memasukkan Web App URL kembali di perangkat baru tersebut, karena URL disimpan di localStorage browser masing-masing perangkat. Setelah URL dimasukkan dan login berhasil, URL akan tersimpan untuk sesi berikutnya di perangkat yang sama.

Akhir Kata

Jadi, intinya instalasi Point Arsip terdiri dari empat langkah utama: deploy backend Apps Script, setup frontend dan login pertama, ganti password default, dan konfigurasi ImageKit opsional. Dari pengalaman Saya, seluruh prosesnya sangat manageable bahkan bagi yang baru pertama kali bersentuhan dengan Google Apps Script. Kalau ada pertanyaan, feel free buat komen di bawah ya!

Untuk membaca artikel lainnya, cek aja diSitemap.

Leave a Reply

Your email address will not be published. Required fields are marked *