Hypothesis (hosting sendiri)

Hypothesis adalah alat anotasi web sumber terbuka. h adalah server yang menjalankannya: menyajikan aplikasi web anotasi dan API anotasi publik. Dengan instance yang dihosting sendiri, Anda dan kolaborator dapat menyorot, menganotasi, dan mendiskusikan halaman web atau PDF apa pun di infrastruktur yang Anda kendalikan.

Template ini men-deploy empat layanan sebagai satu stack sekali klik:

• hypothesis — server h (aplikasi web, API, WebSocket real-time, worker latar belakang)
• postgresql — menyimpan akun, grup, dan anotasi
• elasticsearch — menjalankan pencarian anotasi (memakai build Hypothesis dengan ICU bawaan)
• rabbitmq — message broker untuk worker latar belakang

Memulai

1. Masukkan domain yang ingin Anda gunakan dan klik Deploy.
2. Tunggu keempat layanan selesai di-deploy. Layanan hypothesis menjalankan inisialisasi sekali jalan saat boot pertama (skema database, indeks pencarian, dan akun admin), jadi boot pertamanya butuh beberapa menit — ini normal.
3. Buka domain Anda. Anda akan melihat halaman beranda Hypothesis.

Masuk

Akun administrator dibuat otomatis saat boot pertama:

• Nama pengguna: admin
• Kata sandi: lihat variabel ADMIN_PASSWORD pada layanan hypothesis (tab Variables di dashboard Zeabur)

Masuk di https://DOMAIN_ANDA/login, lalu segera ganti kata sandi ini dari halaman pengaturan akun. Alat administrasi tersedia di https://DOMAIN_ANDA/admin.

Menggunakan domain kustom

"Authority" anotasi dan URL publik diturunkan dari domain pada saat deploy. Jika ingin memakai domain kustom, ikat domain tersebut sebelum deploy pertama, atau bersiaplah untuk men-deploy ulang: mengubah domain setelah akun dan anotasi ada akan membuatnya tetap terikat ke authority lama.

Catatan penting

• Klien anotasi dimuat dari https://cdn.hypothes.is. Ini perilaku bawaan Hypothesis dan menjaga klien tetap mutakhir; data anotasi Anda tetap sepenuhnya berada di instance Anda sendiri.
• Email belum dikonfigurasi. Aktivasi akun dilewati, dan email reset kata sandi tidak akan terkirim kecuali Anda menambahkan variabel lingkungan MAIL_* ke layanan hypothesis.
• Data tersimpan di volume postgresql dan elasticsearch. Layanan hypothesis sendiri bersifat stateless. Jangan hapus volume tersebut.
• Layanan PostgreSQL, Elasticsearch, dan RabbitMQ hanya dapat dijangkau di dalam jaringan privat proyek — khususnya Elasticsearch tidak memiliki autentikasi, jadi jangan mengeksposnya ke publik.

Atribusi & lisensi

Hypothesis (h) dikembangkan oleh Hypothes.is Project dan para kontributor, dirilis di bawah lisensi BSD-2-Clause. Template ini hanya mengemas image Docker resmi hypothesis/hypothesis untuk deployment di Zeabur; tidak berafiliasi dengan atau didukung oleh Hypothes.is Project.

• Kode sumber: https://github.com/hypothesis/h
• Situs web resmi: https://web.hypothes.is/

Catatan rilis

• 2026-05-14: Rilis awal. Berdasarkan hypothesis/hypothesis:20260504-g4d0056f.