Lewati ke konten utama

🧩 Instalasi Modul Kustom di Odoo

Odoo mendukung pengembangan dan penggunaan modul kustom (custom modules) untuk menyesuaikan fitur sesuai kebutuhan bisnis. Modul ini biasanya berasal dari tim developer internal, komunitas GitHub, atau vendor pihak ketiga.

📦 1. Menyiapkan Folder untuk Modul Kustom​

Buat folder khusus untuk menyimpan modul kustom, misalnya:

mkdir /opt/odoo/custom_addons

Pastikan folder ini bisa dibaca oleh user Odoo:

chown -R odoo:odoo /opt/odoo/custom_addons

🧭 2. Menambahkan Path ke odoo.conf​

Edit file konfigurasi Odoo (biasanya odoo.conf):

[options]
addons_path = /opt/odoo/odoo-server/addons,/opt/odoo/custom_addons

Pisahkan dengan koma jika kamu menggunakan lebih dari satu path.

⬇️ 3. Mengunduh Modul Kustom​

Kamu bisa:

a. Clone dari GitHub:​

cd /opt/odoo/custom_addons
git clone https://github.com/namauser/odoo_modulku.git

b. Upload manual via SFTP atau File Manager ke folder custom_addons.​

🔁 4. Restart Odoo Service​

Setelah modul ditambahkan:

sudo systemctl restart odoo

Atau jika menggunakan Docker:

docker restart nama_container_odoo

⚙️ 5. Aktifkan Developer Mode​

  1. Masuk ke Odoo sebagai admin.

  2. Klik avatar di kanan atas → Aktifkan Mode Developer.

🧩 6. Instalasi Modul Kustom​

  1. Masuk ke menu Aplikasi / Apps.

  2. Klik Perbarui Apps List (di bawah ikon Developer).

  3. Cari nama modul kamu.

  4. Klik Install.

Jika modul tidak muncul: pastikan foldernya berisi file __manifest__.py dan struktur Odoo yang valid.

🛠️ 7. Struktur Modul Kustom (Contoh)​

markdown
Salin
Edit
my_custom_module/
├── __manifest__.py
├── __init__.py
├── models/
│   └── my_model.py
├── views/
│   └── my_view.xml

Tanpa __manifest__.py, Odoo tidak akan mengenali folder sebagai modul.

🔍 8. Cek Log Jika Gagal​

Jalankan log server untuk memantau error saat start atau install:

sudo journalctl -u odoo -f

Atau:

tail -f /var/log/odoo/odoo-server.log

📌 Tips Tambahan

  • Gunakan nama unik untuk modul kustom agar tidak bentrok dengan modul komunitas/resmi.

  • Gunakan depends di __manifest__.py untuk mendefinisikan ketergantungan.

  • Selalu restart server setelah menambahkan/modifikasi modul.

  • Untuk update modul: klik Upgrade di menu Apps.