Tutorial

Cara install Odoo Community langsung di Ubuntu Server

Selain lewat Docker, Odoo Community juga bisa dipasang langsung di Ubuntu Server untuk kontrol yang lebih detail terhadap konfigurasi sistem. Berikut alur pemasangannya dari awal, dari memperbarui paket sistem hingga Odoo siap diakses lewat browser.

Tutorial: Cara Install Odoo Community di Ubuntu Server
Tutorial12 menit baca

Instalasi Odoo langsung di Ubuntu Server (tanpa Docker) dipilih ketika tim IT ingin kendali penuh atas setiap komponen: versi Python, lokasi file, cara layanan dijalankan, dan cara server di-tuning. Panduan ini memasang Odoo 17 Community di Ubuntu 24.04 LTS sampai siap dipakai produksi: user sistem khusus, PostgreSQL dengan hak akses minimal, virtual environment Python, file konfigurasi dengan worker, layanan systemd, Nginx dengan HTTPS, hingga database pertama. Contoh memakai server 4 vCPU dan 8 GB RAM untuk sekitar 25 pengguna aktif.

Yang akan Anda pelajari:

  • Menyiapkan dependensi sistem, termasuk wkhtmltopdf versi yang benar untuk cetak PDF.
  • Membuat user sistem dan role PostgreSQL yang tidak berhak superuser.
  • Memasang kode Odoo dan dependensi Python di virtual environment terpisah.
  • Menulis odoo.conf dengan worker dan batas memori yang sesuai ukuran server.
  • Menjalankan Odoo sebagai layanan systemd di balik Nginx dan HTTPS.
  • Membuat database produksi pertama dengan aman.

Prasyarat

  • Server Ubuntu 24.04 LTS (atau 22.04 LTS) baru, dengan user yang punya akses sudo. Minimal 2 vCPU dan 4 GB RAM untuk uji coba, 4 vCPU dan 8 GB RAM untuk produksi kecil.
  • Akses SSH ke server dan pemahaman dasar perintah Linux.
  • Nama domain (misalnya erp.contohusaha.co.id) dengan record A yang sudah mengarah ke IP server, agar sertifikat HTTPS bisa diterbitkan.
  • Port 22, 80, dan 443 terbuka di firewall penyedia cloud. Port 8069 tidak perlu dibuka ke internet.
  • Rencana backup: lokasi penyimpanan di luar server dan jadwalnya.

Langkah 1: Perbarui sistem dan pasang dependensi

Masuk ke server lewat SSH dan pastikan spesifikasinya sesuai rencana dengan lsb_release, nproc, dan free -h.

  1. Perbarui daftar paket dan paket terpasang: sudo apt update && sudo apt upgrade -y. Reboot bila kernel ikut diperbarui.
  2. Pasang paket build dan pustaka yang dibutuhkan modul Python Odoo saat dikompilasi: python3-dev, python3-venv, build-essential, libxml2-dev, libxslt1-dev, libldap2-dev, libsasl2-dev, libpq-dev, libjpeg-dev, serta node-less dan font dasar.
  3. Pasang wkhtmltopdf 0.12.6.1 with patched qt dari rilis resmi proyek wkhtmltopdf, bukan dari repositori Ubuntu. Versi dari apt install wkhtmltopdf tidak memakai patched qt sehingga header dan footer laporan PDF (faktur, PO, slip) tidak tercetak.
Terminal Ubuntu 24.04 yang menjalankan apt update, pemasangan paket build untuk Odoo, dan pemasangan wkhtmltopdf 0.12.6.1 with patched qt
(1) Pembaruan sistem, (2) pustaka build untuk dependensi Python, (3) wkhtmltopdf versi patched qt.

Gambar dalam artikel ini adalah mockup dengan data contoh, bukan tangkapan layar sistem milik klien.

Langkah 2: Buat user sistem dan siapkan PostgreSQL

Odoo tidak boleh berjalan sebagai root. Buat user khusus yang juga menjadi pemilik semua file Odoo.

  1. sudo adduser --system --group --home /opt/odoo --shell /bin/bash odoo membuat user dan grup odoo dengan direktori kerja /opt/odoo.
  2. Pasang PostgreSQL dari repositori Ubuntu (versi 16 di Ubuntu 24.04). Layanan langsung aktif setelah instalasi.
  3. Buat role database dengan nama yang sama dengan user sistem, cukup dengan hak Create DB: sudo -u postgres createuser --createdb --no-superuser --no-createrole odoo. Karena namanya sama, Odoo bisa terhubung lewat socket lokal tanpa kata sandi (autentikasi peer). Banyak tutorial memakai opsi -s (superuser), padahal hak itu tidak dibutuhkan dan memperbesar risiko bila aplikasi disusupi.
  4. Pastikan PostgreSQL enabled dan active agar ikut menyala saat server restart.
