Sopwer Logo
Tutorial ERPNext

Cara Install ERPNext 15 di Ubuntu 22.04

Panduan lengkap instalasi ERPNext 15 di Ubuntu 22.04 dengan penjelasan detail setiap langkah. Tutorial ini akan membantu Anda setup ERPNext production-ready server.

Ubuntu 22.04
ERPNext 15
MariaDB
Redis
Nginx

Persyaratan Sistem

Minimum Requirements:

  • • Ubuntu 22.04 LTS
  • • RAM: 4GB (8GB recommended)
  • • Storage: 40GB SSD
  • • CPU: 2 cores (4 cores recommended)

Yang Akan Diinstall:

  • • Python 3.10
  • • MariaDB 10.6+
  • • Redis Server
  • • Node.js 20.x
  • • Nginx
  • • ERPNext 15
1

Update Sistem Ubuntu

Langkah pertama adalah memastikan sistem Ubuntu Anda up-to-date dengan paket terbaru.

Update sistem
sudo apt-get update
sudo apt-get upgrade

Catatan Penting:

  • •Proses ini akan memakan waktu beberapa menit tergantung koneksi internet
  • •Pastikan untuk restart sistem jika ada kernel update
2

Membuat User ERPNext

Buat user khusus untuk ERPNext demi keamanan. Jangan gunakan root user untuk menjalankan aplikasi.

Membuat user erpnext
sudo adduser erpnext
sudo usermod -aG sudo erpnext
su - erpnext

Catatan Penting:

  • •Ganti 'erpnext' dengan username yang Anda inginkan
  • •User ini akan memiliki akses sudo untuk instalasi
  • •Gunakan password yang kuat untuk user ini
3

Install Python dan Dependencies

Install Python 3.10 dan semua dependencies yang diperlukan untuk menjalankan ERPNext.

Install Python dependencies
sudo apt-get install git
sudo apt-get install python3-dev python3.10-dev python3-setuptools python3-pip python3-distutils
sudo apt-get install python3.10-venv
sudo apt-get install software-properties-common

Catatan Penting:

  • •Python 3.10 adalah versi yang direkomendasikan untuk ERPNext 15
  • •Virtual environment diperlukan untuk isolasi dependencies
4

Install MariaDB

Install dan konfigurasi MariaDB sebagai database server untuk ERPNext.

Install MariaDB
sudo apt install mariadb-server mariadb-client

Catatan Penting:

  • •MariaDB adalah database yang direkomendasikan untuk ERPNext
  • •Pastikan MariaDB versi 10.6 atau lebih tinggi
5

Install Redis dan Tools Pendukung

Install Redis untuk caching dan tools pendukung lainnya.

Install Redis dan tools
sudo apt-get install redis-server
sudo apt-get install xvfb libfontconfig wkhtmltopdf
sudo apt-get install libmysqlclient-dev

Catatan Penting:

  • •Redis digunakan untuk caching dan background jobs
  • •wkhtmltopdf diperlukan untuk generate PDF reports
  • •libmysqlclient-dev diperlukan untuk koneksi ke MariaDB
6

Konfigurasi MariaDB

Secure MariaDB installation dan konfigurasi untuk ERPNext.

Secure MariaDB
sudo mysql_secure_installation

Catatan Penting:

  • •Jawab 'Y' untuk semua pertanyaan keamanan
  • •Set password yang kuat untuk root user
  • •Remove anonymous users dan test database
7

Konfigurasi Database untuk ERPNext

Edit konfigurasi MariaDB untuk optimasi ERPNext.

Konfigurasi MariaDB
sudo service mysql restart

# Edit file konfigurasi
sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf

# Tambahkan di bagian [mysqld]:
[mysqld]
innodb-file-format=barracuda
innodb-file-per-table=1
innodb-large-prefix=1
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci

# Restart MariaDB
sudo systemctl restart mariadb

Catatan Penting:

  • •Konfigurasi ini diperlukan untuk mendukung fitur ERPNext
  • •Barracuda format mendukung index yang lebih besar
  • •UTF8MB4 mendukung emoji dan karakter khusus
8

Install Node.js

Install Node.js menggunakan NVM untuk manajemen versi yang lebih baik.

Install Node.js
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install v20.19.1
sudo apt-get install npm
sudo npm install -g yarn

Catatan Penting:

  • •NVM memungkinkan Anda mengelola multiple versi Node.js
  • •Node.js 20.x adalah versi yang direkomendasikan
  • •Yarn digunakan untuk manajemen package JavaScript
9

Install Frappe Bench

Install Frappe Bench dan setup ERPNext site.

Install Frappe Bench
sudo pip3 install frappe-bench
bench init --frappe-branch version-15 frappe-bench
sudo chmod -R o+rx /home/erpnext/
sudo chown -R erpnext:erpnext /home/erpnext/

Catatan Penting:

  • •Frappe Bench adalah tool untuk mengelola aplikasi Frappe
  • •Version-15 adalah branch untuk ERPNext 15
  • •Permission setting diperlukan untuk akses web server
10

Setup ERPNext Site

Buat site ERPNext dan install aplikasi ERPNext.

Setup ERPNext site
cd frappe-bench
bench new-site demo.sopwer.my.id
bench use demo.sopwer.my.id
bench get-app --branch version-15 erpnext
bench install-app erpnext
bench start

Catatan Penting:

  • •Ganti 'demo.sopwer.my.id' dengan domain Anda
  • •Proses install app akan memakan waktu beberapa menit
  • •bench start akan menjalankan development server
11

Setup Production dan SSL

Konfigurasi production server dengan Nginx dan SSL certificate.

Production setup
sudo bench setup production erpnext
sudo snap install --classic certbot
sudo ln -s /snap/bin/certbot /usr/bin/certbot
sudo certbot --nginx
bench config dns_multitenant on
bench setup nginx
sudo service nginx reload

Catatan Penting:

  • •Production setup akan mengkonfigurasi Nginx dan Supervisor
  • •SSL certificate gratis dari Let's Encrypt
  • •Multitenant memungkinkan multiple sites dalam satu server

Selamat! ERPNext 15 Berhasil Diinstall

ERPNext 15 Anda sekarang sudah berjalan di production mode. Anda dapat mengakses sistem melalui domain yang telah dikonfigurasi.