Mohon Pencerahan: Instalasi Modul Odoo & Best Practice-nya (Odoo 16)
Diposting pada 07 Mar 2026, 10:18
Ditanyakan oleh: Gunawan
Halo rekan-rekan Odoo User dan praktisi IT sekalian,
Saya Gunawan, tim IT di tempat saya pakai Odoo ERP. Kami saat ini menggunakan Odoo versi 16 Enterprise dan sedang berencana untuk mengintegrasikan beberapa modul tambahan, baik itu modul dari Odoo Apps maupun modul kustom yang kami kembangkan sendiri atau dari pihak ketiga.
Nah, yang ingin saya tanyakan adalah, bagaimana sih best practice atau langkah-langkah yang paling aman dan efisien untuk melakukan instalasi modul-modul tersebut? Apakah ada perbedaan signifikan antara menginstal via antarmuka Odoo (menu Apps) dengan meng-upload secara manual ke folder addons di server?
Saya sering dengar perlu update list aplikasi, restart service Odoo, bahkan update database. Untuk konteks yang lebih spesifik, kami ingin memasang modul yang berkaitan dengan fitur pelaporan dan beberapa kustomisasi di bagian inventori.
Mohon pencerahannya dari suhu-suhu di sini. Kira-kira apa saja yang perlu saya perhatikan agar tidak terjadi error atau konflik antar modul? Mungkin ada tips & trik khusus saat proses instalasi atau setelahnya?
Terima kasih banyak sebelumnya atas bantuannya!
Balasan (1)
Admin Odoo ForumAdmin & AI Support07 Mar 2026, 10:19
Halo Mas Gunawan, Sobat Odoo! Senang sekali bisa bantu mencerahkan. Pertanyaan Mas Gunawan ini sangat penting dan sering jadi concern di komunitas, apalagi menyangkut Odoo 16 Enterprise dan modul yang krusial seperti pelaporan dan inventori. Yuk, kita bahas tuntas best practice-nya agar instalasi modul berjalan aman dan lancar jaya!
---
Pertama-tama, perlu diingat bahwa proses instalasi modul itu ibarat "menambahkan organ baru" ke sistem Odoo kita. Jadi, persiapan dan langkah-langkah yang tepat itu wajib banget biar nggak ada penolakan atau komplikasi di kemudian hari.
1. Lingkungan Staging dan Backup: WAJIB HUKUMNYA!
Sebelum menyentuh produksi, selalu lakukan instalasi dan pengujian di lingkungan staging (mirroring dari produksi). Ini adalah langkah paling krusial untuk mencegah downtime atau kerusakan data di lingkungan live jika terjadi masalah.
Setelah itu, pastikan Mas Gunawan sudah melakukan full backup database dan folder Odoo (termasuk folder `addons` dan `filestore`) di lingkungan staging maupun produksi (sebelum dipindahkan ke produksi). Ini penyelamat utama kalau ada hal-hal yang tidak diinginkan.
2. Memahami Dua Metode Instalasi Modul
Secara umum, ada dua cara instalasi modul di Odoo, dan masing-masing punya konteksnya:
A. Instalasi via Antarmuka Odoo (Menu Apps)
Ini adalah cara paling mudah untuk modul-modul yang sudah tersedia di Odoo Apps (baik itu modul standar Odoo, modul gratis yang terintegrasi, atau modul berbayar yang sudah Mas Gunawan beli dan lisensinya terhubung dengan Odoo Enterprise Anda).
Prosesnya: Cukup masuk ke menu 'Apps', cari modulnya, lalu klik 'Activate' atau 'Install'. Odoo akan mengurus semuanya secara otomatis.
Kelebihan: Sangat praktis, tidak perlu akses server, dan biasanya sudah terjamin kompatibilitasnya.
Kekurangan: Hanya bisa untuk modul yang sudah dikenal Odoo dan terlisting di Apps.
B. Manual Upload ke Folder Addons Server
Metode ini digunakan untuk modul kustom yang dikembangkan sendiri, modul dari pihak ketiga (misalnya dari GitHub atau vendor lain), atau modul dari Odoo Apps yang belum otomatis terlisting di Odoo Enterprise Anda (misalnya versi komunitas dari modul tertentu).
Prosesnya: Mas Gunawan perlu akses ke server Odoo untuk menempatkan file modul di lokasi yang tepat.
Kelebihan: Fleksibel untuk menginstal modul apa pun.
Kekurangan: Membutuhkan pengetahuan teknis server dan langkah-langkah tambahan yang lebih detail.
Karena Mas Gunawan menyebut modul kustom dan pihak ketiga, fokus kita akan lebih banyak ke metode B.
3. Langkah-langkah Instalasi Modul Secara Manual (Best Practice)
Misalkan Mas Gunawan punya modul dengan nama folder `my_custom_module`.
1. Backup Ulang (Tidak Ada Salahnya Double Check!)
Pastikan lagi backup database dan folder Odoo sudah dilakukan sebelum ini.
2. Tempatkan Folder Modul ke `addons_path`
Salin (copy) seluruh folder modul (`my_custom_module`) ke dalam salah satu direktori yang terdaftar di konfigurasi `addons_path` Odoo Anda. Biasanya, ada folder `addons` bawaan Odoo, atau `custom/addons` yang dibuat terpisah untuk modul kustom.
Contoh lokasi umum: `/opt/odoo/custom/addons/my_custom_module`.
3. Verifikasi `addons_path` di `odoo.conf`
Buka file konfigurasi Odoo Anda (biasanya `odoo.conf`). Pastikan jalur direktori tempat Mas Gunawan meletakkan modul sudah terdaftar di parameter `addons_path`.
Contoh: `addons_path = /opt/odoo/odoo-server/addons,/opt/odoo/custom/addons`
Jika belum ada, tambahkan jalur baru tersebut, pastikan dipisahkan dengan koma.
4. Restart Service Odoo
Ini penting banget! Setelah menambahkan modul baru ke folder `addons` atau mengubah `odoo.conf`, Mas Gunawan harus me-restart service Odoo agar Odoo membaca dan memuat modul-modul baru serta perubahan konfigurasi.
Contoh perintah (tergantung sistem operasi dan setup Anda):
`sudo service odoo-server restart` (untuk Linux dengan systemd)
Atau restart process `odoo.py` jika dijalankan secara manual.
5. Aktifkan Developer Mode (Mode Debug)
Setelah service Odoo berjalan kembali, masuk ke Odoo via browser.
Aktifkan Developer Mode. Caranya: klik icon kumbang di pojok kanan atas (atau di Settings > Developer Tools > Activate the developer mode). Ini diperlukan agar opsi 'Update Apps List' muncul.
6. Update Apps List
Masuk ke menu 'Apps'.
Cari opsi 'Update Apps List' (biasanya di bawah kolom pencarian atau di sebelah kanan). Klik tombol tersebut.
Ini akan membuat Odoo melakukan scan ulang `addons_path` dan menambahkan modul baru yang ditemukan ke daftar aplikasi yang tersedia di Odoo Anda.
7. Cari dan Instal Modul
Setelah 'Update Apps List', ketik nama modul (`my_custom_module`) di kolom pencarian.
Modul akan muncul. Klik 'Install' atau 'Activate' untuk memulai proses instalasi. Odoo akan mengurus perubahan database yang diperlukan.
4. Pencerahan tentang 'Update List Aplikasi', 'Restart Service', dan 'Update Database'
Mas Gunawan sudah tepat mencermati hal-hal ini. Mari kita bedah satu per satu:
Update List Aplikasi (atau Update Apps List):
Tujuan: Memberitahu Odoo bahwa ada modul-modul baru yang tersedia di `addons_path` yang perlu diindeks. Tanpa ini, modul yang baru Mas Gunawan letakkan di server tidak akan muncul di menu Apps Odoo.
Kapan dilakukan: Setelah menempatkan modul baru di `addons_path` dan setelah restart service Odoo.
Restart Service Odoo:
Tujuan: Agar Odoo memuat ulang kode program dan konfigurasi dari awal. Ketika Mas Gunawan menambahkan modul baru (yang berisi kode Python dan XML), Odoo perlu "membaca" kode tersebut. Restart service memastikan semua perubahan kode atau konfigurasi di `odoo.conf` dimuat dengan benar.
Kapan dilakukan: Wajib dilakukan setiap kali Mas Gunawan menambah/mengubah file modul di `addons_path` atau mengubah `odoo.conf`.
Update Database:
Ini sedikit tricky. Untuk instalasi awal modul via UI (klik 'Install' di menu Apps), Odoo secara otomatis akan melakukan perubahan database yang diperlukan oleh modul tersebut (misal, membuat tabel baru, field baru, dsb). Jadi, Mas Gunawan tidak perlu melakukan 'update database' secara terpisah setelah instalasi awal dari UI.
Namun, jika yang dimaksud adalah `odoo.py -u modulename` (perintah di server), ini umumnya digunakan untuk memperbarui modul yang sudah terinstal setelah ada perubahan kode di modul tersebut (misal, Mas Gunawan mengubah `__manifest__.py`, field di model, atau data XML). Perintah ini akan menjalankan ulang proses migrasi data dan struktur yang ada di modul tersebut.
Untuk kasus Mas Gunawan yang baru mau instal: Fokus pada langkah-langkah di atas. 'Update database' secara manual dari server biasanya tidak diperlukan untuk instalasi awal via UI.
5. Tips & Trik Tambahan untuk Menghindari Error dan Konflik
Terutama untuk modul pelaporan dan inventori yang seringkali melakukan banyak kustomisasi:
Perhatikan Dependencies Modul:
Setiap modul Odoo memiliki daftar dependensi di file `__manifest__.py`-nya. Pastikan semua modul yang menjadi dependensi sudah terinstal atau akan terinstal bersamaan. Odoo biasanya akan memberitahu jika ada dependensi yang belum terpenuhi.
Untuk modul kustom atau pihak ketiga, pastikan dependensinya juga sudah ada di `addons_path` dan di-update list aplikasi.
Baca Dokumentasi Modul:
Jika itu modul pihak ketiga, baca dokumentasinya dengan seksama. Terkadang ada langkah-langkah pra-instalasi atau pasca-instalasi khusus yang diperlukan.
Uji di Lingkungan Staging! (Penekanan Berulang)
Ini adalah kesempatan emas untuk menemukan error atau konflik sebelum masuk ke produksi. Lakukan berbagai skenario pengujian terkait fitur baru tersebut.
Perhatikan Konflik dengan Modul Lain:
Terutama modul kustomisasi inventori, hati-hati jika Anda sudah punya kustomisasi inventori dari modul lain. Konflik bisa terjadi jika dua modul mencoba mengubah hal yang sama (misal, menimpa fungsi yang sama, menambah field dengan nama yang sama di model yang sama).
Jika ada error, cek Odoo server log! Ini adalah sumber informasi terbaik untuk debugging. Log akan menunjukkan traceback dan penyebab error.
Gunakan Virtual Environment (jika memungkinkan):
Untuk pengembangan modul kustom, menggunakan virtual environment Python dapat membantu mengelola dependensi Python yang spesifik untuk modul tersebut tanpa mengganggu instalasi Python Odoo utama.
Jaga Konsistensi Versi:
Pastikan modul pihak ketiga atau kustom Anda memang kompatibel dengan Odoo 16. Modul yang dibuat untuk versi Odoo sebelumnya seringkali memerlukan adaptasi.
Semoga pencerahan ini membantu Mas Gunawan dan tim IT dalam menginstal modul di Odoo 16 dengan aman dan efisien. Jangan ragu bertanya lagi ya jika ada detail yang masih kurang jelas atau menemui kendala. Semangat selalu!
---
Pertama-tama, perlu diingat bahwa proses instalasi modul itu ibarat "menambahkan organ baru" ke sistem Odoo kita. Jadi, persiapan dan langkah-langkah yang tepat itu wajib banget biar nggak ada penolakan atau komplikasi di kemudian hari.
1. Lingkungan Staging dan Backup: WAJIB HUKUMNYA!
Sebelum menyentuh produksi, selalu lakukan instalasi dan pengujian di lingkungan staging (mirroring dari produksi). Ini adalah langkah paling krusial untuk mencegah downtime atau kerusakan data di lingkungan live jika terjadi masalah.
Setelah itu, pastikan Mas Gunawan sudah melakukan full backup database dan folder Odoo (termasuk folder `addons` dan `filestore`) di lingkungan staging maupun produksi (sebelum dipindahkan ke produksi). Ini penyelamat utama kalau ada hal-hal yang tidak diinginkan.
2. Memahami Dua Metode Instalasi Modul
Secara umum, ada dua cara instalasi modul di Odoo, dan masing-masing punya konteksnya:
A. Instalasi via Antarmuka Odoo (Menu Apps)
Ini adalah cara paling mudah untuk modul-modul yang sudah tersedia di Odoo Apps (baik itu modul standar Odoo, modul gratis yang terintegrasi, atau modul berbayar yang sudah Mas Gunawan beli dan lisensinya terhubung dengan Odoo Enterprise Anda).
Prosesnya: Cukup masuk ke menu 'Apps', cari modulnya, lalu klik 'Activate' atau 'Install'. Odoo akan mengurus semuanya secara otomatis.
Kelebihan: Sangat praktis, tidak perlu akses server, dan biasanya sudah terjamin kompatibilitasnya.
Kekurangan: Hanya bisa untuk modul yang sudah dikenal Odoo dan terlisting di Apps.
B. Manual Upload ke Folder Addons Server
Metode ini digunakan untuk modul kustom yang dikembangkan sendiri, modul dari pihak ketiga (misalnya dari GitHub atau vendor lain), atau modul dari Odoo Apps yang belum otomatis terlisting di Odoo Enterprise Anda (misalnya versi komunitas dari modul tertentu).
Prosesnya: Mas Gunawan perlu akses ke server Odoo untuk menempatkan file modul di lokasi yang tepat.
Kelebihan: Fleksibel untuk menginstal modul apa pun.
Kekurangan: Membutuhkan pengetahuan teknis server dan langkah-langkah tambahan yang lebih detail.
Karena Mas Gunawan menyebut modul kustom dan pihak ketiga, fokus kita akan lebih banyak ke metode B.
3. Langkah-langkah Instalasi Modul Secara Manual (Best Practice)
Misalkan Mas Gunawan punya modul dengan nama folder `my_custom_module`.
1. Backup Ulang (Tidak Ada Salahnya Double Check!)
Pastikan lagi backup database dan folder Odoo sudah dilakukan sebelum ini.
2. Tempatkan Folder Modul ke `addons_path`
Salin (copy) seluruh folder modul (`my_custom_module`) ke dalam salah satu direktori yang terdaftar di konfigurasi `addons_path` Odoo Anda. Biasanya, ada folder `addons` bawaan Odoo, atau `custom/addons` yang dibuat terpisah untuk modul kustom.
Contoh lokasi umum: `/opt/odoo/custom/addons/my_custom_module`.
3. Verifikasi `addons_path` di `odoo.conf`
Buka file konfigurasi Odoo Anda (biasanya `odoo.conf`). Pastikan jalur direktori tempat Mas Gunawan meletakkan modul sudah terdaftar di parameter `addons_path`.
Contoh: `addons_path = /opt/odoo/odoo-server/addons,/opt/odoo/custom/addons`
Jika belum ada, tambahkan jalur baru tersebut, pastikan dipisahkan dengan koma.
4. Restart Service Odoo
Ini penting banget! Setelah menambahkan modul baru ke folder `addons` atau mengubah `odoo.conf`, Mas Gunawan harus me-restart service Odoo agar Odoo membaca dan memuat modul-modul baru serta perubahan konfigurasi.
Contoh perintah (tergantung sistem operasi dan setup Anda):
`sudo service odoo-server restart` (untuk Linux dengan systemd)
Atau restart process `odoo.py` jika dijalankan secara manual.
5. Aktifkan Developer Mode (Mode Debug)
Setelah service Odoo berjalan kembali, masuk ke Odoo via browser.
Aktifkan Developer Mode. Caranya: klik icon kumbang di pojok kanan atas (atau di Settings > Developer Tools > Activate the developer mode). Ini diperlukan agar opsi 'Update Apps List' muncul.
6. Update Apps List
Masuk ke menu 'Apps'.
Cari opsi 'Update Apps List' (biasanya di bawah kolom pencarian atau di sebelah kanan). Klik tombol tersebut.
Ini akan membuat Odoo melakukan scan ulang `addons_path` dan menambahkan modul baru yang ditemukan ke daftar aplikasi yang tersedia di Odoo Anda.
7. Cari dan Instal Modul
Setelah 'Update Apps List', ketik nama modul (`my_custom_module`) di kolom pencarian.
Modul akan muncul. Klik 'Install' atau 'Activate' untuk memulai proses instalasi. Odoo akan mengurus perubahan database yang diperlukan.
4. Pencerahan tentang 'Update List Aplikasi', 'Restart Service', dan 'Update Database'
Mas Gunawan sudah tepat mencermati hal-hal ini. Mari kita bedah satu per satu:
Update List Aplikasi (atau Update Apps List):
Tujuan: Memberitahu Odoo bahwa ada modul-modul baru yang tersedia di `addons_path` yang perlu diindeks. Tanpa ini, modul yang baru Mas Gunawan letakkan di server tidak akan muncul di menu Apps Odoo.
Kapan dilakukan: Setelah menempatkan modul baru di `addons_path` dan setelah restart service Odoo.
Restart Service Odoo:
Tujuan: Agar Odoo memuat ulang kode program dan konfigurasi dari awal. Ketika Mas Gunawan menambahkan modul baru (yang berisi kode Python dan XML), Odoo perlu "membaca" kode tersebut. Restart service memastikan semua perubahan kode atau konfigurasi di `odoo.conf` dimuat dengan benar.
Kapan dilakukan: Wajib dilakukan setiap kali Mas Gunawan menambah/mengubah file modul di `addons_path` atau mengubah `odoo.conf`.
Update Database:
Ini sedikit tricky. Untuk instalasi awal modul via UI (klik 'Install' di menu Apps), Odoo secara otomatis akan melakukan perubahan database yang diperlukan oleh modul tersebut (misal, membuat tabel baru, field baru, dsb). Jadi, Mas Gunawan tidak perlu melakukan 'update database' secara terpisah setelah instalasi awal dari UI.
Namun, jika yang dimaksud adalah `odoo.py -u modulename` (perintah di server), ini umumnya digunakan untuk memperbarui modul yang sudah terinstal setelah ada perubahan kode di modul tersebut (misal, Mas Gunawan mengubah `__manifest__.py`, field di model, atau data XML). Perintah ini akan menjalankan ulang proses migrasi data dan struktur yang ada di modul tersebut.
Untuk kasus Mas Gunawan yang baru mau instal: Fokus pada langkah-langkah di atas. 'Update database' secara manual dari server biasanya tidak diperlukan untuk instalasi awal via UI.
5. Tips & Trik Tambahan untuk Menghindari Error dan Konflik
Terutama untuk modul pelaporan dan inventori yang seringkali melakukan banyak kustomisasi:
Perhatikan Dependencies Modul:
Setiap modul Odoo memiliki daftar dependensi di file `__manifest__.py`-nya. Pastikan semua modul yang menjadi dependensi sudah terinstal atau akan terinstal bersamaan. Odoo biasanya akan memberitahu jika ada dependensi yang belum terpenuhi.
Untuk modul kustom atau pihak ketiga, pastikan dependensinya juga sudah ada di `addons_path` dan di-update list aplikasi.
Baca Dokumentasi Modul:
Jika itu modul pihak ketiga, baca dokumentasinya dengan seksama. Terkadang ada langkah-langkah pra-instalasi atau pasca-instalasi khusus yang diperlukan.
Uji di Lingkungan Staging! (Penekanan Berulang)
Ini adalah kesempatan emas untuk menemukan error atau konflik sebelum masuk ke produksi. Lakukan berbagai skenario pengujian terkait fitur baru tersebut.
Perhatikan Konflik dengan Modul Lain:
Terutama modul kustomisasi inventori, hati-hati jika Anda sudah punya kustomisasi inventori dari modul lain. Konflik bisa terjadi jika dua modul mencoba mengubah hal yang sama (misal, menimpa fungsi yang sama, menambah field dengan nama yang sama di model yang sama).
Jika ada error, cek Odoo server log! Ini adalah sumber informasi terbaik untuk debugging. Log akan menunjukkan traceback dan penyebab error.
Gunakan Virtual Environment (jika memungkinkan):
Untuk pengembangan modul kustom, menggunakan virtual environment Python dapat membantu mengelola dependensi Python yang spesifik untuk modul tersebut tanpa mengganggu instalasi Python Odoo utama.
Jaga Konsistensi Versi:
Pastikan modul pihak ketiga atau kustom Anda memang kompatibel dengan Odoo 16. Modul yang dibuat untuk versi Odoo sebelumnya seringkali memerlukan adaptasi.
Semoga pencerahan ini membantu Mas Gunawan dan tim IT dalam menginstal modul di Odoo 16 dengan aman dan efisien. Jangan ragu bertanya lagi ya jika ada detail yang masih kurang jelas atau menemui kendala. Semangat selalu!