Install Aureus ERP di Ubuntu 24.04

Aureus ERP adalah sistem Enterprise Resource Planning (ERP) berbasis open-source yang dikembangkan dengan Laravel dan FilamentPHP. Platform ini dirancang untuk membantu bisnis kecil, menengah, maupun perusahaan besar dalam mengelola berbagai aspek operasional seperti keuangan, sumber daya manusia (SDM), persediaan (inventory), hingga manajemen relasi pelanggan (CRM), semuanya dalam satu sistem terintegrasi.

Aureus ERP menggabungkan kekuatan teknologi modern dengan fleksibilitas tinggi. Dibangun di atas Laravel, framework PHP yang terkenal dengan keamanan dan skalabilitasnya, serta FilamentPHP yang menyediakan antarmuka admin dinamis dan mudah dikustomisasi. Selain itu, penggunaan TailwindCSS membuat tampilan Aureus ERP responsif, ringan, dan profesional.

Karena arsitektur yang modular dan terbuka, pengguna dapat menambahkan atau menghapus modul sesuai kebutuhan bisnis. Hal ini membuat Aureus ERP ideal untuk pengembangan jangka panjang, baik untuk penggunaan internal maupun untuk ditawarkan sebagai solusi ERP bagi klien.

Pada tutorial ini, kita akan membahas cara lengkap menginstal Aureus ERP di sistem operasi Ubuntu 24.04.

System Requirements

Sebelum melakukan instalasi Aureus ERP di Ubuntu 24.04, pastikan server kamu telah memenuhi spesifikasi dan konfigurasi minimum berikut. Persyaratan ini sangat penting agar sistem berjalan stabil, aman, dan optimal baik untuk pengembangan (development) maupun untuk lingkungan produksi (production).

Catatan: Kombinasi NGINX + PHP-FPM + MySQL 8.0 umumnya memberikan performa terbaik untuk deployment production.

Ekstensi PHP yang Diperlukan

Pastikan ekstensi-ekstensi PHP berikut telah terinstal dan diaktifkan di server.

Jalankan perintah berikut untuk memeriksa ekstensi yang sudah terpasang:

php -m

atau membuat file phpinfo() di direktori web server.

Konfigurasi PHP (php.ini)

Ubah beberapa nilai pada file konfigurasi php.ini agar performa Aureus ERP lebih optimal.

Lokasi file biasanya berada di:

• /etc/php/8.4/fpm/php.ini untuk PHP-FPM (NGINX)
• /etc/php/8.4/apache2/php.ini untuk Apache

Tambahkan atau ubah baris berikut:

memory_limit = 4G
max_execution_time = 360
date.timezone = Asia/Jakarta

Ganti Asia/Jakarta sesuai zona waktu.
Daftar zona waktu lengkap bisa dilihat di PHP Supported Timezones.

Database yang Didukung

Aureus ERP mendukung dua sistem basis data utama:

Gunakan utf8mb4_unicode_ci untuk memastikan dukungan penuh terhadap karakter Unicode dan berbagai bahasa.

CREATE DATABASE aureus CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Jika sistem dan konfigurasi di atas sudah sesuaia, server sudah siap untuk diinstalkan Aureus ERP.

Langkah berikutnya adalah menyiapkan lingkungan pengembangan dan menginstal dependensi utama seperti PHP, Composer, Node.js, dan MySQL.

Install Dependensi

Pertama, perbarui sistem Ubuntu agar menggunakan paket terbaru:

sudo apt update
sudo apt upgrade -y

Tambahkan repository PPA Ondrej untuk Nginx dan PHP 8.4:

sudo add-apt-repository ppa:ondrej/nginx -y
sudo add-apt-repository ppa:ondrej/php -y

Install Nginx dan certbot:

sudo apt install nginx python3-certbot-nginx -y

Install PHP 8.4 dan extension yang dibutuhkan:

sudo apt install php8.4 php8.4-fpm php8.4-cli php8.4-common php8.4-mysql \
php8.4-xml php8.4-mbstring php8.4-bcmath php8.4-curl php8.4-gd php8.4-intl php8.4-zip unzip curl -y

Install Composer:

sudo wget https://getcomposer.org/download/latest-stable/composer.phar
sudo chmod +x composer.phar
sudo mv composer.phar /usr/local/bin/composer 

Verifikasi instalasi:

composer -V

Install MySQL 8.4:

wget https://dev.mysql.com/get/mysql-apt-config_0.8.35-1_all.deb
sudo dpkg -i mysql-apt-config_0.8.35-1_all.deb
sudo apt update
sudo apt install mysql-server -y

Login ke MySQL:

sudo mysql -u root -p

Membuat database untuk Aureus:

CREATE DATABASE aureus CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'aureususer'@'localhost' IDENTIFIED BY 'StrongSecretPassword!';
GRANT ALL PRIVILEGES ON aureus.* TO 'aureususer'@'localhost';
FLUSH PRIVILEGES;
exit

Install Aureus ERP

Install Git dan clone repository Aureus ERP:

sudo apt install git -y
git clone https://github.com/aureuserp/aureuserp.git

Masuk ke direktori hasil clone:

cd aureuserp

Copy file .env dan buka:

cp .env.example .env 
nano .env

Ubah baris berikut:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=aureus
DB_USERNAME=aureususer
DB_PASSWORD=StrongSecretPassword!

Install PHP dependensi Aureus:

composer install

Membuat project baru:

composer create-project

Install ERP dan membuat akun admin:

php artisan erp:install

Jalankan development server:

