Setup Self-Hosted Cloud Storage dengan Nextcloud di VPS Linux

TL;DR

• Nextcloud di VPS Linux stabil jika storage, reverse proxy, cache, dan backup diperlakukan sebagai komponen inti.
• Redis, cron mode, dan data directory yang benar biasanya lebih menentukan stabilitas daripada wizard install.
• Target desainnya adalah operability yang masuk akal, bukan meniru fitur platform storage enterprise.

Pendahuluan

Menjalankan cloud storage sendiri dengan Nextcloud terlihat sederhana sampai beban operasional mulai terasa. Masalah biasanya bukan pada proses instalasi awal, tetapi pada keputusan kecil seperti pemisahan disk data, reverse proxy header, background job, dan strategi backup database. Jika hal-hal ini salah sejak awal, instance yang awalnya nyaman dipakai tim kecil bisa cepat berubah menjadi aplikasi file sync yang lambat, rawan lock, dan sulit dipulihkan saat disk bermasalah.

Untuk VPS Linux, target yang realistis bukan meniru platform storage enterprise, melainkan membangun layanan yang cukup aman, cukup bisa dipantau, dan cukup mudah dipulihkan. Itu berarti arsitektur harus dibuat sesederhana mungkin, tetapi tidak sembrono.

Prerequisites

• Ubuntu 22.04 LTS atau distro Linux setara.
• Akses sudo atau root.
• Domain publik yang mengarah ke VPS.
• Minimal 2 vCPU, 4 GB RAM, dan disk terpisah untuk data jika ingin dipakai lebih dari sekadar lab.
• Paket: nginx, mariadb-server, redis-server, php-fpm, php-mysql, php-xml, php-curl, php-gd, php-zip, php-mbstring, php-intl, php-bcmath, unzip.

Problem di Production

Di produksi, masalah Nextcloud jarang mulai dari “server tidak hidup”. Lebih sering muncul sebagai upload putus, lock timeout, disk root penuh, atau restore yang tidak konsisten. Sebagian besar berasal dari keputusan awal yang dianggap kecil: memakai SQLite terlalu lama, menyimpan data di web root, atau tidak memisahkan storage dari OS.

Mental Model

Anggap Nextcloud sebagai aplikasi stateful dengan beberapa komponen: file data, metadata database, cache/locking, reverse proxy, dan background job. Jika salah satu diabaikan, keseluruhan pengalaman user akan terasa tidak stabil walau proses web masih menjawab request.

Konsep Utama

Storage layout lebih penting daripada installer

Nextcloud menyimpan state di beberapa tempat sekaligus: file user, metadata database, cache, dan konfigurasi aplikasi. Banyak deployment pemula mencampur semuanya pada satu disk root kecil. Selama pengguna masih sedikit, ini terlihat aman. Begitu preview cache, upload besar, dan log bertambah, ruang disk dan IOPS menjadi bottleneck.

Reverse proxy adalah boundary yang nyata

Instance Nextcloud hampir selalu duduk di belakang Nginx atau proxy lain. Konfigurasi trusted_proxies, overwriteprotocol, ukuran upload, dan timeout bukan detail kosmetik. Jika salah, gejalanya bisa berupa login loop, WebDAV error, upload putus di tengah jalan, atau URL yang berubah-ubah.

Backup yang sehat harus memahami konsistensi

Menyalin direktori data tanpa snapshot database bukan backup yang bisa diandalkan. File metadata, share state, dan lock bisa tidak sinkron. Backup minimum yang layak adalah dump database, salinan konfigurasi, dan snapshot direktori data yang diambil dengan prosedur yang konsisten.

Architecture / Context

Sistem yang dibangun terdiri dari Nginx sebagai edge HTTP/TLS, PHP-FPM sebagai runtime aplikasi, MariaDB untuk metadata, Redis untuk lock dan cache, dan volume data terpisah untuk file user. Di produksi, inilah boundary minimal yang masih masuk akal untuk dioperasikan di satu VPS tanpa membuat semua state bercampur di satu direktori.

Arsitektur / Cara Kerja

Topologi yang cukup sehat untuk VPS tunggal biasanya seperti ini:

1. Ubuntu LTS sebagai host dasar
2. Nginx di depan untuk TLS termination dan request filtering
3. PHP-FPM untuk eksekusi aplikasi
4. MariaDB untuk metadata
5. Redis untuk file locking dan cache
6. disk terpisah atau volume terdedikasi untuk direktori data

Dengan susunan ini, jalur request menjadi lebih jelas. Browser berbicara ke Nginx, Nginx meneruskan request dinamis ke PHP-FPM, aplikasi membaca metadata di database, dan Redis membantu menghindari lock contention yang mahal. Data user tetap berada di volume yang bisa di-backup dan dipantau secara terpisah.

Practical Implementation

Step 1: Install dependency utama

sudo apt update
sudo apt install -y nginx mariadb-server redis-server php-fpm php-mysql php-xml php-curl php-gd php-zip php-mbstring php-intl php-bcmath unzip

Step 2: Siapkan database

sudo mysql -e "CREATE DATABASE nextcloud CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;"
sudo mysql -e "CREATE USER 'nextcloud'@'localhost' IDENTIFIED BY 'STRONG_DB_PASSWORD';"
sudo mysql -e "GRANT ALL PRIVILEGES ON nextcloud.* TO 'nextcloud'@'localhost';"
sudo mysql -e "FLUSH PRIVILEGES;"

Step 3: Buat direktori data di luar web root

