Carbonio mewajibkan penggunaan locale sistem en_US.UTF-8.
Jika server menggunakan locale lain, hal ini bisa menyebabkan error tak terduga atau service Carbonio tidak berjalan dengan normal.

Tulisan ini menjelaskan langkah-langkah untuk memverifikasi dan mengatur locale sistem agar sesuai dengan kebutuhan Carbonio.

⚠️ Catatan penting
Semua perintah di bawah harus dijalankan sebagai user root.

Step 0 Verifikasi Locale Saat Ini

Pertama, cek locale yang sedang digunakan oleh sistem:

locale

Jika seluruh output sudah menggunakan en_US.UTF-8, maka tidak ada tindakan lanjutan yang diperlukan.

Contoh output yang benar:

LANG=en_US.UTF-8
LANGUAGE=
LC_CTYPE="en_US.UTF-8"
LC_NUMERIC="en_US.UTF-8"
LC_TIME="en_US.UTF-8"
LC_COLLATE="en_US.UTF-8"
LC_MONETARY="en_US.UTF-8"
LC_MESSAGES="en_US.UTF-8"
LC_PAPER="en_US.UTF-8"
LC_NAME="en_US.UTF-8"
LC_ADDRESS="en_US.UTF-8"
LC_TELEPHONE="en_US.UTF-8"
LC_MEASUREMENT="en_US.UTF-8"
LC_IDENTIFICATION="en_US.UTF-8"
LC_ALL=

Jika hasilnya berbeda (misalnya id_ID.UTF-8, C, atau locale lain), lanjutkan ke langkah berikutnya.

Step 1 Mengubah Konfigurasi Locale

Gunakan perintah berikut untuk mengatur locale default sistem:

localectl set-locale LANG=en_US.utf8

Perintah ini akan mengatur locale sistem secara global ke en_US.UTF-8.

Step 2 Reload Konfigurasi Locale

Agar perubahan diterapkan dengan benar, reload konfigurasi locale sesuai dengan sistem operasi yang digunakan.

Ubuntu

source /etc/default/locale

RHEL / CentOS / Rocky / AlmaLinux

Biasanya tidak diperlukan perintah tambahan, namun logout & login ulang atau reboot sangat disarankan agar perubahan benar-benar aktif.

Step 3 Verifikasi Perubahan Locale

Jalankan kembali perintah berikut:

locale

Pastikan seluruh locale sudah menggunakan en_US.UTF-8, sama seperti contoh pada Step 0.

Penutup

Dengan memastikan locale sistem menggunakan en_US.UTF-8, Carbonio dapat berjalan dengan stabil dan terhindar dari berbagai masalah terkait encoding, service startup, maupun error yang sulit dilacak.