Cara Self-Host Planka dengan Docker Compose di VPS
Panduan lengkap deploy Planka menggunakan Docker Compose, Postgres, dan Traefik. Pelajari konfigurasi admin bootstrap serta pengaturan BASE_URL agar login tidak gagal.
Apa yang Anda dapatkan dengan melakukan self-hosting Planka
Melakukan self-hosting Planka memberikan tim Anda papan Kanban dengan model kartu, daftar, dan label yang sudah dikenal orang dari Trello, yang berjalan di VPS yang Anda kendalikan. Tidak ada batasan jumlah pengguna dan tidak ada penagihan per pengguna, karena satu-satunya biaya adalah server. Panduan ini men-deploy-nya dengan Docker Compose di belakang Traefik, menggunakan Postgres untuk data dan named volume untuk setiap file yang diunggah pengguna.
Planka 2 dirilis di bawah Fair Use License milik proyek tersebut, yang dideskripsikan oleh proyek sebagai source-available, bukan open source. Menjalankannya untuk proyek internal organisasi Anda sendiri diperbolehkan. Menawarkannya kepada pihak ketiga sebagai layanan hosting komersial memerlukan lisensi Pro atau Enterprise.
Pembaca yang saya targetkan adalah tim beranggotakan dua hingga lima orang yang meninggalkan paket gratis Trello. Jika Anda masih memutuskan papan mana yang akan digunakan, baca perbandingan alternatif Trello yang di-self-host terlebih dahulu. Panduan ini mengasumsikan pilihan sudah dibuat dan hanya mencakup proses deploy.
Anda memerlukan VPS yang menjalankan Docker Engine dengan plugin Compose, serta record DNS A yang mengarah ke VPS tersebut. Anda juga memerlukan instance Traefik yang sudah melakukan TLS (transport layer security) termination di server tersebut. Jika Traefik belum ada, siapkan reverse proxy Traefik di depan beberapa aplikasi Compose terlebih dahulu, dan baca dasar-dasar Docker Compose untuk VPS jika file di bawah ini terlihat asing.
Seberapa besar VPS yang dibutuhkan Planka?
FAQ teknis proyek merekomendasikan RAM minimal 2 GB dan penyimpanan 10 GB untuk tim kecil. Gunakan angka tersebut sebagai titik awal, bukan sebagai hasil pengukuran.
Komponen yang berjalan sebenarnya ringan: satu proses Node.js yang melayani API dan frontend yang telah dibangun, serta server Postgres yang menyimpan data. Postgres menjalankan satu proses pengawas dan satu proses backend untuk setiap koneksi yang terbuka. Proses proxy kecil juga berjalan di dalam container Planka untuk memfilter request keluar. Paket 2 GB sesuai dengan rekomendasi RAM proyek untuk tim kecil. Board tidak membutuhkan banyak resource. Namun, jika VPS yang sama juga akan menyimpan dokumen tim, tentukan ukuran VPS berdasarkan aplikasi tersebut terlebih dahulu: menjalankan AFFiNE sebagai workspace bergaya Notion memerlukan beberapa gigabyte sendiri sebelum Planka menggunakan resource apa pun.
Tentukan ukuran disk sebelum ukuran memori, karena attachment adalah komponen yang paling cepat bertambah. Ukur instance Anda sendiri dan jangan hanya mengandalkan paragraf ini:
docker stats --no-stream
docker system df -vPerintah pertama menampilkan penggunaan memori dan CPU setiap container secara langsung. Perintah kedua menunjukkan kapasitas yang digunakan setiap volume. Ambil kedua hasil tersebut setelah minggu kerja normal, bukan pada hari instalasi, karena board yang tidak aktif tidak memberikan gambaran tentang kebutuhan tim Anda.
Tulis file Compose
Buat direktori tersebut dan ambil alih kepemilikannya agar Anda tidak perlu mengedit file ini melalui sudo.
sudo mkdir -p /opt/planka
sudo chown "$USER":"$USER" /opt/planka
cd /opt/plankaBuat secret ke dalam file .env di samping file Compose. Compose membaca file tersebut secara otomatis dan mengganti nilainya.
umask 077
{
printf 'SECRET_KEY=%s\n' "$(openssl rand -hex 64)"
printf 'POSTGRES_PASSWORD=%s\n' "$(openssl rand -hex 24)"
printf 'ADMIN_PASSWORD=%s\n' "$(openssl rand -hex 12)"
} > .env
chmod 600 .envopenssl rand -hex digunakan secara sengaja. String heksadesimal hanya berisi digit dan huruf a hingga f, sehingga tidak dapat merusak string koneksi DATABASE_URL tempat string tersebut ditempelkan. Base64 standar dapat berisi garis miring, tanda plus, dan tanda sama dengan sebagai padding, tetapi tidak pernah berisi tanda at; karakter yang memiliki arti khusus dalam URL koneksi harus diberi percent-encoding. Pola yang lebih luas dibahas dalam menyimpan secret di luar file Compose.
Sekarang docker-compose.yml. Ganti kanban.example.com dengan hostname Anda sendiri pada kedua tempat kemunculannya.
services:
planka:
image: ghcr.io/plankanban/planka:2.2.1
restart: unless-stopped
volumes:
- planka-data:/app/data
environment:
- BASE_URL=https://kanban.example.com
- DATABASE_URL=postgresql://planka:${POSTGRES_PASSWORD}@postgres/planka
- SECRET_KEY=${SECRET_KEY}
- TRUST_PROXY=true
- DEFAULT_ADMIN_EMAIL=you@example.com
- DEFAULT_ADMIN_PASSWORD=${ADMIN_PASSWORD}
- DEFAULT_ADMIN_NAME=Your Name
- DEFAULT_ADMIN_USERNAME=admin
networks:
- proxy
- internal
labels:
- "traefik.enable=true"
- "traefik.docker.network=proxy"
- "traefik.http.routers.planka.rule=Host(`kanban.example.com`)"
- "traefik.http.routers.planka.entrypoints=websecure"
- "traefik.http.routers.planka.tls.certresolver=default"
- "traefik.http.services.planka.loadbalancer.server.port=1337"
depends_on:
postgres:
condition: service_healthy
postgres:
image: postgres:16-alpine
restart: unless-stopped
volumes:
- db-data:/var/lib/postgresql/data
environment:
- POSTGRES_DB=planka
- POSTGRES_USER=planka
- POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
networks:
- internal
healthcheck:
test: ["CMD-SHELL", "pg_isready -U planka -d planka"]
interval: 10s
timeout: 5s
retries: 5
volumes:
planka-data:
db-data:
networks:
proxy:
external: true
internal:Empat keputusan dalam file tersebut perlu dijelaskan karena biasanya orang mengubahnya lalu menyesal.
- Tidak ada blok
ports:pada service Planka. Traefik menjangkau container melalui networkproxy, sehingga port 1337 tidak pernah dipublikasikan pada host. Mempublikasikan port tersebut akan memberi siapa pun cara untuk melewati proxy dan sertifikat Anda. loadbalancer.server.port=1337menentukan port di dalam container. Planka listen pada 1337, sedangkan contoh upstream hanya dapat menjangkaunya pada 3000 karena port tersebut dipetakan ke host. Tidak ada pemetaan host di sini, sehingga Traefik harus diberi tahu port container.condition: service_healthydigunakan bersama healthcheck Postgres. Tanpa pengaturan ini, Planka start sebelum database menerima koneksi, gagal menjalankan query pertamanya, lalu exit. Kondisi tersebut terlihat seperti crash loop. Mekanismenya dibahas dalam healthcheck Compose dan pengurutan startup.- Service database sengaja diberi nama
postgres. Planka 2 meneruskan request keluar melalui filter internal yang daftar blokir default-nya adalahlocalhost,postgres. Jika service diganti namanya, database Anda secara diam-diam dihapus dari daftar tersebut.
Periksa apakah Compose dapat melihat secret Anda sebelum menjalankan apa pun:
docker compose config | grep -E 'image:|BASE_URL|POSTGRES_USER'Perintah tersebut mencetak file dengan nilai .env yang sudah diganti. Nilai kosong berarti Compose tidak membaca file .env, biasanya karena Anda menjalankan perintah dari direktori yang berbeda.
Fungsi sebenarnya variabel bootstrap admin
Sejak Planka 1.13, tidak ada administrator yang dibuat secara otomatis, sehingga database baru tidak memiliki pengguna yang dapat login. Grup DEFAULT_ADMIN_* adalah salah satu dari dua cara untuk mengatasinya.
Saat dimulai, Planka mencari pengguna yang cocok dengan DEFAULT_ADMIN_EMAIL. Jika tidak ada, Planka membuat pengguna tersebut menggunakan password, nama tampilan, dan username yang ditetapkan bersamanya. Pada proses start berikutnya, Planka juga memperbarui akun yang cocok berdasarkan variabel ini, termasuk mereset password-nya jika DEFAULT_ADMIN_PASSWORD masih ditetapkan.
DEFAULT_ADMIN_EMAIL memiliki fungsi kedua yang sering mengecoh pengguna. Selama variabel ini tetap ditetapkan, nama, role, atau alamat email akun yang disebutkan tidak dapat diubah dan akun tersebut tidak dapat dihapus melalui antarmuka. Ini adalah perlindungan terhadap penguncian akun. Hal ini juga menyebabkan Anda tidak dapat mengganti nama akun atau mengubah alamat emailnya melalui UI. Hapus variabel tersebut dan lakukan restart. Akun itu kemudian menjadi admin biasa yang dapat Anda edit seperti akun lainnya.
Baris password perlu diperhatikan. Apa pun yang berada di bawah environment: dapat dibaca oleh siapa pun yang dapat menjalankan docker inspect pada container, sehingga DEFAULT_ADMIN_PASSWORD tidak boleh berada di sana secara permanen. Login, hapus baris tersebut, jalankan docker compose up -d lagi, lalu ubah password Anda melalui antarmuka.
Cara yang lebih aman sama sekali tidak menggunakan variabel tersebut. Beri komentar pada seluruh grup DEFAULT_ADMIN_*, lalu buat akun secara interaktif:
docker compose run --rm planka npm run db:create-admin-userPerintah tersebut meminta email, password, nama tampilan, dan username opsional, lalu langsung menulis pengguna ke database. Password tidak pernah masuk ke file Compose atau environment yang dikonfigurasi untuk container. Gunakan cara ini jika lebih dari satu orang memiliki akses shell ke VPS. Perintah tersebut memulai Postgres terlebih dahulu karena depends_on, sehingga dapat digunakan pada stack yang belum pernah dijalankan.
Kedua cara tersebut berarti Anda tetap mengelola password Planka secara manual. Hingga versi 2.1.1, edisi Community dapat menyerahkan proses login kepada penyedia OIDC seperti Authentik yang berjalan sebagai server single sign-on milik Anda sendiri, tetapi versi 2.2.0, yang dirilis pada August 2026, memindahkan OIDC dan SSO ke PLANKA Pro. Pada rilis yang sama, edisi Community memperoleh autentikasi dua faktor (TOTP) untuk akun lokal. Karena itu, aktifkan fitur tersebut setidaknya untuk akun admin.
Mengapa BASE_URL merusak login jika tidak cocok dengan hostname
BASE_URL adalah alamat persis yang diketik pengguna di browser, lengkap dengan skema dan tanpa garis miring di akhir. Untuk stack ini, alamatnya adalah https://kanban.example.com. Planka membuat tautannya sendiri dan daftar origin WebSocket yang diizinkan berdasarkan nilai tersebut. Artinya, BASE_URL yang salah tidak menghasilkan error yang jelas. Halaman akan dimuat, tetapi proses pemuatan tidak pernah selesai.
Kasus yang umum terjadi: Anda menyalin contoh upstream, membiarkan BASE_URL=http://localhost:3000, lalu mengakses situs melalui HTTPS pada domain sebenarnya. Formulir login dikirim dan kredensial Anda diterima. Namun, board tidak muncul. Buka konsol developer browser. Anda akan melihat request ke /socket.io/ gagal karena socket terhubung ke origin halaman browser, sedangkan pembatasan origin pada server mengizinkan origin yang diturunkan dari BASE_URL.
TRUST_PROXY=true adalah bagian lain dari masalah yang sama. Planka berada di belakang Traefik, sehingga setiap request mencapainya dari alamat proxy melalui HTTP biasa di dalam jaringan Docker. Tanpa TRUST_PROXY, aplikasi mengabaikan header X-Forwarded-Proto dan X-Forwarded-For yang ditetapkan Traefik. Akibatnya, aplikasi menganggap koneksi tidak aman dan memperlakukan semua client sebagai satu alamat IP yang sama. Jika diaktifkan, aplikasi membaca header tersebut dan menggunakan skema yang sama dengan browser.
Traefik mem-proxy WebSocket tanpa konfigurasi tambahan. Ini adalah salah satu alasan untuk memilihnya dalam kasus ini. Pada nginx, proxy harus meneruskan header upgrade, proxy_set_header Upgrade $http_upgrade dan proxy_set_header Connection "upgrade". Jika tidak, spinner akan berhenti pada kondisi yang sama, tetapi dengan penyebab berbeda. Keduanya dapat ditempatkan dalam blok umum location /. Blok terpisah untuk /socket.io juga dapat digunakan, tetapi tidak wajib.
Memindahkan board ke hostname baru pada kemudian hari berarti mengubah dua hal secara bersamaan: nilai BASE_URL dan aturan Traefik Host(). Jika hanya salah satunya yang diubah, spinner akan muncul kembali. Menyajikan Planka dari subpath seperti https://example.com/planka didukung mulai versi 2.1.0, yang dirilis pada Maret 2026. Pada tag yang lebih lama, gunakan subdomain khusus untuk Planka.
Lokasi Planka menyimpan lampiran dan avatar
Planka 2 menyimpan semua unggahan pengguna dalam satu path di dalam container: /app/data. Lampiran, avatar pengguna, dan gambar latar board semuanya disimpan di dalamnya. Version 1 menggunakan tiga direktori terpisah. Karena itu, file Compose yang disalin dari panduan lama akan me-mount path yang sudah tidak ada, sehingga mount data yang diperlukan tidak tersedia.
Mount tunggal tersebut menentukan apakah board dapat bertahan setelah upgrade atau menimbulkan masalah. Docker image mendeklarasikan /app/data sebagai volume. Jika mount ini tidak dicantumkan dalam Compose, unggahan disimpan dalam anonymous volume. Compose mempertahankannya saat melakukan recreation up biasa, tetapi down yang kemudian diikuti up tidak otomatis menghubungkannya kembali. Board kembali dan tampak normal, semua kartu masih ada, tetapi setiap link lampiran tidak lagi berfungsi karena baris database masih menunjuk ke file dalam volume lama.
Named volume dalam file Compose di atas mencegah masalah ini. Bind mount juga dapat digunakan dan memudahkan pencadangan file dengan tools biasa, tetapi memerlukan satu langkah tambahan. Proses Node di dalam container berjalan sebagai UID 1000. Karena itu, direktori host yang dimiliki root akan menyebabkan permission error saat unggahan pertama:
sudo chown -R 1000:1000 /opt/planka/dataPerbandingan antara keduanya dibahas dalam bind mount dibandingkan dengan named volume.
Jika lampiran melebihi kapasitas disk pada plan Anda, Planka dapat menulisnya ke penyimpanan yang kompatibel dengan S3 melalui S3_ENDPOINT, S3_BUCKET, dan variabel key yang sesuai. Penyimpanan tersebut dapat berupa bucket hosted atau object store MinIO yang di-host sendiri pada server lain. Tentukan pilihan ini sebelum tim memenuhi board, karena pengaktifan S3 mengalihkan pembacaan dan penulisan file ke backend tersebut tanpa memigrasikan unggahan yang sudah ada.
Jalankan stack dan verifikasi hasilnya
docker compose pull
docker compose up -d
docker compose psdocker compose ps seharusnya menampilkan postgres sebagai healthy dan planka sebagai running. Jika Planka mengalami restart berulang, hal pertama yang harus diperiksa adalah koneksi basis data, bukan aplikasinya.
docker compose logs -f plankaBoot pertama yang sehat akan menjalankan migrasi basis data dan kemudian melaporkan bahwa server mendengarkan pada port 1337. Konfirmasikan bahwa skema telah terpasang dengan menanyakan langsung ke Postgres alih-alih hanya mengandalkan log:
docker compose exec postgres psql -U planka -d planka -c '\dt'Daftar tabel yang menyertakan board dan card berarti migrasi telah berjalan. Pesan "Did not find any relations" berarti Planka tidak pernah terhubung, jadi bandingkan DATABASE_URL dengan nilai POSTGRES_USER dan POSTGRES_PASSWORD di dalam .env Anda.
Selanjutnya, periksa rute dari mesin Anda sendiri, bukan dari VPS:
curl -I https://kanban.example.comHTTP/2 200 berarti Traefik memiliki sertifikat dan berhasil menjangkau container. Error 404 yang diberikan oleh Traefik berarti tidak ada router yang cocok dengan permintaan tersebut: aturan Host() tidak cocok dengan hostname yang Anda minta, atau Traefik tidak mendeteksi label tersebut. Error 502 berarti router cocok tetapi Traefik tidak dapat menjangkau container, misalnya karena container tidak terhubung ke jaringan proxy. Sekarang buka situs tersebut dan masuk dengan akun admin.
Ambil pg_dump sebelum setiap kenaikan versi
Dua penyimpanan terpisah menyimpan data board Anda, sehingga backup harus mencakup keduanya: database Postgres dan volume planka-data. Buat dump database saat stack sedang berjalan.
docker compose exec -T postgres pg_dump -U planka -d planka > "planka-db-$(date +%F).sql"-T menonaktifkan alokasi pseudo-terminal default Compose, sehingga dump tetap berada pada aliran output biasa.
Selanjutnya, backup upload. Cari nama volume yang sebenarnya terlebih dahulu karena Compose menambahkan nama direktori proyek sebagai prefix.
docker volume ls | grep planka
docker run --rm -v planka_planka-data:/data -v "$PWD":/backup alpine \
tar czf /backup/planka-files-$(date +%F).tgz -C /data .Proyek ini juga menyediakan docker-backup.sh dan docker-restore.sh di repositorinya, dan dokumentasi resminya menjadwalkan keduanya melalui cron setiap malam. Keduanya dapat digunakan. Namun, backup yang belum pernah dipulihkan tidak dapat diandalkan. Karena itu, pulihkan backup tersebut sekali ke VPS sementara, lalu pastikan Anda dapat login dan membuka lampiran. Pasangan penyimpanan yang sama digunakan oleh setiap aplikasi Compose yang menerima upload. Jadi, jika nanti Anda menempatkan Chatwoot pada server yang sama dengan meja dukungan Anda, rutinitas yang dibuat di sini dapat digunakan kembali dengan perubahan yang hampir hanya pada nama volume.
Jalankan dump tepat sebelum setiap perubahan versi. Backup dari tadi malam bukan backup yang dibuat sebelum migrasi yang akan Anda jalankan.
Tag harus dipatok dan catatan rilis harus dibaca
Kedua tag image dalam file tersebut sengaja dipatok.
ghcr.io/plankanban/planka:2.2.1 adalah rilis tertentu yang berlaku per Oktober 2026. Community 2.3.0 dirilis pada November 4, 2026, dengan perbaikan keamanan, dan upstream merekomendasikan pembaruan. latest berubah setiap kali upstream menerbitkan rilis baru, sehingga docker compose pull rutin dapat memasukkan migrasi skema pada waktu yang tidak Anda tentukan. Baca catatan rilis sebelum mengubah angka tersebut, karena perubahan yang dapat merusak kompatibilitas dan perbaikan keamanan dijelaskan di sana. Version 2.0.3 diterbitkan sebagai rilis keamanan. Rilis seperti inilah yang harus Anda baca, bukan terapkan secara tidak sengaja. Hal yang sama berlaku untuk 2.2.1, yang dirilis pada Agustus 2026: rilis ini memperbaiki celah path traversal yang memungkinkan pengguna yang sudah login membaca file arbitrer pada instance yang menggunakan penyimpanan file lokal. Itulah konfigurasi dalam panduan ini, dan advisori tersebut mencantumkan 2.1.1 dan versi sebelumnya sebagai versi yang terdampak. Jika Anda menggunakan 2.1.x, baca catatan 2.2.0 terlebih dahulu, karena rilis tersebut menonaktifkan pengguna yang sebelumnya hanya pernah login melalui SSO sampai admin memberi mereka password dan mengaktifkan kembali akun mereka. Pematokan tag mudah dilakukan di sini karena upstream memang menerbitkan image. Jika suatu project tidak menerbitkan image, Anda tetap harus menerapkan disiplin yang sama dengan satu langkah tambahan, seperti pada openGym yang dibangun di server dari tag git yang telah di-checkout.
postgres:16-alpine dipatok ke major version karena alasan yang lebih penting. Postgres menulis data directory dalam format yang terikat pada major version, dan server menolak membuka directory yang ditulis oleh versi lain. Jika Anda menulis postgres:latest, membiarkan tag melewati 16, container tidak akan berjalan. Sebagai contoh, image 17 berhenti dengan:
FATAL: database files are incompatible with server
DETAIL: The data directory was initialized by PostgreSQL version 16, which is not compatible with this version 17.Tidak ada data yang hilang, dan restart juga tidak memperbaiki masalah ini. Beralih ke major version Postgres baru memerlukan dump dari versi lama lalu restore ke data directory baru pada versi baru, menjalankan pg_upgrade yang mengonversi data tanpa dump tetapi memerlukan binary server lama dan baru tersedia secara bersamaan, atau menggunakan logical replication ke server yang menjalankan versi baru lalu melakukan switchover. Setiap opsi tersebut adalah migrasi yang direncanakan, bukan efek samping dari image pull. Logical replication memungkinkan server lama tetap berjalan saat server baru mengejar ketertinggalannya.
Jika Anda memindahkan instalasi Planka 1.x yang sudah ada, bukan memulai dari awal, upgrade tersebut memiliki prosedur terdokumentasi tersendiri dalam dokumentasi project, dan tidak ada cara untuk kembali ke version 1 tanpa backup yang dibuat sebelumnya.
Mode kegagalan dan string yang akan Anda lihat
Planka melakukan restart berulang kali dan log menyebutkan database. Kredensial dalam DATABASE_URL tidak cocok dengan environment Postgres. Perhatikan bahwa POSTGRES_PASSWORD hanya diterapkan saat direktori data pertama kali diinisialisasi. Jadi, memperbaiki variabel tersebut setelah boot pertama yang gagal tidak mengubah apa pun. Ubah password role database dengan ALTER ROLE agar sesuai dengan password yang dikonfigurasi. Menghapus volume db-data hanya menjadi opsi untuk instalasi sementara yang tidak memiliki data untuk dipertahankan.
Login berhasil, tetapi board tidak pernah dimuat. BASE_URL tidak cocok dengan alamat pada bilah browser, sehingga server menolak origin socket. Konsol browser menampilkan request yang gagal ke /socket.io/.
Upload gagal, sedangkan fungsi lainnya berjalan. Bind mount dimiliki oleh root. Jalankan sudo chown -R 1000:1000 pada direktori host, lalu restart container.
Lampiran menghilang setelah upgrade. /app/data tidak terpasang pada volume upload asli. Pasang kembali volume tersebut atau pulihkan file dari backup, lalu gunakan named volume sebelum mengubah image tag lagi.
Traefik mengembalikan 404. Tidak ada router yang cocok dengan request tersebut. Rule Host() tidak cocok dengan record DNS Anda, atau label tidak pernah sampai ke Traefik. docker compose config menampilkan label setelah substitusi. Di sinilah kesalahan pengetikan dapat terlihat. Sebaliknya, 502 berarti route cocok, tetapi container tidak dapat dijangkau. Jadi, periksa apakah container tersebut berada pada network proxy.
Notifikasi atau webhook tidak pernah tiba. Planka 2 mengirim request HTTP keluar melalui filter internal, dan daftar blokir default mencakup localhost dan postgres. Webhook yang diarahkan ke localhost diblokir secara desain. Setelah OUTGOING_ALLOWED_HOSTS ditetapkan, setiap host yang tidak tercantum dalam daftar tersebut juga diblokir. Arahkan webhook ke nama service container lain, lalu tambahkan nama tersebut ke OUTGOING_ALLOWED_HOSTS jika Anda menggunakan allow list, bukan menghapus filter.
Setelah berjalan, beban operasionalnya kecil. Pantau catatan rilis dan lakukan dump database sebelum setiap upgrade. Reboot akan menjalankan kembali stack secara otomatis karena restart: unless-stopped, selama service Docker sendiri diaktifkan saat boot. Stack Compose yang kembali berjalan setelah reboot membahas kasus ketika service tersebut tidak diaktifkan.
FAQ
Mengapa Planka terus memuat setelah saya login?
Kredensial diterima, tetapi koneksi live tidak berhasil. Browser membuka socket ke origin halaman, sedangkan Planka menentukan origin socket yang diizinkan dari BASE_URL. Jika variabel tersebut tetap menggunakan http://localhost:3000 saat Anda mengakses situs melalui https://kanban.example.com, server akan menolak koneksi. Konsol developer menampilkan request yang gagal ke /socket.io/. Atur BASE_URL ke alamat publik yang tepat tanpa trailing slash, tambahkan TRUST_PROXY=true agar aplikasi menghormati header X-Forwarded-Proto dari reverse proxy Anda, lalu jalankan docker compose up -d.
Bagaimana cara membuat pengguna admin Planka pertama?
Sejak versi 1.13, administrator tidak lagi dibuat secara otomatis. Anda dapat mengatur DEFAULT_ADMIN_EMAIL beserta variabel password, name, dan username yang sesuai, lalu menjalankan stack. Alternatifnya, jalankan docker compose run --rm planka npm run db:create-admin-user dan jawab prompt yang ditampilkan. Perintah interaktif lebih aman pada server bersama karena password tidak pernah masuk ke environment yang dikonfigurasi untuk container, tempat docker inspect dapat membacanya. Biarkan DEFAULT_ADMIN_EMAIL tetap diatur setelahnya untuk mencegah perubahan pada name, role, dan alamat email akun tersebut, serta mencegah penghapusannya dari antarmuka. Hapus DEFAULT_ADMIN_PASSWORD setelah setup karena jika tetap diatur, password akun terkait akan direset saat startup.
Di mana Planka menyimpan attachment dan avatar?
Semua file yang diunggah disimpan di bawah /app/data dalam container pada Planka 2, termasuk attachment, avatar pengguna, dan latar belakang board. Mount path tersebut pada named volume. Tanpa mount eksplisit, Docker image menggunakan anonymous volume. Volume ini tidak otomatis terhubung kembali setelah docker compose up berikutnya setelah docker compose down. Bind mount juga dapat digunakan, tetapi proses Node berjalan sebagai UID 1000. Karena itu, jalankan sudo chown -R 1000:1000 pada direktori host. Jika tidak, proses upload akan gagal karena error permission.
Berapa banyak RAM yang dibutuhkan Planka yang di-host sendiri?
FAQ teknis proyek merekomendasikan setidaknya 2 GB RAM dan 10 GB storage untuk tim kecil. Deployment Docker default menjalankan proses Node, server Postgres dengan satu proses backend untuk setiap koneksi terbuka, serta proxy Squid internal untuk memfilter request keluar. Jalankan docker stats --no-stream setelah penggunaan normal selama satu minggu, lalu tentukan kapasitas berdasarkan angka Anda sendiri. Pantau disk dengan lebih saksama daripada memory karena attachment terus bertambah.
Bagaimana cara meng-upgrade Planka tanpa kehilangan data?
Dump database dan arsipkan volume upload tepat sebelum upgrade, bukan berdasarkan jadwal tadi malam. Gunakan docker compose exec -T postgres pg_dump -U planka -d planka > planka-db.sql, dan pertahankan -T untuk menonaktifkan alokasi pseudo-terminal pada output yang dialihkan. Baca release notes untuk setiap versi yang dilewati, ubah image tag ke release tertentu alih-alih latest, lalu jalankan docker compose pull dan docker compose up -d serta pantau log untuk melihat proses migration. Biarkan tag Postgres tetap dikunci pada major version-nya karena server menolak membuka data directory yang ditulis oleh major version berbeda.