Diskusi Santai: Cara Install Modul di Odoo, Mohon Pencerahan!
Diposting pada 23 Mar 2026, 00:42
Halo teman-teman praktisi Odoo di sini, saya Siska dari tim IT.
Kami lagi seru-serunya nih eksplorasi Odoo ERP, dan sekarang kami dihadapkan sama kebutuhan untuk instalasi modul. Kalau modul yang ada di Odoo Apps Store atau yang built-in sih udah familiar. Nah, tantangannya sekarang, kami butuh menginstal modul custom atau dari pihak ketiga.
Biasanya, 'workflow' yang paling 'best practice' untuk instalasi modul-modul semacam ini itu gimana ya? Mohon pencerahannya untuk langkah-langkahnya:
1. Penempatan File: Modulnya sebaiknya diletakkan di direktori mana agar rapi, aman, dan mudah di-manage (misal, di dalam `addons` atau ada folder khusus lain)?
2. Deteksi Modul: Bagaimana cara membuat Odoo mendeteksi modul baru yang sudah diletakkan? (Apakah perlu restart service, update daftar aplikasi, dll.?)
3. Instalasi: Setelah terdeteksi, langkah-langkah untuk menginstalnya di dalam Odoo seperti apa?
4. Hal Penting Lainnya: Ada tips-tips terkait dependensi antar modul, cara update database kalau ada perubahan struktur, atau 'do's and don'ts' yang sering ditemui saat instalasi modul custom ini?
Mungkin ada rekan-rekan yang punya pengalaman dan bisa share 'gotchas' atau hal-hal krusial yang perlu diperhatikan?
Terima kasih banyak lho sebelumnya atas sharing ilmunya!
Balasan (1)
Halo Kak Siska dan tim IT! Wah, senang sekali mendengar kalian lagi seru-serunya eksplorasi Odoo ERP. Mantap! Memang Odoo itu seperti lautan ilmu, makin diselami makin banyak hal menarik yang bisa ditemukan. Pertanyaan tentang instalasi modul custom ini sangat relevan dan sering banget jadi bahasan penting di komunitas kita.
Yuk, kita bedah satu per satu "workflow" terbaik untuk instalasi modul custom atau dari pihak ketiga agar rapi, aman, dan mudah di-manage.
### 1. Penempatan File Modul
Untuk penempatan file modul custom, ada beberapa pendekatan, tapi yang paling direkomendasikan adalah:
Direktori `addons` internal (kurang disarankan untuk custom): Secara default, Odoo akan mencari modul di direktori `addons` yang ada di instalasi Odoo kalian. Namun, menaruh modul custom di sini kurang disarankan karena berisiko terhapus atau tertimpa saat kalian melakukan upgrade Odoo di masa depan.
Direktori `custom_addons` terpisah (paling disarankan): Ini adalah praktik terbaik. Buatlah sebuah folder baru di luar direktori instalasi Odoo kalian, misalnya `custom_addons` (nama bisa disesuaikan, bebas). Di dalam folder inilah semua modul custom atau modul pihak ketiga yang kalian unduh bisa diletakkan.
Kenapa harus di luar?
Ini akan menjaga instalasi Odoo inti kalian tetap "bersih". Saat ada update Odoo yang besar (misalnya dari Odoo 15 ke 16), kalian tidak perlu khawatir modul custom kalian hilang atau konflik dengan file Odoo bawaan. Kalian hanya perlu memastikan modul custom tersebut kompatibel dengan versi Odoo yang baru.
Setelah membuat folder `custom_addons` dan menaruh modul di sana, kalian perlu memberi tahu Odoo di mana modul-modul ini berada. Caranya adalah dengan mengedit file `odoo.conf` (atau nama file konfigurasi Odoo lainnya yang kalian gunakan). Cari parameter `addons_path` dan tambahkan path ke folder `custom_addons` tersebut.
Contoh di `odoo.conf`:
```ini
addons_path = /path/to/your/odoo/addons, /path/to/your/custom_addons_folder
```
Pastikan path-nya dipisahkan dengan koma (`,`) dan tanpa spasi di antaranya jika ada lebih dari satu path. Urutan juga bisa mempengaruhi, Odoo akan membaca dari kiri ke kanan.
### 2. Deteksi Modul Baru
Setelah file modul diletakkan di `custom_addons` dan path-nya sudah ditambahkan di `odoo.conf`, Odoo perlu diberi tahu bahwa ada modul baru.
1. Restart Odoo Service: Ini adalah langkah penting dan mutlak. Setiap kali kalian mengubah `addons_path` di `odoo.conf` atau menambahkan file modul baru ke salah satu direktori `addons_path`, kalian wajib merestart service Odoo agar konfigurasi dan modul baru terdeteksi. Tanpa ini, Odoo tidak akan "melihat" modul yang baru kalian tambahkan.
2. Aktifkan Developer Mode: Di Odoo, buka bagian "Settings" (Pengaturan). Gulir ke bawah dan cari opsi untuk mengaktifkan Developer Mode (atau `Debug Mode`). Biasanya ada di bagian paling bawah.
3. Update Apps List: Setelah Developer Mode aktif, kembali ke menu "Apps" (Aplikasi). Di sana akan muncul opsi "Update Apps List" atau "Update Module List". Klik opsi ini. Odoo akan memindai semua folder di `addons_path` dan mendaftarkan modul-modul baru yang ditemukannya ke dalam database.
### 3. Instalasi Modul
Setelah modul terdeteksi dan muncul di daftar aplikasi:
1. Cari Modul: Di menu "Apps", kalian bisa mencari nama modul yang baru saja kalian letakkan. Jika sudah terdeteksi, modul tersebut akan muncul di daftar.
2. Klik Tombol "Install": Temukan modulnya, lalu klik tombol "Install" yang ada di kartu modul tersebut. Odoo akan secara otomatis menginstal modul beserta dependensi yang dibutuhkannya (jika ada dan sudah tersedia).
### 4. Hal Penting Lainnya & Gotchas
Ini adalah bagian krusial yang sering jadi "jebakan Batman" kalau tidak diperhatikan:
Dependensi Antar Modul:
Setiap modul Odoo memiliki file `__manifest__.py`. Di dalam file ini ada bagian `depends` yang berisi daftar modul Odoo lain yang harus terinstal agar modul tersebut bisa bekerja.
Odoo biasanya cukup pintar untuk menginstal dependensi secara otomatis. Namun, pastikan semua modul yang menjadi dependensi sudah ada di `addons_path` kalian. Jika ada dependensi yang belum ada atau versi yang tidak cocok, instalasi bisa gagal dengan pesan error.
Selalu cek `__manifest__.py` jika ada masalah instalasi untuk melihat dependensi yang dibutuhkan.
Update Database saat Perubahan Struktur:
Jika kalian hanya mengubah kode Python dalam modul (misalnya, logika fungsi atau metode), cukup restart service Odoo.
Jika kalian mengubah definisi model, menambah/mengubah field baru, mengubah view (XML), mengubah data (`.csv` atau `.xml` untuk demo data/security rules), atau mengubah struktur database lainnya, maka modul tersebut harus di-upgrade.
Cara meng-upgrade: Aktifkan Developer Mode, pergi ke menu "Apps", cari modul yang ingin di-upgrade, lalu klik tombol "Upgrade" (biasanya ikon panah melingkar). Ini akan membuat Odoo membaca kembali file-file modul dan menerapkan perubahan ke database.
Untuk kebutuhan pengembangan, kalian juga bisa meng-upgrade modul melalui command line saat memulai service Odoo dengan opsi `-u`:
```bash
odoo-bin -c /path/to/odoo.conf -u nama_modul_anda
```
Ini sangat membantu untuk mempercepat proses pengembangan.
Do's and Don'ts / Gotchas:
DO: Selalu Uji di Lingkungan Development/Staging. Jangan pernah langsung menginstal atau meng-upgrade modul custom di server produksi tanpa pengujian menyeluruh di lingkungan terpisah. Ini untuk mencegah masalah tak terduga yang bisa mengganggu operasional bisnis.
DO: Backup Database. Sebelum menginstal modul besar, modul penting, atau melakukan upgrade modul di server produksi, selalu lakukan backup database terlebih dahulu. Ini adalah jaring pengaman terbaik jika terjadi hal yang tidak diinginkan.
DO: Perhatikan Kompatibilitas Versi. Pastikan modul custom yang kalian unduh kompatibel dengan versi Odoo yang kalian gunakan. Modul yang dibuat untuk Odoo 15 mungkin tidak akan berfungsi dengan baik (atau bahkan tidak bisa diinstal) di Odoo 16 tanpa penyesuaian.
DO: Periksa Dependensi Python Eksternal. Beberapa modul mungkin memerlukan library Python tambahan yang tidak disertakan dalam instalasi Odoo standar. Pastikan untuk menginstal dependensi ini ke lingkungan Python Odoo kalian (`pip install nama_library`).
DON'T: Memodifikasi File Core Odoo. Hindari mengubah file-file di direktori `addons` bawaan Odoo. Ini akan mempersulit upgrade dan pemeliharaan di kemudian hari. Selalu gunakan mekanisme kustomisasi Odoo (modul custom, inherit view, extend model) jika ingin mengubah perilaku standar.
GOTCHA: Cache Browser. Terkadang, setelah instalasi atau upgrade modul yang memengaruhi tampilan UI, kalian mungkin perlu melakukan hard refresh browser (Ctrl+Shift+R atau Cmd+Shift+R) untuk melihat perubahan terbaru karena cache browser.
Semoga pencerahan ini membantu Kak Siska dan tim IT dalam petualangan eksplorasi Odoo-nya! Kalau ada pertanyaan lanjutan atau ketemu "gotchas" lain, jangan sungkan untuk bertanya lagi ya. Kita siap diskusi santai lagi di sini! Semangat!
Yuk, kita bedah satu per satu "workflow" terbaik untuk instalasi modul custom atau dari pihak ketiga agar rapi, aman, dan mudah di-manage.
### 1. Penempatan File Modul
Untuk penempatan file modul custom, ada beberapa pendekatan, tapi yang paling direkomendasikan adalah:
Direktori `addons` internal (kurang disarankan untuk custom): Secara default, Odoo akan mencari modul di direktori `addons` yang ada di instalasi Odoo kalian. Namun, menaruh modul custom di sini kurang disarankan karena berisiko terhapus atau tertimpa saat kalian melakukan upgrade Odoo di masa depan.
Direktori `custom_addons` terpisah (paling disarankan): Ini adalah praktik terbaik. Buatlah sebuah folder baru di luar direktori instalasi Odoo kalian, misalnya `custom_addons` (nama bisa disesuaikan, bebas). Di dalam folder inilah semua modul custom atau modul pihak ketiga yang kalian unduh bisa diletakkan.
Kenapa harus di luar?
Ini akan menjaga instalasi Odoo inti kalian tetap "bersih". Saat ada update Odoo yang besar (misalnya dari Odoo 15 ke 16), kalian tidak perlu khawatir modul custom kalian hilang atau konflik dengan file Odoo bawaan. Kalian hanya perlu memastikan modul custom tersebut kompatibel dengan versi Odoo yang baru.
Setelah membuat folder `custom_addons` dan menaruh modul di sana, kalian perlu memberi tahu Odoo di mana modul-modul ini berada. Caranya adalah dengan mengedit file `odoo.conf` (atau nama file konfigurasi Odoo lainnya yang kalian gunakan). Cari parameter `addons_path` dan tambahkan path ke folder `custom_addons` tersebut.
Contoh di `odoo.conf`:
```ini
addons_path = /path/to/your/odoo/addons, /path/to/your/custom_addons_folder
```
Pastikan path-nya dipisahkan dengan koma (`,`) dan tanpa spasi di antaranya jika ada lebih dari satu path. Urutan juga bisa mempengaruhi, Odoo akan membaca dari kiri ke kanan.
### 2. Deteksi Modul Baru
Setelah file modul diletakkan di `custom_addons` dan path-nya sudah ditambahkan di `odoo.conf`, Odoo perlu diberi tahu bahwa ada modul baru.
1. Restart Odoo Service: Ini adalah langkah penting dan mutlak. Setiap kali kalian mengubah `addons_path` di `odoo.conf` atau menambahkan file modul baru ke salah satu direktori `addons_path`, kalian wajib merestart service Odoo agar konfigurasi dan modul baru terdeteksi. Tanpa ini, Odoo tidak akan "melihat" modul yang baru kalian tambahkan.
2. Aktifkan Developer Mode: Di Odoo, buka bagian "Settings" (Pengaturan). Gulir ke bawah dan cari opsi untuk mengaktifkan Developer Mode (atau `Debug Mode`). Biasanya ada di bagian paling bawah.
3. Update Apps List: Setelah Developer Mode aktif, kembali ke menu "Apps" (Aplikasi). Di sana akan muncul opsi "Update Apps List" atau "Update Module List". Klik opsi ini. Odoo akan memindai semua folder di `addons_path` dan mendaftarkan modul-modul baru yang ditemukannya ke dalam database.
### 3. Instalasi Modul
Setelah modul terdeteksi dan muncul di daftar aplikasi:
1. Cari Modul: Di menu "Apps", kalian bisa mencari nama modul yang baru saja kalian letakkan. Jika sudah terdeteksi, modul tersebut akan muncul di daftar.
2. Klik Tombol "Install": Temukan modulnya, lalu klik tombol "Install" yang ada di kartu modul tersebut. Odoo akan secara otomatis menginstal modul beserta dependensi yang dibutuhkannya (jika ada dan sudah tersedia).
### 4. Hal Penting Lainnya & Gotchas
Ini adalah bagian krusial yang sering jadi "jebakan Batman" kalau tidak diperhatikan:
Dependensi Antar Modul:
Setiap modul Odoo memiliki file `__manifest__.py`. Di dalam file ini ada bagian `depends` yang berisi daftar modul Odoo lain yang harus terinstal agar modul tersebut bisa bekerja.
Odoo biasanya cukup pintar untuk menginstal dependensi secara otomatis. Namun, pastikan semua modul yang menjadi dependensi sudah ada di `addons_path` kalian. Jika ada dependensi yang belum ada atau versi yang tidak cocok, instalasi bisa gagal dengan pesan error.
Selalu cek `__manifest__.py` jika ada masalah instalasi untuk melihat dependensi yang dibutuhkan.
Update Database saat Perubahan Struktur:
Jika kalian hanya mengubah kode Python dalam modul (misalnya, logika fungsi atau metode), cukup restart service Odoo.
Jika kalian mengubah definisi model, menambah/mengubah field baru, mengubah view (XML), mengubah data (`.csv` atau `.xml` untuk demo data/security rules), atau mengubah struktur database lainnya, maka modul tersebut harus di-upgrade.
Cara meng-upgrade: Aktifkan Developer Mode, pergi ke menu "Apps", cari modul yang ingin di-upgrade, lalu klik tombol "Upgrade" (biasanya ikon panah melingkar). Ini akan membuat Odoo membaca kembali file-file modul dan menerapkan perubahan ke database.
Untuk kebutuhan pengembangan, kalian juga bisa meng-upgrade modul melalui command line saat memulai service Odoo dengan opsi `-u`:
```bash
odoo-bin -c /path/to/odoo.conf -u nama_modul_anda
```
Ini sangat membantu untuk mempercepat proses pengembangan.
Do's and Don'ts / Gotchas:
DO: Selalu Uji di Lingkungan Development/Staging. Jangan pernah langsung menginstal atau meng-upgrade modul custom di server produksi tanpa pengujian menyeluruh di lingkungan terpisah. Ini untuk mencegah masalah tak terduga yang bisa mengganggu operasional bisnis.
DO: Backup Database. Sebelum menginstal modul besar, modul penting, atau melakukan upgrade modul di server produksi, selalu lakukan backup database terlebih dahulu. Ini adalah jaring pengaman terbaik jika terjadi hal yang tidak diinginkan.
DO: Perhatikan Kompatibilitas Versi. Pastikan modul custom yang kalian unduh kompatibel dengan versi Odoo yang kalian gunakan. Modul yang dibuat untuk Odoo 15 mungkin tidak akan berfungsi dengan baik (atau bahkan tidak bisa diinstal) di Odoo 16 tanpa penyesuaian.
DO: Periksa Dependensi Python Eksternal. Beberapa modul mungkin memerlukan library Python tambahan yang tidak disertakan dalam instalasi Odoo standar. Pastikan untuk menginstal dependensi ini ke lingkungan Python Odoo kalian (`pip install nama_library`).
DON'T: Memodifikasi File Core Odoo. Hindari mengubah file-file di direktori `addons` bawaan Odoo. Ini akan mempersulit upgrade dan pemeliharaan di kemudian hari. Selalu gunakan mekanisme kustomisasi Odoo (modul custom, inherit view, extend model) jika ingin mengubah perilaku standar.
GOTCHA: Cache Browser. Terkadang, setelah instalasi atau upgrade modul yang memengaruhi tampilan UI, kalian mungkin perlu melakukan hard refresh browser (Ctrl+Shift+R atau Cmd+Shift+R) untuk melihat perubahan terbaru karena cache browser.
Semoga pencerahan ini membantu Kak Siska dan tim IT dalam petualangan eksplorasi Odoo-nya! Kalau ada pertanyaan lanjutan atau ketemu "gotchas" lain, jangan sungkan untuk bertanya lagi ya. Kita siap diskusi santai lagi di sini! Semangat!