Terminal yang membuat user sistem odoo, memasang PostgreSQL 16, membuat role odoo dengan hak Create DB tanpa superuser, dan memeriksa status layanan
(1) User sistem odoo, (2) PostgreSQL 16, (3) role database tanpa superuser, (4) layanan aktif.

Langkah 3: Ambil kode Odoo dan pasang dependensi Python

Pindah ke user odoo dengan sudo -iu odoo agar semua file langsung dimiliki user yang benar.

  1. Clone cabang 17.0 dari repositori resmi Odoo di GitHub dengan --depth 1. Tanpa opsi ini Anda mengunduh seluruh riwayat sejak 2005, lebih dari 5 GB.
  2. Buat virtual environment di /opt/odoo/venv dan aktifkan. Paket Python Odoo terpisah dari paket sistem, sehingga apt upgrade tidak merusak Odoo dan sebaliknya.
  3. Pasang wheel, lalu seluruh isi requirements.txt. Bila muncul error saat membangun psycopg2 atau python-ldap, biasanya ada pustaka dari langkah 1 yang terlewat.
  4. Buat folder custom-addons untuk modul buatan sendiri atau dari pihak ketiga, dan data untuk filestore (lampiran, gambar produk, dokumen).
Terminal user odoo yang meng-clone Odoo cabang 17.0, membuat virtual environment Python, memasang requirements.txt, dan membuat folder custom-addons serta data
(1) Clone cabang 17.0, (2) virtual environment, (3) dependensi Python, (4) folder addons dan data.

Langkah 4: Tulis file konfigurasi odoo.conf

Kembali ke user admin (exit) dan buat /etc/odoo.conf. Setiap baris di file ini punya alasan:

  1. admin_passwd adalah master password untuk mengelola database. Isi dengan kata sandi acak yang panjang. Odoo otomatis menyimpannya dalam bentuk hash setelah pertama kali dipakai.
  2. db_user = odoo dengan db_host = False memakai koneksi socket lokal. dbfilter membatasi database mana yang dilayani, berguna bila satu server menjalankan beberapa database.
  3. addons_path memuat modul standar dan modul custom; data_dir menentukan lokasi filestore yang wajib ikut dicadangkan.
  4. http_interface = 127.0.0.1 membuat Odoo hanya bisa diakses dari server itu sendiri, lewat Nginx. proxy_mode = True wajib bila memakai reverse proxy agar alamat IP dan skema HTTPS terbaca benar.
  5. workers mengaktifkan mode multiproses. Rumus umumnya (jumlah CPU × 2) + 1, dengan satu worker melayani sekitar 6 pengguna bersamaan. Batas memori dan waktu mencegah satu permintaan berat menghabiskan RAM server.
Isi file /etc/odoo.conf di editor nano dengan admin_passwd, koneksi database, addons_path, http_interface 127.0.0.1, proxy_mode, dan pengaturan workers
(1) Master password, (2) koneksi database, (3) lokasi addons dan data, (4) akses lewat proxy, (5) worker dan batas sumber daya.

Menghitung worker untuk server Anda. Server 4 vCPU: (4 × 2) + 1 = 9 worker teoritis. Namun setiap worker memakai 150 sampai 300 MB RAM, ditambah PostgreSQL. Di server 8 GB, 5 worker dan 1 cron thread adalah titik aman. Bila pengguna bertambah, tambah RAM lebih dulu sebelum menambah worker.

Langkah 5: Jalankan Odoo sebagai layanan systemd

Dengan systemd, Odoo menyala otomatis setelah server restart dan dihidupkan ulang bila berhenti karena error.

  1. Buat /etc/systemd/system/odoo.service. Bagian penting: User=odoo, ExecStart yang memakai Python dari virtual environment, dan Requires=postgresql.service agar Odoo menunggu database siap. Buat juga folder log dan batasi izin odoo.conf ke 640 karena berisi master password.
  2. Muat ulang systemd lalu aktifkan sekaligus jalankan: sudo systemctl daemon-reload && sudo systemctl enable --now odoo.
  3. Periksa systemctl status odoo. Status harus active (running).
  4. Lihat log. Baris HTTP service (werkzeug) running on 127.0.0.1:8069 menandakan Odoo siap menerima permintaan dari Nginx.
