Nazwa Fadilatul Izdihar

Instalasi dan Konfigurasi Planka di Ubuntu

Planka adalah aplikasi manajemen proyek sumber terbuka yang memungkinkan tim untuk mengelola proyek dengan cara visual menggunakan papan kanban. Planka memungkinkan pengguna untuk membuat, mengelola, dan melacak tugas proyek mereka dengan cara yang intuitif dan mudah digunakan.

Dokumentasi ini menjelaskan langkah-langkah instalasi dan konfigurasi Planka di server Ubuntu:
- Planka Server
- PostgreSQL sebagai database
- Node.js dan npm sebagai runtime dan package manager
- NGINX sebagai web server (opsional)
Seluruh proses dilakukan pada sistem operasi Ubuntu dengan manajemen paket apt.

1. Instalasi Dependensi yang Diperlukan

Instal dependensi yang diperlukan seperti Node.js, npm, dan PostgreSQL di Ubuntu:


sudo apt update
sudo apt install -y nodejs npm postgresql postgresql-contrib build-essential

2. Mengonfigurasi PostgreSQL

Setelah PostgreSQL terinstal, buat database dan pengguna untuk Planka:

# Masuk ke PostgreSQL


sudo -u postgres psql

# Buat database untuk Planka


CREATE DATABASE planka;

# Buat pengguna untuk Planka dan beri hak akses


CREATE USER planka_user WITH PASSWORD 'password';
GRANT ALL PRIVILEGES ON DATABASE planka TO planka_user;
FLUSH PRIVILEGES;
EXIT;

3. Mengunduh dan Menginstal Planka

Unduh Planka dari GitHub dan instal dependensinya:

# Unduh Planka dari GitHub


cd /var/www
sudo git clone https://github.com/planka/planka.git

# Masuk ke direktori Planka


cd planka

# Instal dependensi Node.js


sudo npm install

4. Mengonfigurasi Planka

Salin file konfigurasi dan sesuaikan pengaturan database di Planka:

# Salin file konfigurasi default


cp .env.example .env

# Edit file konfigurasi untuk mengonfigurasi PostgreSQL


sudo nano .env

# Sesuaikan pengaturan berikut:


DB_CONNECTION=postgresql
DB_HOST=localhost
DB_PORT=5432
DB_DATABASE=planka
DB_USERNAME=planka_user
DB_PASSWORD=password

5. Menyiapkan dan Menjalankan Planka

Setelah konfigurasi selesai, jalankan Planka menggunakan Node.js:

# Jalankan migrasi database


sudo npm run migrate

# Jalankan aplikasi Planka


sudo npm start

6. Mengonfigurasi NGINX untuk Planka (Opsional)

Jika ingin menggunakan NGINX sebagai web server untuk Planka, ikuti langkah-langkah berikut:

# Instal NGINX


sudo apt install nginx

# Buat file konfigurasi virtual host untuk Planka


sudo nano /etc/nginx/sites-available/planka

# Tambahkan konfigurasi berikut:


server {
    listen 80;
    server_name planka.local;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

# Aktifkan situs dan restart NGINX


sudo ln -s /etc/nginx/sites-available/planka /etc/nginx/sites-enabled/
sudo systemctl restart nginx

7. Mengakses Planka di Web Browser

Setelah konfigurasi selesai, buka browser dan akses Planka dengan alamat berikut:


http://planka.local