sudo mkdir -p /srv/nextcloud/data
sudo chown -R www-data:www-data /srv/nextcloud

Step 4: Unduh Nextcloud

cd /tmp
curl -LO https://download.nextcloud.com/server/releases/latest.zip
sudo unzip latest.zip -d /var/www/
sudo chown -R www-data:www-data /var/www/nextcloud

Step 5: Aktifkan Redis untuk locking

Tambahkan konfigurasi berikut setelah instalasi selesai di config.php.

'memcache.local' => '\\OC\\Memcache\\APCu',
'memcache.locking' => '\\OC\\Memcache\\Redis',
'redis' => [
  'host' => '127.0.0.1',
  'port' => 6379,
],

Step 6: Konfigurasi Nginx

server {
  listen 80;
  server_name cloud.example.com;
  root /var/www/nextcloud;

  client_max_body_size 2G;
  fastcgi_buffers 64 4K;

  location / {
    try_files $uri $uri/ /index.php$request_uri;
  }

  location ~ \.php(?:$|/) {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
  }
}

Aktifkan site:

sudo ln -s /etc/nginx/sites-available/nextcloud.conf /etc/nginx/sites-enabled/nextcloud.conf
sudo nginx -t
sudo systemctl reload nginx

Step 7: Jalankan setup web installer

Gunakan browser ke https://cloud.example.com lalu isi:

• admin user
• password admin
• data folder: /srv/nextcloud/data
• database user: nextcloud
• database password: STRONG_DB_PASSWORD
• database name: nextcloud

Step 8: Aktifkan cron mode

sudo -u www-data crontab -e

Tambahkan:

*/5 * * * * php -f /var/www/nextcloud/cron.php

Verification

sudo systemctl status nginx php8.3-fpm mariadb redis-server
sudo -u www-data php /var/www/nextcloud/occ status
sudo -u www-data php /var/www/nextcloud/occ config:system:get datadirectory
df -h

Tanda berhasil:

• semua service inti active (running)
• occ status menampilkan installed: true
• datadirectory mengarah ke /srv/nextcloud/data
• upload file kecil dan besar berhasil dari browser

Troubleshooting

Login loop atau URL salah

Biasanya overwriteprotocol atau reverse proxy config tidak benar.

File lock error

Periksa Redis dan memcache.locking.

sudo systemctl status redis-server
sudo -u www-data php /var/www/nextcloud/occ config:system:get redis

Upload besar gagal

Periksa client_max_body_size, upload_max_filesize, dan post_max_size.

Production Notes

• Letakkan direktori data pada disk dengan IOPS yang masuk akal, bukan hanya kapasitas besar.
• Snapshot database dan data directory harus dikoordinasikan jika Anda ingin restore yang benar.
• Pantau disk growth, cron backlog, Redis health, dan latency storage.
• Upgrade mayor jangan dilakukan tanpa backup dan maintenance window kecil.

Studi Kasus / Masalah Nyata

Root disk habis karena preview dan log

Instance kecil sering dipasang di VPS dengan disk root minimal. Setelah beberapa minggu, thumbnail, log, dan cache menumpuk. Service masih hidup, tetapi upload baru gagal dan database mulai error karena ruang kosong hampir nol.

File locking bermasalah saat banyak sinkronisasi

Tanpa Redis, instance dengan beberapa client desktop aktif dapat mengalami lock timeout dan perilaku folder yang terlihat acak. Gejalanya membuat tim salah menilai seolah disk atau database yang rusak, padahal masalah utamanya ada pada model locking.

Restore gagal karena backup hanya menyalin file

Banyak admin menyalin /var/www/nextcloud dan direktori data, lalu menganggap backup selesai. Saat insiden terjadi, share, user metadata, dan app state tidak bisa dipulihkan dengan utuh karena database snapshot tidak sinkron.

Trade-offs

• Satu VPS sederhana murah dan mudah dipahami, tetapi membatasi kapasitas dan isolation.
• Plugin tambahan menambah fitur, tetapi juga menambah update surface dan risiko operasional.
• Object storage bisa membantu skala, tetapi membuat troubleshooting dan restore lebih kompleks dibanding disk lokal yang rapi.

Best Practices

Pisahkan concern sejak awal

Pemisahan host OS, data disk, database, dan reverse proxy memudahkan troubleshooting.

Ukur kapasitas berdasarkan IOPS

Storage sync dan thumbnail generation sering lebih sensitif terhadap latency disk daripada kapasitas mentah.

Anggap upgrade sebagai event operasional

Upgrade mayor sebaiknya dilakukan dengan snapshot, maintenance window kecil, dan verifikasi app yang benar-benar dipakai.

Failure Modes

• Disk root penuh akibat preview, log, atau cache yang tumbuh tanpa kontrol.
• File locking bermasalah karena Redis tidak dipasang atau salah konfigurasi.
• Backup hanya menyalin direktori file tanpa snapshot database yang konsisten.

Kesalahan Umum

• menaruh direktori data di bawah web root
• mengandalkan SQLite untuk instance yang sudah dipakai tim
• tidak memakai Redis untuk locking
• memasang terlalu banyak app tambahan sejak hari pertama
• tidak menguji restore sebelum mengklaim backup aman

Kesimpulan

Nextcloud di VPS Linux bisa menjadi solusi self-hosted yang masuk akal jika dirancang dengan disiplin operasional, bukan hanya mengikuti wizard instalasi. Fokus utamanya adalah boundary reverse proxy yang rapi, storage layout yang tidak rapuh, dan backup yang benar-benar bisa dipulihkan.