php artisan serve --host=0.0.0.0 --port=8000

Lalu akses:

http://Server-IP:8000

Setelah login, klik Sync Available Plugins untuk sinkronisasi plugin yang tersedia di Aureus ERP.

Plugin Aureus ERP

Setelah proses instalasi dan konfigurasi environment selesai, penting untuk memahami bagaimana Aureus ERP bekerja secara internal. Dengan mengenal konsep arsitektur modular dan sistem plugin-nya, kamu akan lebih mudah menyesuaikan fitur sesuai kebutuhan bisnis.

Aureus ERP dibangun dengan pendekatan arsitektur modular berbasis plugin, yang memungkinkan sistem diperluas atau dikurangi tanpa mengubah inti (core system). Teknologi utama yang digunakan:

• PHP: bahasa pemrograman utama.
• Laravel: framework backend yang menyediakan struktur MVC, ORM (Eloquent), routing, dan keamanan.
• Filament PHP: framework admin panel berbasis Laravel untuk membangun antarmuka backend dinamis.
• Alpine.js & Livewire: untuk interaksi UI yang reaktif tanpa harus memuat ulang halaman.
• Tailwind CSS: framework CSS modern yang digunakan untuk tampilan antarmuka yang ringan dan responsif.

Struktur ini menjadikan Aureus ERP sebagai platform ERP modern yang bisa berfungsi sebagai aplikasi tunggal (monolithic) maupun ekosistem modular yang bisa dikembangkan secara independen. Aureus ERP mengadopsi arsitektur plugin-based. Setiap fitur utama seperti keuangan, HR, penjualan, atau proyek diimplementasikan dalam bentuk plugin terpisah yang bisa diinstal atau dihapus secara mandiri.

Kelebihan Arsitektur Plugin

• Mudah dikustomisasi: Plugin bisa ditambahkan atau dimodifikasi tanpa mengganggu sistem utama.
• Mudah dipelihara: Setiap modul memiliki logika dan dependensi sendiri.
• Scalable: Cocok untuk bisnis kecil maupun enterprise besar dengan kebutuhan berbeda.
• Isolasi fitur: Error atau bug di satu plugin tidak memengaruhi modul lainnya.

Semua plugin dapat ditemukan di direktori:

plugins/webkul/

Install Plugin

Semua plugin (kecuali sistem inti) dapat diinstal dan dihapus secara dinamis menggunakan perintah Artisan Laravel.

Untuk mengaktifkan plugin:

php artisan <plugin-name>:install

Contoh:

php artisan employees:install
php artisan projects:install

atau dapat melalui dashboard pada menu Plugins.

Berikut daftar plugin yang saat ini disertakan dalam Aureus ERP dan dapat dipasang sesuai kebutuhan:

Deployment dengan Nginx

Buka file .env dan ubah baris berikut:

APP_NAME="ERP Bitnesia"
APP_ENV=production
APP_DEBUG=false
APP_TIMEZONE=Asia/Jakarta
APP_URL=https://erp.bitnesia.com

Pindahkan direktori aureuserp ke /var/www

sudo mv aureuserp /var/www

Ubah user-group dan permissions:

sudo chown -R www-data:www-data /var/www/aureuserp
sudo chmod -R 755 /var/www/aureuserp

Membuat konfigurasi Nginx untuk subdomain, misal erp.bitnesia.com:

sudo nano /etc/nginx/sites-available/erp.bitnesia.com.conf

Masukkan konfigurasinya:

server {
  listen 80;
  server_name erp.bitnesia.com;
  root /var/www/aureuserp/public;

  index index.php;

  location / {
    try_files $uri $uri/ /index.php?$query_string;
  }

  location ~ \.php$ {
    try_files $fastcgi_script_name =404;
    include fastcgi_params;
    fastcgi_pass    unix:/var/run/php/php8.4-fpm.sock;
    fastcgi_index   index.php;
    fastcgi_param DOCUMENT_ROOT    $realpath_root;
    fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name; 
  }

  access_log /var/log/nginx/erp.bitnesia.com_access.log;
  error_log /var/log/nginx/erp.bitnesia_error.log;
}

Buat symbolic link file konfigurasinya:

sudo ln -s /etc/nginx/sites-available/erp.bitnesia.com.conf /etc/nginx/sites-enabled/

Restart service Nginx:

sudo systemctl restart nginx

ERP sudah bisa diakses di http://erp.bitnesia.com.

Install SSL Let’s Encrypt

Untuk mendukung HTTPS, install SSL dari Let’s Encrypt dengan menggunakan certbot:

sudo certbot --non-interactive \
-m [email protected] \
--agree-tos \
--no-eff-email \
--nginx -d erp.bitnesia.com \
--redirect  

Penutup

Dengan mengikuti langkah-langkah di atas, kamu kini telah berhasil melakukan deployment Aureus ERP di Ubuntu 24.04 secara penuh dalam mode produksi menggunakan NGINX dan SSL Let’s Encrypt. Sistem ini menawarkan arsitektur modular berbasis plugin yang memudahkan proses pengembangan, integrasi, dan skalabilitas sesuai kebutuhan bisnis.

Menggunakan kombinasi Laravel 11, Filament PHP 3, serta lingkungan server yang dioptimalkan dengan PHP 8.4 dan MySQL 8.4, Aureus ERP mampu memberikan performa tinggi dan keamanan yang handal untuk operasional perusahaan modern. Dengan dukungan open-source, kamu juga memiliki kebebasan untuk menyesuaikan setiap modul sesuai alur kerja organisasi.