Terminal menampilkan isi odoo.service, perintah systemctl enable --now odoo, status layanan active running, dan log Odoo yang berjalan di 127.0.0.1:8069
(1) Unit systemd, (2) aktifkan layanan, (3) status berjalan, (4) log siap menerima koneksi.

Langkah 6: Pasang Nginx dan HTTPS

Nginx menerima koneksi dari internet di port 80 dan 443, lalu meneruskannya ke Odoo. Lapisan ini menangani sertifikat HTTPS, kompresi, dan batas ukuran unggahan.

  1. Pasang nginx, certbot, dan plugin Nginx untuk certbot.
  2. Buat /etc/nginx/sites-available/odoo dengan dua upstream: port 8069 untuk halaman biasa dan port 8072 untuk /websocket (notifikasi dan chat real-time di Odoo 17). Naikkan client_max_body_size agar lampiran besar bisa diunggah, dan proxy_read_timeout agar laporan berat tidak terputus. Aktifkan situs lalu uji dengan nginx -t.
  3. Terbitkan sertifikat Let's Encrypt dengan certbot --nginx dan opsi --redirect agar semua akses HTTP dialihkan ke HTTPS. Sertifikat diperpanjang otomatis.
  4. Aktifkan firewall: izinkan hanya OpenSSH dan Nginx. Port 8069 dan 5432 tetap tertutup dari luar.
Terminal memasang Nginx dan certbot, menampilkan konfigurasi reverse proxy Odoo dengan upstream 8069 dan 8072, menerbitkan sertifikat HTTPS, dan mengaktifkan firewall ufw
(1) Nginx dan certbot, (2) konfigurasi reverse proxy, (3) sertifikat HTTPS, (4) firewall.

Langkah 7: Buat database produksi pertama

Buka https://erp.contohusaha.co.id/web/database/manager di browser.

  1. Masukkan Master Password sesuai admin_passwd di odoo.conf.
  2. Isi Database Name yang cocok dengan dbfilter, misalnya erp_produksi. Isi juga email dan kata sandi admin pertama. Email ini dipakai untuk login, jadi gunakan alamat yang aktif.
  3. Pilih Country: Indonesia. Pilihan negara menentukan paket akuntansi lokal yang terpasang (bagan akun, pajak PPN) saat modul Accounting diaktifkan, dan sulit diganti setelah ada transaksi.
  4. Biarkan Demo data tidak dicentang. Data demo tidak bisa dihapus bersih dari database produksi; buat database terpisah bila ingin mencoba fitur.
  5. Klik Create database. Proses memakan 1 sampai 3 menit, lalu Anda masuk ke dasbor Odoo.
Halaman Odoo database manager di browser dengan master password, nama database erp_produksi, negara Indonesia, demo data tidak dicentang, dan tombol Create database
(1) Master password, (2) nama database, (3) negara Indonesia, (4) tanpa data demo, (5) buat database.

Setelah database dibuat: tambahkan list_db = False di odoo.conf lalu restart layanan. Halaman database manager tidak lagi bisa diakses publik, sehingga tidak ada yang bisa mencoba menebak master password atau mengunduh backup lewat browser.

Backup dan pembaruan rutin

Instalasi manual tidak punya volume terkelola seperti Docker, jadi backup harus dirancang sendiri. Yang wajib dicadangkan ada dua: database PostgreSQL dan filestore di /opt/odoo/data/filestore/erp_produksi. Database tanpa filestore berarti semua lampiran dan gambar produk hilang.

# /etc/cron.d/odoo-backup (dijalankan setiap hari pukul 01.30)
30 1 * * * odoo pg_dump -Fc erp_produksi > /backup/erp_$(date +\%F).dump && \
  tar -czf /backup/filestore_$(date +\%F).tar.gz -C /opt/odoo/data/filestore erp_produksi && \
  find /backup -mtime +14 -delete

Salin folder /backup ke lokasi lain (object storage atau server berbeda) setiap hari, dan uji pemulihan minimal sebulan sekali di server staging. Backup yang belum pernah diuji belum bisa dianggap backup.

Memperbarui Odoo

Perbaikan bug dan keamanan dirilis di cabang 17.0 secara berkala. Prosedur yang aman:

  1. Backup database dan filestore.
  2. cd /opt/odoo/odoo && git pull sebagai user odoo.
  3. Uji di staging: odoo-bin -c /etc/odoo.conf -d salinan_db -u all --stop-after-init.
  4. Bila lolos, ulangi di produksi pada jam sepi lalu sudo systemctl restart odoo.

Masalah yang sering muncul

