Step-by-Step Guide: How to Install Dolibarr on a cPanel Hosting Environment

Introduction
Dolibarr ERP & CRM adalah perangkat lunak open-source berbasis web yang membantu bisnis mengelola invoicing, akuntansi, kontrol stok, HR, hingga hubungan pelanggan. Struktur modularnya memudahkan UMKM, freelancer, maupun NGO beradaptasi tanpa ketergantungan pada developer.

Why Install Dolibarr on cPanel?
1. Tidak perlu keahlian command-line
2. Upload file dan pembuatan database sangat mudah
3. Paket hosting terjangkau
4. Akses terpusur untuk email, cadangan, dan domain
5. Kompatibel dengan PHP dan MySQL

Prerequisites Before Installation
- Akun cPanel aktif
- PHP 7.4 atau lebih tinggi (versi 16+ memerlukan PHP 8.0+)
- Dukungan MySQL atau MariaDB
- File Manager atau akses FTP
- Ekstensi PHP yang disarankan: gd, mbstring, curl, intl, zip, pdo_mysql, xml, json, fileinfo

Step 1: Downloading the Latest Dolibarr Package
Buka https://www.dolibarr.org/downloads/ dan unduh arsip ZIP stabil terbaru. Simpan di komputer Anda.

Step 2: Uploading Dolibarr to Your cPanel Account
Opsi A: File Manager
1. Login cPanel > File Manager
2. Masuk ke public_html atau sub-folder (mis. public_html/erp)
3. Upload ZIP Dolibarr lalu extract
4. Ubah nama folder hasil extract menjadi dolibarr atau erp
Opsi B: FTP dengan FileZilla – unggah folder hasil ekstrak secara manual.

Step 3: Creating a MySQL Database via cPanel
1. Klik MySQL Databases
2. Create New Database > beri nama > Create
3. Buat MySQL User dengan password kuat
4. Add User to Database, centang All Privileges > Make Changes
5. Catat nama database, user, dan password untuk proses instalasi.

Step 4: Setting Correct File Permissions
Pada File Manager atur permission 755 untuk:
- /documents/
- /conf/
- /htdocs/custom/
Jika installer menolak, ubah sementara menjadi 775 lalu kembalikan ke 755 setelah selesai.

Step 5: Running the Dolibarr Installer
1. Akses https://yourdomain.com/erp/install/
2. Klik Start/Next Step
3. Masukkan detail database dan buat akun admin ERP
4. Installer akan membuat tabel, mengatur parameter, dan finalisasi
5. Hapus atau rename folder install agar tidak ter-install ulang.

Step 6: Post-Installation Configuration
1. Setup > Display > Languages – pilih bahasa
2. Setup > Miscellaneous > Regional Settings – atur negara, zona waktu, format tanggal
3. Setup > Company/Organization – isi nama legal, logo, alamat, tahun fiskal

Step 7: Securing Your Dolibarr Instance
1. Hapus permanen folder /install/
2. Buat .htaccess di /documents/ dengan:
RewriteEngine on
RewriteRule ^ - [F]
3. Aktifkan SSL via Let’s Encrypt cPanel
4. Pastikan permission /conf/ ketat (755)
5. Sesuaikan PHP Options: memory_limit 256M, post_max_size 32M, upload_max_filesize 32M, max_execution_time 120

Step 8: Installing Additional Modules
Download modul dari Dolistore, unggah ke /htdocs/custom/, extract, lalu aktifkan melalui Home > Setup > Modules/Applications.

Step 9: Automating Backups and Updates
- Backup: Gunakan Backup Wizard atau cron di cPanel; cadangkan /conf/ dan /documents/ serta ekspor database dengan phpMyAdmin
- Update: Backup seluruh data, periksa kompatibilitas modul, ikuti dokumen upgrade, jangan timpa folder /documents/ atau /conf/

Common Errors and How to Resolve Them
Blank Screen on Login – periksa ekstensi PHP atau aktifkan error_reporting
Cannot Connect to Database – cek kembali nama database, user, password
Module Not Showing – pastikan path /htdocs/custom/ dan struktur file mod*.php benar
PDFs Not Generating – aktifkan gd, mbstring, atur permission /documents/
403 Forbidden pada /documents/ – sesuaikan permission 755 atau kordinasikan dengan support hosting

Final Thoughts
Dengan mengikuti panduan ini Anda dapat menjalankan Dolibarr di cPanel secara cepat, aman, dan hemat biaya. Manfaatnya: ERP open-source yang fleksibel, infrastruktur shared hosting terjangkau, serta kemampuan ekspansi melalui modul resmi.

Iklan Morfotech
Perlu bantuan instalasi atau kustomisasi aplikasi ERP, e-commerce, maupun sistem bisnis lainnya? Hubungi Morfotech.id – developer handal dengan pengalaman 10+ tahun. Konsultasi gratis via WhatsApp: +62 811-2288-8001 atau kunjungi https://morfotech.id untuk portofolio lengkap dan penawaran menarik.