File .env

Konfigurasikan Navixy yang berjalan dengan Docker menggunakan file .env. Tetapkan kredensial basis data, nama domain, jalur sertifikat SSL, opsi Let's Encrypt, dan parameter MySQL.

Untuk menjalankan versi Docker platform Navixy, file .env adalah file konfigurasi utama. File ini berisi parameter penting seperti kredensial basis data, nama domain, folder kerja instalasi platform, dan lainnya.

Itu .env file ini terutama digunakan saat instalasi awal platform. Namun, jika Anda perlu mengubah sesuatu dalam konfigurasi platform yang sudah ada, Anda juga perlu memodifikasi file ini.

Semua parameter dalam file ini dikomentari agar lebih mudah memahami apa yang Anda hadapi. Informasi tambahan tentang parameter-parameter ini dijelaskan di bagian-bagian di bawah.

Jika Anda mengubah pengaturan konfigurasi apa pun saat instance sudah berjalan, perubahan tidak diterapkan secara instan. Anda perlu menginisialisasi ulang seluruh instance agar perubahan berlaku. Untuk melakukannya, dari folder utama platform (navixy-package), jalankan perintah: docker compose up -d Ini akan membuat ulang container dengan pengaturan baru.

UID dan GID

Ini adalah parameter layanan yang hanya digunakan pada tahap pembuatan platform. Anda tidak perlu mengubahnya.

WORKDIR

Ini adalah parameter yang menunjukkan direktori kerja platform - tempat basis data dan semua file layanan disimpan. Direktori ini perlu diamankan untuk menghindari kehilangan data bisnis.

Nilai default parameter ini: WORKDIR=./work.

Ini berarti bahwa /work direktori di dalam build Navixy yang telah dibongkar digunakan. Jika direktori tersebut tidak ada, direktori itu akan dibuat.

Jika perlu, Anda dapat menempatkan direktori kerja di mana saja di sistem Anda. Untuk melakukannya, tentukan path lengkap ke direktori tersebut. Contoh:

• /home/admin/work

• /usr/local/navixy

Pastikan Anda memberi direktori itu nama yang jelas agar tidak terhapus secara tidak sengaja.

navixy_username

Ini adalah nama pengguna yang digunakan untuk akses basis data. Nilainya selalu navixy, jangan ubah.

navixy_passwd

Ini adalah kata sandi untuk navixy pengguna basis data. Secara default, nilai ini kosong dan Anda diwajibkan menentukan kata sandi pilihan Anda. Disarankan untuk membuat kata sandi kuat secara otomatis, tetapi pilihan ada pada Anda, Anda dapat menentukan apa pun yang Anda inginkan.

Jangan ubah kata sandi ini setelah basis data dibuat dan platform diterapkan.

service_domain

Ini adalah domain utama instance platform Anda. Ini digunakan untuk:

• Akses ke antarmuka pengguna.

• Aktivasi perangkat.

Jika Anda menggunakan instalasi satu domain (tanpa domain terpisah untuk API dan panel admin), domain ini juga akan digunakan untuk:

• Akses ke API melalui tautan service_domain/api

• Akses ke panel admin melalui tautan service_domain/panel

Ini juga dapat berupa alamat IP server Anda jika Anda tidak akan menggunakan nama domain untuk layanan Anda.

api_domain

Parameter ini opsional dan hanya digunakan untuk instalasi tiga domain.

Di sini Anda perlu menentukan nama domain yang digunakan untuk mengakses API platform Anda.

panel_domain

Ini juga parameter opsional yang digunakan untuk instalasi tiga domain.

Di sini Anda perlu menentukan nama domain yang digunakan untuk mengakses panel admin platform Anda.

le_enabled

Parameter ini mengaktifkan penerbitan otomatis dan penerbitan ulang sertifikat SSL Let's Encrypt.

Nilainya true secara default. Ini berarti bahwa saat Anda men-deploy platform, Certbot akan dikonfigurasi dan akan menangani penerbitan sertifikat SSL otomatis untuk domain Anda. Dengan cara ini, Anda tidak perlu khawatir membeli sertifikat pihak ketiga. Instance akan mengonfigurasikan dirinya sendiri agar terlindungi oleh SSL.

Jika Anda ingin menggunakan sertifikat SSL Anda sendiri alih-alih Let’s Encrypt, ubah parameter ini menjadi false.

le_email

Ini adalah alamat email untuk menerima informasi tentang operasi Certbot, seperti masa berlaku sertifikat berakhir, pencabutan sertifikat, dan masalah yang dapat menyebabkan ketidakmampuan untuk menerbitkan ulang sertifikat.

Secara default, parameter ini kosong. Disarankan agar Anda menentukan alamat email yang valid agar Anda tidak melewatkan notifikasi penting tentang perlindungan SSL situs web Anda.

redirect_to_https

Pengaturan ini memungkinkan permintaan dialihkan dari http ke https. Jika platform Anda dikonfigurasi untuk menggunakan perlindungan SSL dan seseorang mencoba menggunakan URL yang diawali dengan http, pengalihan otomatis ke https akan dipicu.

Jika parameter dinonaktifkan (false), maka tidak akan terjadi pengalihan, dan situs web tidak akan dibuka.

Parameter ini hanya berlaku jika perlindungan SSL diaktifkan dan sertifikat SSL diinstal.

service_ssl_cert dan service_ssl_key

Jika Anda tidak berencana menggunakan Let's Encrypt dan ingin menggunakan sertifikat SSL Anda sendiri sebagai gantinya, Anda perlu menempatkan sertifikat untuk domain Anda dan kunci privatnya ke direktori: WORKDIR/nginx/ssl.

Pastikan Anda mengalihkan le_enabled parameter ke false sebelum menerapkan perubahan apa pun pada bagian ini. Anda tidak dapat menggunakan sertifikat Anda sendiri untuk platform saat certbot berjalan.

Setelah sertifikat dan kunci tersedia, Anda perlu menentukan nama file mereka untuk parameter yang sesuai dalam konfigurasi. Perhatikan bahwa Anda tidak perlu menentukan path. Contoh:

service_ssl_cert=my_domain_com.crt
service_ssl_key=my_domain_com.key

MYSQL_RANDOM_ROOT_PASSWORD

Parameter ini mengaktifkan pembuatan kata sandi acak untuk MySQL root pengguna. Nilai defaultnya adalah true.

Parameter ini hanya digunakan selama inisialisasi basis data awal saat menginstal platform. Pada restart dan pembaruan platform berikutnya, parameter ini tidak melakukan apa pun, dan kata sandi tetap sama.

Jika Anda lebih suka menetapkan kata sandi root MySQL tertentu, ubah nilai menjadi false dan lanjutkan ke parameter berikutnya.

MYSQL_ROOT_PASSWORD

Di sini Anda menentukan kata sandi root untuk MySQL.

Parameter ini diterapkan hanya ketika MYSQL_RANDOM_ROOT_PASSWORD diubah menjadi false. Jika tidak, nilai tersebut diabaikan.

skip_db_update

Parameter ini menonaktifkan pembaruan basis data ketika navixy-standalone-db kontainer dijalankan. Parameter ini digunakan untuk tujuan pengujian, Anda tidak perlu mengubah nilai default (false) selama penggunaan platform secara normal.