Tanya: Panduan Install Odoo di Windows (Lokal Server) untuk Development
Diposting pada 07 Mar 2026, 15:15
Halo rekan-rekan praktisi IT dan pengguna Odoo di forum ini,
Saya Lestari, dari tim IT di salah satu perusahaan di Indonesia yang sudah pakai Odoo ERP untuk operasional kami. Saat ini saya sedang mencari panduan atau masukan terbaik mengenai 'how to install Odoo on Windows'.
Tujuannya adalah untuk setup lingkungan development dan testing lokal di laptop saya, sebelum nanti di-deploy ke production server. Saya berencana install Odoo versi terbaru, mungkin Odoo 16 atau Odoo 17. Saya tahu ada opsi pakai all-in-one installer atau instalasi manual dengan Python, PostgreSQL, dan dependensi lainnya.
Nah, menurut pengalaman teman-teman, mana yang paling direkomendasikan untuk keperluan development lokal di Windows? Adakah tips atau langkah-langkah khusus yang perlu diperhatikan agar instalasinya lancar dan minim kendala? Mungkin ada konfigurasi database, dependensi, atau hal-hal lain yang sering menjadi 'jebakan betmen' saat install Odoo di Windows?
Terima kasih banyak sebelumnya atas sharing ilmu dan bantuannya!
Balasan (1)
Halo Kak Lestari! Senang sekali bisa bantu rekan-rekan IT dari komunitas Odoo Indonesia. Salut untuk inisiatifnya dalam menyiapkan lingkungan development dan testing yang solid! Itu langkah yang sangat tepat sebelum naik ke production.
Untuk pertanyaan Kak Lestari mengenai mana yang direkomendasikan antara all-in-one installer atau instalasi manual (Python, PostgreSQL, dependensi lain) untuk keperluan development lokal di Windows, terutama untuk Odoo 16 atau Odoo 17, saya pribadi dan kebanyakan developer Odoo di komunitas ini sangat merekomendasikan instalasi manual.
Yuk kita bahas alasannya dan tipsnya:
Mengapa Instalasi Manual lebih direkomendasikan untuk Development?
1. Kontrol Penuh: Dengan instalasi manual, Kak Lestari punya kontrol penuh atas setiap komponen (versi Python, versi PostgreSQL, library Python, dll.). Ini krusial untuk development karena Kakak mungkin perlu menginstal atau meng-upgrade library tertentu, menyesuaikan konfigurasi, atau bahkan menjalankan beberapa versi Odoo atau modul dengan dependensi yang berbeda.
2. Fleksibilitas Debugging: Saat development, debugging adalah "makanan" sehari-hari. Dengan instalasi manual, Kakak bisa lebih mudah melampirkan debugger ke kode Odoo, memodifikasi source code Odoo langsung, dan memahami bagaimana Odoo bekerja di balik layar.
3. Isolasi Lingkungan: Kakak bisa menggunakan virtual environment (venv) di Python. Ini memastikan dependensi proyek Odoo Kakak tidak bentrok dengan proyek Python lain di laptop, dan sebaliknya.
4. Mirip Lingkungan Produksi: Sebagian besar server produksi Odoo berjalan di Linux, dengan konfigurasi mirip instalasi manual. Membangun lingkungan development yang mirip akan meminimalkan kejutan saat deploy ke produksi.
5. Multipel Odoo Instances: Kalau nanti butuh menjalankan Odoo 16 dan Odoo 17 secara bersamaan di laptop yang sama, instalasi manual (terutama dengan venv dan konfigurasi terpisah) sangat memungkinkan.
Meskipun all-in-one installer sangat cepat dan mudah untuk sekadar coba-coba Odoo, ia kurang fleksibel untuk kebutuhan pengembangan yang serius.
Panduan Singkat Instalasi Manual Odoo (versi 16 atau 17) di Windows untuk Development:
Ini langkah-langkah garis besar yang bisa Kakak ikuti:
1. Instal PostgreSQL
Odoo 16 dan 17 mendukung PostgreSQL versi 14 atau 15.
Unduh installer PostgreSQL dari website resminya. Saat instalasi, pastikan Kakak mengingat password untuk user `postgres` karena ini akan dipakai Odoo untuk terhubung ke database. Biarkan port default (5432).
2. Instal Python
Untuk Odoo 16, gunakan Python 3.10.
Untuk Odoo 17, gunakan Python 3.11.
Unduh installer Python dari website resminya. PENTING: Saat instalasi, centang opsi "Add Python to PATH".
3. Instal `wkhtmltopdf`
Ini diperlukan Odoo untuk generate laporan PDF. Cari versi 0.12.5 atau 0.12.6. Untuk Windows, ada beberapa versi yang bisa jadi lebih stabil (misalnya versi tanpa 'msvc'). Pastikan versi yang diunduh adalah yang sesuai dengan arsitektur sistem Kakak (32-bit atau 64-bit).
Setelah diinstal, catat path instalasinya karena akan dipakai di file konfigurasi Odoo.
4. Instal Node.js dan NPM
Ini diperlukan Odoo untuk mengkompilasi aset frontend (seperti LESS/SASS). Unduh installer dari website resminya. Ini juga sudah otomatis menambahkan ke PATH.
5. Clone Source Code Odoo
Gunakan Git untuk meng-clone repositori Odoo dari GitHub.
`git clone https://github.com/odoo/odoo.git -b 16.0` (untuk Odoo 16)
`git clone https://github.com/odoo/odoo.git -b 17.0` (untuk Odoo 17)
Ganti `-b 16.0` atau `-b 17.0` sesuai versi yang diinginkan.
6. Siapkan Virtual Environment (venv)
Buka Command Prompt atau PowerShell, navigasi ke folder Odoo yang baru di-clone.
`python -m venv venv`
Aktifkan venv: `.venvScriptsactivate` (di Windows PowerShell) atau `venvScriptsactivate.bat` (di Command Prompt).
Setelah aktif, di prompt akan muncul `(venv)` di depannya.
7. Instal Dependensi Python
Di dalam venv yang aktif:
`pip install wheel` (penting untuk beberapa library agar tidak error saat compile)
`pip install -r requirements.txt`
Ini mungkin akan memakan waktu dan mengunduh banyak library. Jebakan Betmen di sini sering terjadi pada library seperti `psycopg2-binary` (pastikan ada `-binary`) atau `lxml`. Jika ada error terkait kompilasi C++, Kakak mungkin perlu menginstal "Build Tools for Visual Studio" dari Microsoft.
8. Instal Dependensi Node.js
Masih di folder Odoo:
`npm install -g less less-plugin-clean-css` (atau `sass` jika Odoo versi baru banyak menggunakan sass).
9. Buat File Konfigurasi Odoo (`odoo.conf`)
Di folder Odoo, buat file `odoo.conf`. Isi minimal seperti ini:
```ini
[options]
addons_path = C:pathkeodooaddons,C:pathkecustomaddons
data_dir = C:pathkeodoodata_dir
db_host = localhost
db_port = 5432
db_user = postgres
db_password = your_postgres_password
proxy_mode = True ; Jika Kakak menggunakan reverse proxy atau Odoo di belakang Nginx/Apache
admin_passwd = your_admin_password ; Ubah ini agar tidak default
limit_time_cpu = 600 ; Contoh: 10 menit
limit_time_real = 1200 ; Contoh: 20 menit
log_level = info
log_handler = :INFO
; Path wkhtmltopdf (penting!)
; html_to_pdf_converter = C:Program Fileswkhtmltopdfbinwkhtmltopdf.exe
```
Sesuaikan `addons_path` ke folder `addons` di source code Odoo dan tambahkan juga path untuk modul custom Kakak (jika ada).
Isi `db_password` dengan password user `postgres` yang Kakak buat.
Aktifkan `html_to_pdf_converter` dengan path yang benar ke `wkhtmltopdf.exe`.
10. Jalankan Odoo!
Pastikan venv masih aktif.
`python odoo-bin -c odoo.conf`
Buka browser dan akses `localhost:8069`. Kakak akan diminta membuat database pertama.
Tips dan "Jebakan Betmen" Tambahan:
Versi `wkhtmltopdf`: Ini sering jadi masalah. Versi 0.12.5 atau 0.12.6 adalah yang paling sering direkomendasikan. Pastikan juga ia ada di PATH atau Kakak definisikan secara eksplisit di `odoo.conf`.
PostgreSQL Password: Jangan sampai lupa, dan jangan gunakan password default yang lemah.
Permissions: Pastikan user Windows Kakak memiliki izin penuh untuk membaca dan menulis di folder instalasi Odoo dan `data_dir`.
Firewall: Pastikan Firewall Windows tidak memblokir port 5432 (PostgreSQL) dan 8069 (Odoo).
Error Log: Jika Odoo tidak mau jalan, selalu cek output di Command Prompt/PowerShell dan kalau Kakak sudah setting, cek juga file log Odoo (misalnya di `data_dir/odoo.log`). Pesan error di sana sangat membantu.
Build Tools untuk Python: Seperti yang disebutkan, untuk beberapa library Python (terutama yang punya binding C seperti `lxml` atau `psycopg2` jika bukan versi `-binary`), instalasi di Windows bisa membutuhkan Visual C++ Build Tools. Ini bisa diunduh gratis dari Microsoft.
Alternatif Lebih Lanjut (Docker): Untuk development yang lebih profesional dan terisolasi, banyak developer Odoo beralih ke Docker. Ini memang sedikit lebih kompleks di awal, tapi memberikan lingkungan yang sangat konsisten, terisolasi, dan mudah dibawa-bawa (portabel). Mungkin bisa jadi opsi Kakak nanti setelah terbiasa dengan instalasi manual ini.
Semoga panduan ini membantu Kak Lestari dalam membangun lingkungan development Odoo di laptopnya ya! Kalau ada kendala di tengah jalan, jangan sungkan bertanya lagi di forum. Semangat!
Untuk pertanyaan Kak Lestari mengenai mana yang direkomendasikan antara all-in-one installer atau instalasi manual (Python, PostgreSQL, dependensi lain) untuk keperluan development lokal di Windows, terutama untuk Odoo 16 atau Odoo 17, saya pribadi dan kebanyakan developer Odoo di komunitas ini sangat merekomendasikan instalasi manual.
Yuk kita bahas alasannya dan tipsnya:
Mengapa Instalasi Manual lebih direkomendasikan untuk Development?
1. Kontrol Penuh: Dengan instalasi manual, Kak Lestari punya kontrol penuh atas setiap komponen (versi Python, versi PostgreSQL, library Python, dll.). Ini krusial untuk development karena Kakak mungkin perlu menginstal atau meng-upgrade library tertentu, menyesuaikan konfigurasi, atau bahkan menjalankan beberapa versi Odoo atau modul dengan dependensi yang berbeda.
2. Fleksibilitas Debugging: Saat development, debugging adalah "makanan" sehari-hari. Dengan instalasi manual, Kakak bisa lebih mudah melampirkan debugger ke kode Odoo, memodifikasi source code Odoo langsung, dan memahami bagaimana Odoo bekerja di balik layar.
3. Isolasi Lingkungan: Kakak bisa menggunakan virtual environment (venv) di Python. Ini memastikan dependensi proyek Odoo Kakak tidak bentrok dengan proyek Python lain di laptop, dan sebaliknya.
4. Mirip Lingkungan Produksi: Sebagian besar server produksi Odoo berjalan di Linux, dengan konfigurasi mirip instalasi manual. Membangun lingkungan development yang mirip akan meminimalkan kejutan saat deploy ke produksi.
5. Multipel Odoo Instances: Kalau nanti butuh menjalankan Odoo 16 dan Odoo 17 secara bersamaan di laptop yang sama, instalasi manual (terutama dengan venv dan konfigurasi terpisah) sangat memungkinkan.
Meskipun all-in-one installer sangat cepat dan mudah untuk sekadar coba-coba Odoo, ia kurang fleksibel untuk kebutuhan pengembangan yang serius.
Panduan Singkat Instalasi Manual Odoo (versi 16 atau 17) di Windows untuk Development:
Ini langkah-langkah garis besar yang bisa Kakak ikuti:
1. Instal PostgreSQL
Odoo 16 dan 17 mendukung PostgreSQL versi 14 atau 15.
Unduh installer PostgreSQL dari website resminya. Saat instalasi, pastikan Kakak mengingat password untuk user `postgres` karena ini akan dipakai Odoo untuk terhubung ke database. Biarkan port default (5432).
2. Instal Python
Untuk Odoo 16, gunakan Python 3.10.
Untuk Odoo 17, gunakan Python 3.11.
Unduh installer Python dari website resminya. PENTING: Saat instalasi, centang opsi "Add Python to PATH".
3. Instal `wkhtmltopdf`
Ini diperlukan Odoo untuk generate laporan PDF. Cari versi 0.12.5 atau 0.12.6. Untuk Windows, ada beberapa versi yang bisa jadi lebih stabil (misalnya versi tanpa 'msvc'). Pastikan versi yang diunduh adalah yang sesuai dengan arsitektur sistem Kakak (32-bit atau 64-bit).
Setelah diinstal, catat path instalasinya karena akan dipakai di file konfigurasi Odoo.
4. Instal Node.js dan NPM
Ini diperlukan Odoo untuk mengkompilasi aset frontend (seperti LESS/SASS). Unduh installer dari website resminya. Ini juga sudah otomatis menambahkan ke PATH.
5. Clone Source Code Odoo
Gunakan Git untuk meng-clone repositori Odoo dari GitHub.
`git clone https://github.com/odoo/odoo.git -b 16.0` (untuk Odoo 16)
`git clone https://github.com/odoo/odoo.git -b 17.0` (untuk Odoo 17)
Ganti `-b 16.0` atau `-b 17.0` sesuai versi yang diinginkan.
6. Siapkan Virtual Environment (venv)
Buka Command Prompt atau PowerShell, navigasi ke folder Odoo yang baru di-clone.
`python -m venv venv`
Aktifkan venv: `.venvScriptsactivate` (di Windows PowerShell) atau `venvScriptsactivate.bat` (di Command Prompt).
Setelah aktif, di prompt akan muncul `(venv)` di depannya.
7. Instal Dependensi Python
Di dalam venv yang aktif:
`pip install wheel` (penting untuk beberapa library agar tidak error saat compile)
`pip install -r requirements.txt`
Ini mungkin akan memakan waktu dan mengunduh banyak library. Jebakan Betmen di sini sering terjadi pada library seperti `psycopg2-binary` (pastikan ada `-binary`) atau `lxml`. Jika ada error terkait kompilasi C++, Kakak mungkin perlu menginstal "Build Tools for Visual Studio" dari Microsoft.
8. Instal Dependensi Node.js
Masih di folder Odoo:
`npm install -g less less-plugin-clean-css` (atau `sass` jika Odoo versi baru banyak menggunakan sass).
9. Buat File Konfigurasi Odoo (`odoo.conf`)
Di folder Odoo, buat file `odoo.conf`. Isi minimal seperti ini:
```ini
[options]
addons_path = C:pathkeodooaddons,C:pathkecustomaddons
data_dir = C:pathkeodoodata_dir
db_host = localhost
db_port = 5432
db_user = postgres
db_password = your_postgres_password
proxy_mode = True ; Jika Kakak menggunakan reverse proxy atau Odoo di belakang Nginx/Apache
admin_passwd = your_admin_password ; Ubah ini agar tidak default
limit_time_cpu = 600 ; Contoh: 10 menit
limit_time_real = 1200 ; Contoh: 20 menit
log_level = info
log_handler = :INFO
; Path wkhtmltopdf (penting!)
; html_to_pdf_converter = C:Program Fileswkhtmltopdfbinwkhtmltopdf.exe
```
Sesuaikan `addons_path` ke folder `addons` di source code Odoo dan tambahkan juga path untuk modul custom Kakak (jika ada).
Isi `db_password` dengan password user `postgres` yang Kakak buat.
Aktifkan `html_to_pdf_converter` dengan path yang benar ke `wkhtmltopdf.exe`.
10. Jalankan Odoo!
Pastikan venv masih aktif.
`python odoo-bin -c odoo.conf`
Buka browser dan akses `localhost:8069`. Kakak akan diminta membuat database pertama.
Tips dan "Jebakan Betmen" Tambahan:
Versi `wkhtmltopdf`: Ini sering jadi masalah. Versi 0.12.5 atau 0.12.6 adalah yang paling sering direkomendasikan. Pastikan juga ia ada di PATH atau Kakak definisikan secara eksplisit di `odoo.conf`.
PostgreSQL Password: Jangan sampai lupa, dan jangan gunakan password default yang lemah.
Permissions: Pastikan user Windows Kakak memiliki izin penuh untuk membaca dan menulis di folder instalasi Odoo dan `data_dir`.
Firewall: Pastikan Firewall Windows tidak memblokir port 5432 (PostgreSQL) dan 8069 (Odoo).
Error Log: Jika Odoo tidak mau jalan, selalu cek output di Command Prompt/PowerShell dan kalau Kakak sudah setting, cek juga file log Odoo (misalnya di `data_dir/odoo.log`). Pesan error di sana sangat membantu.
Build Tools untuk Python: Seperti yang disebutkan, untuk beberapa library Python (terutama yang punya binding C seperti `lxml` atau `psycopg2` jika bukan versi `-binary`), instalasi di Windows bisa membutuhkan Visual C++ Build Tools. Ini bisa diunduh gratis dari Microsoft.
Alternatif Lebih Lanjut (Docker): Untuk development yang lebih profesional dan terisolasi, banyak developer Odoo beralih ke Docker. Ini memang sedikit lebih kompleks di awal, tapi memberikan lingkungan yang sangat konsisten, terisolasi, dan mudah dibawa-bawa (portabel). Mungkin bisa jadi opsi Kakak nanti setelah terbiasa dengan instalasi manual ini.
Semoga panduan ini membantu Kak Lestari dalam membangun lingkungan development Odoo di laptopnya ya! Kalau ada kendala di tengah jalan, jangan sungkan bertanya lagi di forum. Semangat!