Install UVdesk di Ubuntu 24.04

Dalam dunia layanan pelanggan (customer support), memiliki sistem tiket (helpdesk) yang andal sangat penting untuk mengelola pertanyaan, bug, dan permintaan dari pengguna. UVdesk adalah salah satu solusi helpdesk open source yang populer karena fleksibilitas, skalabilitas, dan kemampuannya untuk disesuaikan sesuai kebutuhan bisnis Anda. Pada artikel ini, kita akan membahas secara lengkap apa itu UVdesk, fitur utamanya, sistem kebutuhan, serta langkah-langkah instalasinya pada Ubuntu.

Pengenalan UVdesk

UVdesk adalah sistem helpdesk berbasis open source yang dirancang untuk membantu tim support dalam mengelola tiket, email, dan interaksi pelanggan. Dibangun dengan framework Symfony (PHP), UVdesk mendukung integrasi yang fleksibel, otomatisasi alur kerja (workflow), dan branding kustom. Karena sifatnya open source, bisnis dapat mengunduh, memodifikasi, dan memperluas kode dasar agar sesuai dengan kebutuhan dukungan pelanggan mereka.

Di situs resminya, UVdesk menyediakan versi SaaS maupun open source, sehingga memberikan pilihan kepada organisasi apakah ingin menjalankannya di infrastruktur sendiri atau menggunakan host eksternal.

Fitur UVdesk Versi Open Source

UVdesk Open Source menawarkan beragam fitur yang membuatnya kompetitif dan sangat bisa diandalkan:

Branding: bisa menyesuaikan tampilan helpdesk dengan logo, favicon, dan elemen branding lainnya.
Fleksibel untuk Modifikasi: karena berbasis open source (Symfony), sistem ini sangat bisa dikustomisasi agar sesuai dengan alur bisnis tertentu.
Knowledge Base: menyediakan portal artikel, FAQ, dan dokumentasi agar pelanggan dapat menemukan jawaban sendiri.
Manajemen Kotak Surat (Mailbox): mendukung email masuk yang dikonversi menjadi tiket, bahkan mendukung banyak alamat email.
Saved Replies (Balasan Tersimpan): bisa membuat template balasan untuk pertanyaan umum agar lebih efisien.
Manajemen Tiket: memungkinkan pengelolaan tiket: penandaan (tag), filter berdasarkan status, agen, pelanggan, dan lainnya.
Tag Ticket: tiket dapat diberi tipe dan tag agar pencarian dan pengelompokan lebih mudah.
Manajemen Pengguna: mendukung banyak agen, tim, grup, dengan peran dan izin khusus.
Automasi / Workflow: dapat membuat aturan otomatis berdasarkan event tertentu, misalnya: ketika tiket baru masuk, kirim notifikasi, ubah status, dsb.
Integrasi Modul: mendukung pengembangan modul ekstensi serta koneksi dengan aplikasi pihak ketiga.
Open Source: bebas mengakses, memeriksa, dan memodifikasi kode dasar UVdesk.

Selain itu, dari repositori GitHub UVdesk (community-skeleton), ada beberapa fitur lanjutan seperti manajemen kolaborator tiket, API, manajemen lampiran, dan portal pengguna yang dapat dikustomisasi.

Pengguna UVdesk Versi Open Source

Beberapa organisasi telah menggunakan UVdesk versi open source untuk kebutuhan helpdesk mereka. Daftar klien open source UVdesk mencakup berbagai jenis perusahaan, seperti Charitybay, Mind Spark Technologies, PH1 Consulting, Robocraze, Webdp, dan lainnya.

Penggunaan oleh berbagai perusahaan ini menunjukkan bahwa UVdesk cocok untuk kebutuhan multi-industri, dari startup kecil hingga organisasi menengah yang ingin mengelola dukungan pelanggan secara self-hosted.

Instalasi UVdesk

1. System Requirements

Sebelum menginstal UVdesk di Ubuntu, Anda perlu memastikan bahwa server memenuhi persyaratan berikut:

Persyaratan Hardware:

Prosesor minimal 1 GHz
RAM minimal 4 GB

Persyaratan Software:

PHP 7.3+
Composer (versi 2)
Ekstensi PHP: IMAP dan Mailparse
Web server: Apache (atau Nginx)
Database: MySQL atau MariaDB

2. Instalasi LAMP Stack

Perbarui sistem Ubuntu terlebih dahulu:

sudo apt update
sudo apt upgrade -y

Instalasi Apache web server dan certbot:

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

Instalasi MariaDB database server:

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.2 dan extension yang dibutuhkan:

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

Install Composer:

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

3. Membuat Database

sudo mysql

Buat database dan user:

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

4. Konfigurasi Virtual Host

Buat konfigurasi Apache virtual host untuk help.domain.com:

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

Masukkan konfigurasinya:

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

Aktifkan virtual host dan restart apache2:

sudo a2ensite help.domain.com
sudo systemctl restart apache2

Request sertifikat SSL:

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

5. Instalasi UVdesk via Composer

Buat proyek UVdesk dengan Composer:

composer create-project uvdesk/community-skeleton help.domain.com

Pindah direktori help.domain.com ke /var/www:

sudo mv help.domain.com /var/www

Atur ownership direktori:

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

Lanjut instalasi di web browser. Akses https://help.domain.com.

Welcome to the helpdesk installation wizard, klik LET'S BEGIN.
Pemeriksaan system requirements. Jika semuanya terpenuhi, klik PROCEED.
Database configuration, masukkan nama database, username, dan password. Lalu PROCEED.
Create Super Admin Account, masukkan nama, email, dan password. Lalu PROCEED.
Website Configuration, pengatur Member Panel Prefix, dan Customer Panel Prefix. Lalu PROCEED.
Terakhir klik INSTALL NOW.

UVdesk telah selesai terinstal. Klik Admin Panel untuk login ke Admin/Member Panel, dan klik Knowledgebase untuk menampilkan frontend UVdesk.

6. Pengaturan .env

Generate key dengan openssl untuk APP_SECRET:

openssl rand -hex 32

Contoh respon:

965da254d08366dca455db7e0691cb493233d8250bb2a058291beee0b1b459c2

Buka file .env:

sudo nano /var/www/help.domain.com/.env

Atur konfigurasinya:

APP_ENV=prod
APP_SECRET=965da254d08366dca455db7e0691cb493233d8250bb2a058291beee0b1b459c2

Penutup

Setelah mengikuti panduan di atas, Anda sekarang bisa menginstal UVdesk Open Source di server dan mulai membangun sistem helpdesk sendiri. Karena bersifat open source dan dibangun di atas Symfony, Anda memiliki kebebasan penuh untuk menyesuaikan, memperluas, dan mengintegrasikan UVdesk sesuai kebutuhan bisnis. Selain itu, dengan komunitas dan klien yang sudah menggunakan versi open source, Anda bisa merasa yakin bahwa ini adalah solusi yang telah teruji dan bisa diskalakan. Selamat mencoba dan semoga sistem dukungan pelanggan Anda menjadi lebih terstruktur dan efisien!