Panduan Lengkap Install Outline Wiki dengan Docker

Outline adalah platform basis pengetahuan (knowledgebase) berbasis open-source yang sangat mumpuni dan sering dianggap sebagai alternatif Notion yang lebih ringan. Platform ini menawarkan fitur kolaborasi waktu nyata untuk tim, editor berbasis Markdown yang rapi, serta organisasi dokumen yang sangat intuitif.

Melalui tutorial ini, Anda akan belajar cara melakukan instalasi (self-hosting) Outline Wiki di server Anda sendiri menggunakan container Docker. Pada akhir panduan ini, Anda akan memiliki platform dokumentasi canggih yang berjalan mandiri dan aman, lengkap dengan konfigurasi penyimpanan dan basis datanya.

Langkah 1: Persiapan Server dan Instalasi Docker

Langkah pertama adalah memperbarui sistem operasi server Anda dan memastikan bahwa Docker serta Docker Compose telah terinstal dengan benar.

sudo apt update && sudo apt upgrade -y
sudo apt install docker.io docker-compose-v2 -y

Catatan: Tutorial ini berasumsi Anda menggunakan distribusi berbasis Linux seperti Debian atau Ubuntu 22.04.

Langkah 2: Membuat Direktori dan Secret Key

Anda perlu membuat direktori kerja khusus dan menghasilkan kunci rahasia (secret keys) menggunakan OpenSSL untuk mengamankan sesi aplikasi Outline Anda.

mkdir -p /opt/outline
cd /opt/outline
openssl rand -hex 32

Langkah 3: Konfigurasi Environment (File .env)

Buat file .env yang akan menyimpan konfigurasi krusial seperti pengaturan URL, kredensial database PostgreSQL, Redis, penyimpanan S3/Minio, dan integrasi autentikasi OIDC (seperti Slack atau Google).

nano .env
# Masukkan parameter SECRET_KEY dan UTILS_SECRET dari output OpenSSL sebelumnya

Catatan: Outline merupakan aplikasi cloud-native yang mensyaratkan autentikasi eksternal (SSO/OIDC) dan tidak memiliki sistem login lokal bawaan.

Langkah 4: Membuat Konfigurasi Docker Compose

Susun layanan Outline, PostgreSQL, dan Redis ke dalam satu file docker-compose.yml agar semua komponen dapat dikelola dan terhubung dalam satu jaringan yang sama.

nano docker-compose.yml
# Definisikan image docker.getoutline.com/outlinewiki/outline, database postgres, dan redis di sini

Langkah 5: Menyesuaikan Izin Akses Direktori

Karena Outline menggunakan user khusus (umumnya nodejs) di dalam container, Anda harus memberikan izin kepemilikan pada direktori instalasi agar aplikasi tidak mengalami kendala error 502 atau gagal mengunggah berkas.

sudo chown -R 1001:1001 /opt/outline

Langkah 6: Menjalankan Kontainer Docker

Setelah semua persiapan environment dan Docker Compose selesai, Anda dapat menjalankan seluruh stack aplikasi Outline di latar belakang.

docker-compose up -d

Catatan: Pastikan Anda juga telah mengatur reverse proxy (seperti Nginx atau Caddy) untuk menangani sertifikat SSL/HTTPS ke port Outline Anda.

Langkah 7: Uji Coba dan Verifikasi Instalasi

Buka peramban web dan akses nama domain yang telah Anda konfigurasi (misalnya https://docs.domainanda.com). Cobalah masuk (login) menggunakan metode autentikasi OIDC pilihan Anda (seperti Slack), lalu buat sebuah dokumen baru dan unggah gambar untuk memastikan koneksi ke penyimpanan objek S3/lokal berfungsi dengan sempurna.

Selamat! Anda telah berhasil membangun dan mengonfigurasi server Outline Wiki secara mandiri untuk menunjang produktivitas dan kolaborasi tim Anda.