GejalaPenyebab umumSolusi
PDF tercetak tanpa header, footer, atau logowkhtmltopdf dari repositori Ubuntu (tanpa patched qt)Pasang ulang dari paket rilis resmi seperti langkah 1, lalu restart Odoo.
502 Bad GatewayLayanan Odoo berhenti atau gagal startPeriksa systemctl status odoo dan /var/log/odoo/odoo.log; sering karena izin file atau modul yang error.
Notifikasi dan chat tidak muncul real-timeLokasi /websocket tidak diteruskan ke port 8072Tambahkan blok websocket di Nginx dan pastikan workers lebih dari 0.
Odoo lambat dan server memakai swapWorker terlalu banyak untuk RAM yang tersediaKurangi workers atau tambah RAM; pantau dengan htop.
Unggah lampiran gagal (413)client_max_body_size Nginx terlalu kecilNaikkan nilainya, lalu sudo systemctl reload nginx.

Kapan memilih instalasi manual dibanding Docker

Instalasi manual cocok bila tim IT terbiasa mengelola Linux, server hanya menjalankan satu instance Odoo, dan Anda butuh kendali atas tuning PostgreSQL atau lokasi file. Docker lebih praktis bila ingin menjalankan beberapa versi atau beberapa instance di satu server, atau ingin pembaruan cukup dengan mengganti image. Panduan versi Docker ada di cara install Odoo dengan Docker.

Tips dan kesalahan umum

  • Jangan pernah membuka port 8069 atau 5432 ke internet. Semua akses lewat Nginx dan HTTPS.
  • Simpan master password, kata sandi admin, dan akses server di pengelola kata sandi tim, bukan di grup chat.
  • Pisahkan server staging dari produksi. Setiap modul baru dan pembaruan diuji di staging lebih dulu.
  • Pantau ruang disk. Filestore dan backup harian bisa memenuhi disk dalam beberapa bulan tanpa disadari.
  • Catat setiap perubahan konfigurasi server di repositori Git. Dasarnya ada di panduan install dan konfigurasi Git.

Ringkasan

Odoo 17 di Ubuntu 24.04 siap produksi bila dipasang dengan tujuh lapis yang benar: dependensi sistem dengan wkhtmltopdf patched qt, user dan role database tanpa hak berlebih, virtual environment Python, odoo.conf dengan worker yang sesuai RAM, layanan systemd, Nginx dengan HTTPS dan firewall, serta database yang dibuat tanpa data demo. Setelah itu, backup database dan filestore yang teruji serta prosedur pembaruan lewat staging menjaga sistem tetap aman dalam jangka panjang.

Server sudah siap, tetapi pekerjaan terbesar justru setelah ini: memetakan proses bisnis, mengatur modul, dan memindahkan data lama. Tahapannya kami jelaskan di tahapan implementasi Odoo. Bila ingin server dikelola tim yang berpengalaman, lihat layanan infrastruktur dan DevOps Odoo atau jasa implementasi Odoo kami, termasuk contoh hasilnya di portofolio ERP manufaktur.

Pertanyaan yang sering diajukan

Apakah panduan ini berlaku untuk Ubuntu 22.04?

Ya. Perbedaannya hanya versi paket: Ubuntu 22.04 memakai Python 3.10 dan PostgreSQL 14. Semua perintah dan file konfigurasi tetap sama.

Berapa spesifikasi server untuk 50 pengguna?

Sebagai titik awal, 8 vCPU dan 16 GB RAM dengan disk SSD, worker sekitar 9 sampai 11. Angka pastinya bergantung pada modul yang dipakai dan jumlah pengguna yang aktif bersamaan, jadi pantau pemakaian selama bulan pertama.

Apakah PostgreSQL sebaiknya di server terpisah?

Untuk di bawah 50 pengguna, satu server biasanya cukup. Server database terpisah atau layanan PostgreSQL terkelola layak dipertimbangkan bila beban tinggi atau Anda butuh replikasi dan backup otomatis.

Bagaimana cara memasang modul custom?

Salin folder modul ke /opt/odoo/custom-addons, pastikan pemiliknya user odoo, restart layanan, lalu aktifkan mode developer dan klik Update Apps List di menu Apps.

Apakah bisa upgrade dari Odoo 16 ke 17 dengan git pull?

Tidak. git pull hanya untuk pembaruan di dalam versi yang sama. Upgrade antar versi besar membutuhkan migrasi database dan penyesuaian modul custom, yang kami bahas di artikel migrasi sistem.

Belum ada penilaian
Seberapa membantu artikel ini?

Butuh bantuan memasang atau mengelola server Odoo Anda?

Kami bantu instalasi, konfigurasi, dan pemeliharaan server Odoo, baik lewat Docker maupun langsung di server.

WhatsApp