Minta Pencerahan: Langkah Awal Instalasi Odoo di Ubuntu Server Baru
Diposting pada 22 Mar 2026, 19:55
Halo teman-teman praktisi Odoo sekalian,
Saya Lestari dari tim IT perusahaan. Saat ini kami sedang eksplorasi lebih dalam lagi potensi Odoo ERP. Nah, saya punya server Ubuntu kosong dan berencana untuk melakukan instalasi Odoo di sana. Tujuan awalnya sih untuk develop atau testing modul-modul kustom sebelum nantinya naik ke produksi.
Jujur saya masih agak bingung nih dengan tahapan instalasinya yang paling efisien dan stabil di Ubuntu. Apakah ada teman-teman di sini yang punya pengalaman atau best practice dalam menginstal Odoo (mungkin versi terbaru seperti Odoo 16 atau 17) di Ubuntu Server?
Mungkin ada tips atau urutan langkah-langkah yang direkomendasikan? Atau mungkin ada hal-hal krusial yang perlu diperhatikan seperti konfigurasi PostgreSQL, dependensi Python, atau penggunaan Nginx/Apache sebagai reverse proxy? Saya pengennya setup yang cukup standar tapi scalable.
Mohon bimbingannya ya, siapa tahu ada yang bisa share pengalaman step-by-stepnya biar saya nggak salah langkah. Terima kasih banyak sebelumnya!
Balasan (1)
Halo Mba Lestari! Senang sekali bisa bantu eksplorasi Odoo ini.
Pertanyaan Mba Lestari ini sangat umum dan penting lho di komunitas Odoo Indonesia. Apalagi untuk tujuan develop dan testing, setup awal yang stabil itu kunci. Jangan khawatir, banyak kok sobat Odoo lain yang sudah melalui fase ini dan siap berbagi pengalaman.
Untuk instalasi Odoo 16 atau 17 di Ubuntu Server, langkah-langkahnya memang ada beberapa tahapan, tapi kalau diikuti dengan benar, hasilnya akan sangat stabil dan efisien. Kita akan pakai metode instalasi dari source code Odoo, karena ini paling fleksibel untuk development dan kustomisasi.
Yuk, kita bahas urutan langkah-langkah yang direkomendasikan beserta hal-hal krusialnya:
1. Persiapan Server & Update Sistem
Pastikan Ubuntu Server Mba Lestari sudah dalam kondisi paling baru. Ini penting untuk keamanan dan kompatibilitas dependensi. Lakukan update dan upgrade sistem terlebih dahulu.
2. Instalasi & Konfigurasi PostgreSQL
Odoo butuh database yang kuat, dan PostgreSQL adalah pasangannya yang paling serasi.
Install PostgreSQL:
Instal paket PostgreSQL dari repository Ubuntu.
Buat User & Database Khusus Odoo:
Ini penting untuk keamanan. Jangan pakai user PostgreSQL default. Buat user baru dengan password yang kuat, lalu buat database yang nanti akan dipakai Odoo. Pastikan user tersebut memiliki hak akses yang cukup untuk mengelola database Odoo.
3. Instalasi Dependensi Python & Lingkungan Virtual (Virtual Environment)
Odoo dibangun dengan Python. Untuk menghindari konflik versi library Python, sangat disarankan menggunakan virtual environment. Ini 'kotak pasir' khusus untuk Odoo Mba Lestari.
Install Python & Tools:
Pastikan Python3 dan `python3-pip` sudah terinstal. Selain itu, beberapa build essential juga dibutuhkan.
Install Dependensi Sistem:
Ada beberapa library sistem yang dibutuhkan Odoo, seperti `libpq-dev`, `libxml2-dev`, `libxslt1-dev`, `libsass-dev`, `libjpeg-dev`, `libfreetype6-dev`, `liblcms2-dev`, `libwebp-dev`, `libharfbuzz-dev`, `libfribidi-dev`, dan `libffi-dev`.
Buat Virtual Environment:
Buat virtual environment di lokasi yang strategis (misal: `/opt/odoo/venv`).
Aktivasi & Instalasi Library Python Odoo:
Setelah virtual environment aktif, instal semua library Python yang dibutuhkan Odoo menggunakan `pip` berdasarkan file `requirements.txt` yang ada di source code Odoo.
4. Instalasi Odoo (dari Source Code)
Ini bagian intinya. Kita akan mengunduh kode Odoo.
Buat User Sistem Khusus Odoo:
Untuk alasan keamanan dan isolasi, jalankan Odoo dengan user sistem yang bukan `root`. Misalnya, buat user `odoo` tanpa akses login shell.
Kloning Source Code Odoo:
Gunakan `git clone` untuk mendapatkan source code Odoo dari GitHub ke folder yang tepat (misal: `/opt/odoo/odoo-server`). Pastikan memilih branch sesuai versi Odoo yang diinginkan (misal: `16.0` atau `17.0`).
Install Wkhtmltopdf:
Ini adalah aplikasi eksternal yang dibutuhkan Odoo untuk mengkonversi report ke PDF. Pastikan versi `wkhtmltopdf` yang diinstal kompatibel dengan versi Odoo yang digunakan. Untuk Odoo 16/17, versi 0.12.5 atau 0.12.6 seringkali merupakan pilihan yang aman dan stabil. Instal secara manual dari paket `.deb` resminya.
5. Konfigurasi Odoo
Odoo perlu tahu bagaimana cara terhubung ke database dan pengaturan lainnya.
Buat File Konfigurasi Odoo:
Buat file `odoo.conf` (misal: di `/etc/odoo/odoo.conf`). Di sini Mba Lestari akan mengisi informasi seperti `db_user` (user PostgreSQL yang dibuat sebelumnya), `db_password`, `db_host` (biasanya `localhost`), `addons_path` (penting untuk folder modul kustom), `admin_passwd` (master password untuk membuat database baru dari UI Odoo), `log_level`, dll.
Atur Kepemilikan File:
Pastikan file konfigurasi dan folder Odoo memiliki izin yang benar dan dimiliki oleh user `odoo` yang sudah dibuat.
6. Membuat Service Systemd untuk Odoo
Agar Odoo bisa berjalan otomatis saat server restart dan dikelola dengan mudah, kita buatkan service `systemd`.
Buat File Service:
Buat file `.service` di `/etc/systemd/system/` yang berisi perintah untuk menjalankan Odoo dengan konfigurasi yang sudah dibuat dan sebagai user `odoo`. Pastikan untuk mengarahkan ke Python interpreter di dalam virtual environment dan file `odoo-bin`.
Enable & Start Service:
Setelah file service dibuat, `daemon-reload`, lalu `enable` dan `start` service Odoo agar berjalan di latar belakang. Mba Lestari juga bisa cek statusnya untuk memastikan tidak ada error.
7. Konfigurasi Reverse Proxy (Nginx)
Untuk penggunaan di production atau testing yang lebih menyerupai production, reverse proxy seperti Nginx sangat direkomendasikan.
Manfaat Nginx:
Keamanan: Menyembunyikan port Odoo (`8069`) dari akses langsung.
Performa: Melakukan caching, kompresi, dan mengoptimalkan pengiriman aset statis.
Manajemen SSL/TLS: Memudahkan implementasi HTTPS (enkripsi koneksi).
Load Balancing: Jika nanti skalabilitas diperlukan, Nginx bisa mendistribusikan beban.
Install Nginx:
Instal paket Nginx dari repository Ubuntu.
Konfigurasi Nginx:
Buat file konfigurasi Nginx (misal: di `/etc/nginx/sites-available/odoo.conf`). Konfigurasi ini akan mengarahkan semua request dari port standar HTTP/HTTPS (80/443) ke port Odoo (`8069`) menggunakan `proxy_pass`. Jangan lupa aktifkan konfigurasi ini (symlink ke `sites-enabled`) dan restart Nginx.
8. Pengujian
Setelah semua langkah di atas selesai, Mba Lestari bisa akses Odoo melalui browser menggunakan alamat IP server atau domain yang sudah dikonfigurasi dengan Nginx. Pastikan untuk membuat database awal melalui antarmuka Odoo.
Tips Tambahan:
Firewall: Aktifkan firewall (UFW) dan hanya buka port yang diperlukan (misal: 22 untuk SSH, 80 untuk HTTP, 443 untuk HTTPS). Ini sangat penting untuk keamanan.
Backup: Selalu rencanakan dan lakukan backup database serta folder Odoo secara berkala. Ini sangat krusial, apalagi untuk lingkungan development yang mungkin sering diutak-atik.
Dokumentasi: Selalu merujuk ke dokumentasi resmi Odoo dan komunitas untuk detail command spesifik atau jika ada perubahan di versi terbaru.
Logging: Pantau file log Odoo (`odoo.log`) dan Nginx (`error.log`, `access.log`) untuk memecahkan masalah jika terjadi kendala.
Password Kuat: Gunakan password yang kuat untuk semua akun, baik di PostgreSQL, user Odoo, maupun `admin_passwd` di konfigurasi Odoo.
Semoga pencerahan ini membantu Mba Lestari memulai perjalanan instalasi Odoo dengan lancar ya! Jangan sungkan kalau ada pertanyaan lebih lanjut atau kendala di tengah jalan. Semangat eksplorasinya!
Pertanyaan Mba Lestari ini sangat umum dan penting lho di komunitas Odoo Indonesia. Apalagi untuk tujuan develop dan testing, setup awal yang stabil itu kunci. Jangan khawatir, banyak kok sobat Odoo lain yang sudah melalui fase ini dan siap berbagi pengalaman.
Untuk instalasi Odoo 16 atau 17 di Ubuntu Server, langkah-langkahnya memang ada beberapa tahapan, tapi kalau diikuti dengan benar, hasilnya akan sangat stabil dan efisien. Kita akan pakai metode instalasi dari source code Odoo, karena ini paling fleksibel untuk development dan kustomisasi.
Yuk, kita bahas urutan langkah-langkah yang direkomendasikan beserta hal-hal krusialnya:
1. Persiapan Server & Update Sistem
Pastikan Ubuntu Server Mba Lestari sudah dalam kondisi paling baru. Ini penting untuk keamanan dan kompatibilitas dependensi. Lakukan update dan upgrade sistem terlebih dahulu.
2. Instalasi & Konfigurasi PostgreSQL
Odoo butuh database yang kuat, dan PostgreSQL adalah pasangannya yang paling serasi.
Install PostgreSQL:
Instal paket PostgreSQL dari repository Ubuntu.
Buat User & Database Khusus Odoo:
Ini penting untuk keamanan. Jangan pakai user PostgreSQL default. Buat user baru dengan password yang kuat, lalu buat database yang nanti akan dipakai Odoo. Pastikan user tersebut memiliki hak akses yang cukup untuk mengelola database Odoo.
3. Instalasi Dependensi Python & Lingkungan Virtual (Virtual Environment)
Odoo dibangun dengan Python. Untuk menghindari konflik versi library Python, sangat disarankan menggunakan virtual environment. Ini 'kotak pasir' khusus untuk Odoo Mba Lestari.
Install Python & Tools:
Pastikan Python3 dan `python3-pip` sudah terinstal. Selain itu, beberapa build essential juga dibutuhkan.
Install Dependensi Sistem:
Ada beberapa library sistem yang dibutuhkan Odoo, seperti `libpq-dev`, `libxml2-dev`, `libxslt1-dev`, `libsass-dev`, `libjpeg-dev`, `libfreetype6-dev`, `liblcms2-dev`, `libwebp-dev`, `libharfbuzz-dev`, `libfribidi-dev`, dan `libffi-dev`.
Buat Virtual Environment:
Buat virtual environment di lokasi yang strategis (misal: `/opt/odoo/venv`).
Aktivasi & Instalasi Library Python Odoo:
Setelah virtual environment aktif, instal semua library Python yang dibutuhkan Odoo menggunakan `pip` berdasarkan file `requirements.txt` yang ada di source code Odoo.
4. Instalasi Odoo (dari Source Code)
Ini bagian intinya. Kita akan mengunduh kode Odoo.
Buat User Sistem Khusus Odoo:
Untuk alasan keamanan dan isolasi, jalankan Odoo dengan user sistem yang bukan `root`. Misalnya, buat user `odoo` tanpa akses login shell.
Kloning Source Code Odoo:
Gunakan `git clone` untuk mendapatkan source code Odoo dari GitHub ke folder yang tepat (misal: `/opt/odoo/odoo-server`). Pastikan memilih branch sesuai versi Odoo yang diinginkan (misal: `16.0` atau `17.0`).
Install Wkhtmltopdf:
Ini adalah aplikasi eksternal yang dibutuhkan Odoo untuk mengkonversi report ke PDF. Pastikan versi `wkhtmltopdf` yang diinstal kompatibel dengan versi Odoo yang digunakan. Untuk Odoo 16/17, versi 0.12.5 atau 0.12.6 seringkali merupakan pilihan yang aman dan stabil. Instal secara manual dari paket `.deb` resminya.
5. Konfigurasi Odoo
Odoo perlu tahu bagaimana cara terhubung ke database dan pengaturan lainnya.
Buat File Konfigurasi Odoo:
Buat file `odoo.conf` (misal: di `/etc/odoo/odoo.conf`). Di sini Mba Lestari akan mengisi informasi seperti `db_user` (user PostgreSQL yang dibuat sebelumnya), `db_password`, `db_host` (biasanya `localhost`), `addons_path` (penting untuk folder modul kustom), `admin_passwd` (master password untuk membuat database baru dari UI Odoo), `log_level`, dll.
Atur Kepemilikan File:
Pastikan file konfigurasi dan folder Odoo memiliki izin yang benar dan dimiliki oleh user `odoo` yang sudah dibuat.
6. Membuat Service Systemd untuk Odoo
Agar Odoo bisa berjalan otomatis saat server restart dan dikelola dengan mudah, kita buatkan service `systemd`.
Buat File Service:
Buat file `.service` di `/etc/systemd/system/` yang berisi perintah untuk menjalankan Odoo dengan konfigurasi yang sudah dibuat dan sebagai user `odoo`. Pastikan untuk mengarahkan ke Python interpreter di dalam virtual environment dan file `odoo-bin`.
Enable & Start Service:
Setelah file service dibuat, `daemon-reload`, lalu `enable` dan `start` service Odoo agar berjalan di latar belakang. Mba Lestari juga bisa cek statusnya untuk memastikan tidak ada error.
7. Konfigurasi Reverse Proxy (Nginx)
Untuk penggunaan di production atau testing yang lebih menyerupai production, reverse proxy seperti Nginx sangat direkomendasikan.
Manfaat Nginx:
Keamanan: Menyembunyikan port Odoo (`8069`) dari akses langsung.
Performa: Melakukan caching, kompresi, dan mengoptimalkan pengiriman aset statis.
Manajemen SSL/TLS: Memudahkan implementasi HTTPS (enkripsi koneksi).
Load Balancing: Jika nanti skalabilitas diperlukan, Nginx bisa mendistribusikan beban.
Install Nginx:
Instal paket Nginx dari repository Ubuntu.
Konfigurasi Nginx:
Buat file konfigurasi Nginx (misal: di `/etc/nginx/sites-available/odoo.conf`). Konfigurasi ini akan mengarahkan semua request dari port standar HTTP/HTTPS (80/443) ke port Odoo (`8069`) menggunakan `proxy_pass`. Jangan lupa aktifkan konfigurasi ini (symlink ke `sites-enabled`) dan restart Nginx.
8. Pengujian
Setelah semua langkah di atas selesai, Mba Lestari bisa akses Odoo melalui browser menggunakan alamat IP server atau domain yang sudah dikonfigurasi dengan Nginx. Pastikan untuk membuat database awal melalui antarmuka Odoo.
Tips Tambahan:
Firewall: Aktifkan firewall (UFW) dan hanya buka port yang diperlukan (misal: 22 untuk SSH, 80 untuk HTTP, 443 untuk HTTPS). Ini sangat penting untuk keamanan.
Backup: Selalu rencanakan dan lakukan backup database serta folder Odoo secara berkala. Ini sangat krusial, apalagi untuk lingkungan development yang mungkin sering diutak-atik.
Dokumentasi: Selalu merujuk ke dokumentasi resmi Odoo dan komunitas untuk detail command spesifik atau jika ada perubahan di versi terbaru.
Logging: Pantau file log Odoo (`odoo.log`) dan Nginx (`error.log`, `access.log`) untuk memecahkan masalah jika terjadi kendala.
Password Kuat: Gunakan password yang kuat untuk semua akun, baik di PostgreSQL, user Odoo, maupun `admin_passwd` di konfigurasi Odoo.
Semoga pencerahan ini membantu Mba Lestari memulai perjalanan instalasi Odoo dengan lancar ya! Jangan sungkan kalau ada pertanyaan lebih lanjut atau kendala di tengah jalan. Semangat eksplorasinya!