Minta Saran: Setup dan Menjalankan Odoo via PyCharm untuk Debugging/Dev
Diposting pada 30 May 2026, 19:53
Halo rekan-rekan komunitas Odoo di sini!
Saya Ridwan, dari tim IT salah satu perusahaan di Indonesia yang kebetulan pakai Odoo ERP juga. Saat ini lagi eksplorasi untuk pengembangan modul custom dan debugging yang lebih efektif.
Biasanya saya jalankan Odoo lewat terminal dengan `odoo-bin` atau `docker-compose`. Nah, belakangan ini kepikiran untuk coba setup dan run Odoo langsung dari PyCharm. Tujuannya biar proses debugging, penulisan kode, dan testing modul baru jadi lebih seamless dan terintegrasi di satu IDE.
Saya sudah coba-coba sedikit dengan konfigurasi `Run/Debug Configurations` di PyCharm, tapi masih bingung mana cara yang paling proper dan efisien, terutama untuk Odoo versi terbaru (misal Odoo 15/16).
Ada rekan-rekan di sini yang punya pengalaman atau best practices dalam meng-"compile" atau lebih tepatnya menjalankan Odoo dari PyCharm? Mungkin ada tips soal konfigurasi interpreter, working directory, parameters apa saja yang perlu dimasukkan (misal `--config`, `--addons-path`), atau environment variables yang krusial?
Mungkin ada juga yang bisa berbagi step-by-step singkatnya? Khawatir ada pitfall yang sering terjadi kalau salah konfigurasi.
Terima kasih banyak sebelumnya atas pencerahannya!
Balasan (1)
Halo Mas Ridwan!
Wah, ide cemerlang banget nih untuk menjalankan Odoo langsung dari PyCharm. Sebagai praktisi dan moderator di komunitas Odoo Indonesia, saya bisa bilang kalau PyCharm itu 'best friend' para developer Odoo. Fitur debugging yang seamless, autocomplete, dan integrasi dengan version control bakal bikin proses pengembangan modul custom dan troubleshooting jadi jauh lebih efisien.
Ini memang salah satu setup yang paling direkomendasikan untuk development Odoo, apalagi di versi terbaru seperti Odoo 15/16. Yuk, kita bedah step-by-stepnya biar makin lancar jaya!
### Persiapan Awal (Asumsi Mas Ridwan Sudah Punya Ini)
1. Source Code Odoo: Pastikan Mas Ridwan sudah punya clone repository Odoo di lokal (misalnya dari GitHub).
2. Virtual Environment Python: Sangat disarankan untuk membuat virtual environment (misal pakai `venv` atau `virtualenv`) khusus untuk project Odoo ini. Ini untuk mengisolasi dependensi Odoo dari Python sistem global. Install semua dependensi Python Odoo ke dalam virtual environment ini.
3. PostgreSQL: Pastikan database PostgreSQL sudah running dan bisa diakses.
### Step-by-Step Setup di PyCharm
Gini Mas, ada beberapa langkah yang perlu kita set-up di PyCharm agar Odoo bisa 'ngacir' dari IDE ini:
#### 1. Buka Project Odoo di PyCharm
Di PyCharm, pilih File > Open....
Pilih folder root dari instalasi Odoo Mas Ridwan (misal: `/opt/odoo/odoo-16` atau `~/projects/odoo/odoo-16`).
#### 2. Konfigurasi Python Interpreter
Pergi ke File > Settings/Preferences > Project: [Nama Proyek Odoo Anda] > Python Interpreter.
Klik ikon gerigi (Settings) di pojok kanan atas daftar interpreter, lalu pilih Add....
Pilih Virtualenv Environment (atau Conda Environment jika Mas Ridwan pakai Conda).
Pilih Existing environment dan arahkan ke path interpreter Python di virtual environment Odoo Mas Ridwan (misal: `/home/ridwan/odoo_venv/bin/python`).
Klik OK. PyCharm akan mengindeks semua library yang terinstall di virtual environment tersebut.
#### 3. Buat Run/Debug Configuration (Ini Dia Bagian Jantungnya!)
Ini dia nih, bagian 'jantung' konfigurasi kita. Ini yang akan memberitahu PyCharm bagaimana cara menjalankan Odoo.
Pergi ke Run > Edit Configurations....
Klik tanda + (Add New Configuration) di pojok kiri atas, lalu pilih Python.
Isi detail konfigurasinya seperti ini:
Name: Beri nama yang deskriptif, contoh:
Script path: Arahkan ke file
Parameters: Ini krusial! Ini sama seperti argumen yang Mas Ridwan masukkan di terminal.
Working directory: Ini SANGAT PENTING! Arahkan ke root directory dari instalasi Odoo Mas Ridwan (misal: `/opt/odoo/odoo-16`). Jika ini salah, Odoo tidak akan bisa menemukan modul-modul intinya atau file konfigurasi dengan benar. Pastikan ini betul ya, Mas!
Python interpreter: Pastikan sudah terpilih interpreter dari virtual environment yang sudah dikonfigurasi di langkah sebelumnya.
Environment variables: (Opsional) Masukkan
Klik Apply lalu OK.
### Tips Tambahan Biar Makin Nampol!
Manfaatkan `odoo.conf`: Daripada menulis semua parameter di PyCharm, lebih baik gunakan file `odoo.conf`. Di sana Mas Ridwan bisa mengatur `db_host`, `db_port`, `http_port`, `log_level`, dan lain-lain. Lalu di PyCharm, cukup panggil `odoo-bin -c /path/to/your/odoo.conf --addons-path ...`.
Debugging: Setelah konfigurasi, Mas Ridwan bisa menekan ikon 'bug' (Debug) untuk menjalankan Odoo. Set breakpoints (titik merah di samping nomor baris kode) di kode Python Mas Ridwan. Saat eksekusi mencapai breakpoint, Odoo akan berhenti, dan Mas Ridwan bisa memeriksa nilai variabel, melangkah baris per baris (step over, step into), dan fitur debugging canggih lainnya.
Multiple Configurations: Mas Ridwan bisa membuat beberapa konfigurasi. Misalnya, satu untuk debugging dengan database test, satu lagi untuk menjalankan server saja tanpa debugging.
Update Modul: Untuk update modul setelah ada perubahan, cukup tambahkan parameter `-u nama_modul_anda` atau `-u all` (untuk semua) di bagian Parameters di Run/Debug Configuration, lalu jalankan. Setelah selesai, hapus lagi parameter `-u` untuk menghindari update terus-menerus.
### Awas, Jangan Sampai Kejeblos di Lubang Ini! (Common Pitfalls)
1. Working Directory Salah: Ini yang paling sering bikin pusing. Pastikan `Working directory` mengarah ke root folder Odoo (`/path/to/odoo-16/`).
2. Interpreter Salah: Pastikan PyCharm menggunakan virtual environment yang benar yang sudah terinstall semua dependensi Odoo.
3. `odoo-bin` Tidak Ditemukan: `Script path` harus benar-benar menunjuk ke file `odoo-bin`, bukan folder atau file lain.
4. Missing Dependencies: Jika ada error `ModuleNotFoundError`, berarti ada dependensi Python yang belum terinstall di virtual environment Mas Ridwan.
5. Database Connection: Pastikan parameter database di `odoo.conf` atau di PyCharm sudah benar (nama database, username, password, host, port).
Dengan setup ini, Mas Ridwan akan merasakan betapa nyamannya mengembangkan dan mendebug modul Odoo. Selamat mencoba ya, Mas Ridwan! Kalau ada kendala di tengah jalan, jangan sungkan untuk bertanya lagi di sini.
Semangat terus Mas Ridwan, sukses selalu!
Wah, ide cemerlang banget nih untuk menjalankan Odoo langsung dari PyCharm. Sebagai praktisi dan moderator di komunitas Odoo Indonesia, saya bisa bilang kalau PyCharm itu 'best friend' para developer Odoo. Fitur debugging yang seamless, autocomplete, dan integrasi dengan version control bakal bikin proses pengembangan modul custom dan troubleshooting jadi jauh lebih efisien.
Ini memang salah satu setup yang paling direkomendasikan untuk development Odoo, apalagi di versi terbaru seperti Odoo 15/16. Yuk, kita bedah step-by-stepnya biar makin lancar jaya!
### Persiapan Awal (Asumsi Mas Ridwan Sudah Punya Ini)
1. Source Code Odoo: Pastikan Mas Ridwan sudah punya clone repository Odoo di lokal (misalnya dari GitHub).
2. Virtual Environment Python: Sangat disarankan untuk membuat virtual environment (misal pakai `venv` atau `virtualenv`) khusus untuk project Odoo ini. Ini untuk mengisolasi dependensi Odoo dari Python sistem global. Install semua dependensi Python Odoo ke dalam virtual environment ini.
3. PostgreSQL: Pastikan database PostgreSQL sudah running dan bisa diakses.
### Step-by-Step Setup di PyCharm
Gini Mas, ada beberapa langkah yang perlu kita set-up di PyCharm agar Odoo bisa 'ngacir' dari IDE ini:
#### 1. Buka Project Odoo di PyCharm
Di PyCharm, pilih File > Open....
Pilih folder root dari instalasi Odoo Mas Ridwan (misal: `/opt/odoo/odoo-16` atau `~/projects/odoo/odoo-16`).
#### 2. Konfigurasi Python Interpreter
Pergi ke File > Settings/Preferences > Project: [Nama Proyek Odoo Anda] > Python Interpreter.
Klik ikon gerigi (Settings) di pojok kanan atas daftar interpreter, lalu pilih Add....
Pilih Virtualenv Environment (atau Conda Environment jika Mas Ridwan pakai Conda).
Pilih Existing environment dan arahkan ke path interpreter Python di virtual environment Odoo Mas Ridwan (misal: `/home/ridwan/odoo_venv/bin/python`).
Klik OK. PyCharm akan mengindeks semua library yang terinstall di virtual environment tersebut.
#### 3. Buat Run/Debug Configuration (Ini Dia Bagian Jantungnya!)
Ini dia nih, bagian 'jantung' konfigurasi kita. Ini yang akan memberitahu PyCharm bagaimana cara menjalankan Odoo.
Pergi ke Run > Edit Configurations....
Klik tanda + (Add New Configuration) di pojok kiri atas, lalu pilih Python.
Isi detail konfigurasinya seperti ini:
Name: Beri nama yang deskriptif, contoh:
Odoo 16 Dev atau Odoo Debugging.Script path: Arahkan ke file
odoo-bin yang ada di root folder Odoo Mas Ridwan. Contoh: /opt/odoo/odoo-16/odoo-bin.Parameters: Ini krusial! Ini sama seperti argumen yang Mas Ridwan masukkan di terminal.
-c /path/to/your/odoo.conf: Ini sangat direkomendasikan. Buat file konfigurasi Odoo (`odoo.conf`) terpisah untuk development di PyCharm, yang berisi detail seperti database connection, port, log level, dll. Contoh: -c /home/ridwan/odoo_config/odoo16_dev.conf.--addons-path /path/to/odoo/addons,/path/to/your/custom_addons: Masukkan semua path addons yang ingin dimuat oleh Odoo, dipisahkan koma. Pastikan ini mencakup folder addons bawaan Odoo dan juga folder custom_addons Mas Ridwan.--dev=all: Ini sangat membantu untuk pengembangan. Akan mengaktifkan fitur seperti auto-reload XML/JS/Python, QWeb editor, dll.--db-filter=your_database_name: Opsional, tapi berguna jika Mas Ridwan hanya bekerja dengan satu database, Odoo akan langsung memilihnya.--limit-time-real=120 --limit-time-cpu=120: Berguna untuk mencegah timeout pada operasi yang panjang saat debugging.--log-level=debug: Untuk mendapatkan log yang lebih detail di console PyCharm.Working directory: Ini SANGAT PENTING! Arahkan ke root directory dari instalasi Odoo Mas Ridwan (misal: `/opt/odoo/odoo-16`). Jika ini salah, Odoo tidak akan bisa menemukan modul-modul intinya atau file konfigurasi dengan benar. Pastikan ini betul ya, Mas!
Python interpreter: Pastikan sudah terpilih interpreter dari virtual environment yang sudah dikonfigurasi di langkah sebelumnya.
Environment variables: (Opsional) Masukkan
PYTHONUNBUFFERED=1. Ini memastikan output langsung muncul di console PyCharm tanpa buffering.Klik Apply lalu OK.
### Tips Tambahan Biar Makin Nampol!
Manfaatkan `odoo.conf`: Daripada menulis semua parameter di PyCharm, lebih baik gunakan file `odoo.conf`. Di sana Mas Ridwan bisa mengatur `db_host`, `db_port`, `http_port`, `log_level`, dan lain-lain. Lalu di PyCharm, cukup panggil `odoo-bin -c /path/to/your/odoo.conf --addons-path ...`.
Debugging: Setelah konfigurasi, Mas Ridwan bisa menekan ikon 'bug' (Debug) untuk menjalankan Odoo. Set breakpoints (titik merah di samping nomor baris kode) di kode Python Mas Ridwan. Saat eksekusi mencapai breakpoint, Odoo akan berhenti, dan Mas Ridwan bisa memeriksa nilai variabel, melangkah baris per baris (step over, step into), dan fitur debugging canggih lainnya.
Multiple Configurations: Mas Ridwan bisa membuat beberapa konfigurasi. Misalnya, satu untuk debugging dengan database test, satu lagi untuk menjalankan server saja tanpa debugging.
Update Modul: Untuk update modul setelah ada perubahan, cukup tambahkan parameter `-u nama_modul_anda` atau `-u all` (untuk semua) di bagian Parameters di Run/Debug Configuration, lalu jalankan. Setelah selesai, hapus lagi parameter `-u` untuk menghindari update terus-menerus.
### Awas, Jangan Sampai Kejeblos di Lubang Ini! (Common Pitfalls)
1. Working Directory Salah: Ini yang paling sering bikin pusing. Pastikan `Working directory` mengarah ke root folder Odoo (`/path/to/odoo-16/`).
2. Interpreter Salah: Pastikan PyCharm menggunakan virtual environment yang benar yang sudah terinstall semua dependensi Odoo.
3. `odoo-bin` Tidak Ditemukan: `Script path` harus benar-benar menunjuk ke file `odoo-bin`, bukan folder atau file lain.
4. Missing Dependencies: Jika ada error `ModuleNotFoundError`, berarti ada dependensi Python yang belum terinstall di virtual environment Mas Ridwan.
5. Database Connection: Pastikan parameter database di `odoo.conf` atau di PyCharm sudah benar (nama database, username, password, host, port).
Dengan setup ini, Mas Ridwan akan merasakan betapa nyamannya mengembangkan dan mendebug modul Odoo. Selamat mencoba ya, Mas Ridwan! Kalau ada kendala di tengah jalan, jangan sungkan untuk bertanya lagi di sini.
Semangat terus Mas Ridwan, sukses selalu!