Install InvoicePlane di Ubuntu 24.04

Mengelola tagihan dan pembayaran secara profesional tidak harus menggunakan perangkat lunak berbayar. Banyak bisnis kecil hingga menengah kini memilih solusi open source yang fleksibel, mudah dikustomisasi, dan bisa di-hosting sendiri. Salah satu aplikasi populer di kategori ini adalah InvoicePlane, sebuah sistem invoicing open source yang ringan namun kaya fitur. Panduan ini akan menunjukkan cara menginstalnya di server Ubuntu secara lengkap dan terstruktur.

Pengenalan InvoicePlane

InvoicePlane adalah aplikasi open source untuk mengelola faktur (invoice), penawaran (quotes), pembayaran, klien, hingga laporan bisnis. Proyek ini dikembangkan secara aktif dan tersedia gratis untuk digunakan pada server Anda sendiri.

Beberapa fitur penting yang ditawarkan InvoicePlane meliputi:

• Manajemen Invoice & Quotes: Membuat, mengirim, dan mengelola invoice serta penawaran dengan mudah.
• Manajemen Klien: Menyimpan data pelanggan lengkap dengan histori pembayaran.
• Tracking Pembayaran: Mendukung pencatatan pembayaran manual atau melalui berbagai metode pembayaran.
• Template & Kustomisasi: Menggunakan template PDF untuk mencetak invoice profesional.
• Multi Currency: Mendukung berbagai mata uang.
• Tax Management: Manajemen pajak barang/jasa.
• Dashboard Lengkap: Melihat overview bisnis, tagihan tertunda, dan statistik.
• API (opsional): Mengintegrasikan InvoicePlane dengan aplikasi lain.
• Support Quote → Invoice Conversion: Konversi penawaran menjadi invoice dalam satu klik.

System Requirements

Software Minimum

• Web Server: Apache (direkomendasikan)
• PHP:
  • Versi: PHP 7.4 – PHP 8.1
  • Ekstensi wajib:
    • mysqli
    • gd
    • openssl
    • mbstring
    • curl
    • zlib
    • intl
    • zip
    • bcmath
• Database: MySQL 5.7+ atau MariaDB 10.3+

Hardware Minimum

• RAM: 1 GB (disarankan 2 GB)
• Storage: 10 GB+

Tutorial ini menggunakan sistem operasi Ubuntu.

Persiapan Server

Perbarui sistem server terlebih dahulu:

sudo apt update && sudo apt upgrade -y

Install Apache web server dan certbot:

sudo apt install apache2 certbot python3-certbot-apache -y

Install MariaDB:

sudo apt install mariadb-server -y

Tambah repository PPA ondrej/php:

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

Install PHP 8.1 dan extension yang dibutuhkan:

sudo apt install libapache2-mod-php8.1 php8.1 php8.1-common php8.1-cli \
php8.1-curl php8.1-intl php8.1-gd php8.1-xsl php8.1-mbstring php8.1-zip \
php8.1-xml php8.1-bz2 php8.1-mysql php8.1-soap php8.1-gmp php8.1-bcmath \
php8.1-apcu php8.1-imagick php8.1-imap php8.1-xdebug unzip -y

Membuat Database

Login ke MariaDB:

sudo mysql

Membuat database dan user:

CREATE DATABASE invoiceplane;
CREATE USER 'invoiceplane'@'localhost' IDENTIFIED BY 'secretpassword';
GRANT ALL PRIVILEGES ON invoiceplane.* TO 'invoiceplane'@'localhost';
FLUSH PRIVILEGES;
exit

Konfigurasi Virtual Host

Membuat konfigurasi Apache virtual host untuk invoiceplane.domain.com:

sudo nano /etc/apache2/sites-available/invoiceplane.domain.com.conf

Masukkan konfigurasinya:

<VirtualHost *:80>
    ServerName invoiceplane.domain.com
    DocumentRoot /var/www/invoiceplane.domain.com
    <Directory /var/www/invoiceplane.domain.com>
        Options -Indexes +FollowSymLinks +MultiViews
        AllowOverride All
        Require all granted
    </Directory>
    ErrorLog /var/log/apache2/invoiceplane.domain.com_error.log
    CustomLog /var/log/apache2/invoiceplane.domain.com_access.log combined
</VirtualHost>

Aktifkan virtual host dan restart apache2:

sudo a2ensite invoiceplane.domain.com
sudo systemctl restart apache2

Request sertifikat SSL:

sudo certbot --non-interactive \
-m [email protected] \
--agree-tos \
--no-eff-email \
--apache -d invoiceplane.domain.com \
--redirect

Install InvoicePlane

Download InvoicePlane:

wget https://github.com/InvoicePlane/InvoicePlane/releases/download/v1.6.3/v1.6.3.zip -O InvoicePlane_v1.6.3.zip

Extract InvoicePlane_v1.6.3.zip:

unzip InvoicePlane_v1.6.3.zip

Pindahkan ke direktori /var/www:

sudo mv ip /var/www/invoiceplane.domain.com

Aktifkan file .htaccess:

cd /var/www/invoiceplane.domain.com
sudo mv htaccess .htaccess

Aktifkan file ipconfig.php:

sudo cp ipconfig.php.example ipconfig.php
sudo nano ipconfig.php

Sesuaikan konfigurasinya:

IP_URL=https://invoiceplane.domain.com
REMOVE_INDEXPHP=true

Atur ownership direktori:

sudo chown -R www-data:www-data /var/www/invoiceplane.domain.com

Akses https://invoiceplane.domain.com:

1. Lanjutkan instalasi InvoicePlane, klik Setup.
2. Pilih bahasa.
3. Pemeriksaan system requirements dan direktori.
4. Masukkan database, username, dan password.
5. Install Tables.
6. VAT Calculation.
7. Membuat user account.

Buka kembali ipconfig.php:

sudo nano ipconfig.php

Atur Disable Setup:

DISABLE_SETUP=true

Instalasi InvoicePlane telah selesai.

Penutup

InvoicePlane adalah solusi ideal bagi bisnis yang membutuhkan sistem invoicing self-hosted, fleksibel, dan mudah digunakan. Dengan mengikuti panduan ini, Anda dapat menginstal InvoicePlane di server Ubuntu dengan konfigurasi lengkap mulai dari LAMP, virtual host, SSL, hingga instalasi aplikasi. Setelah sistem berjalan, Anda bisa langsung menggunakannya untuk mengelola faktur, klien, dan pembayaran secara profesional.