{"id":1603,"date":"2019-06-18T14:40:16","date_gmt":"2019-06-18T07:40:16","guid":{"rendered":"https:\/\/www.linuxid.net\/post\/?p=1603"},"modified":"2025-04-18T15:21:59","modified_gmt":"2025-04-18T08:21:59","slug":"cara-install-dan-konfigurasi-redmine-di-debian-9","status":"publish","type":"post","link":"https:\/\/www.linuxid.net\/post\/cara-install-dan-konfigurasi-redmine-di-debian-9\/","title":{"rendered":"Cara Install dan Konfigurasi Redmine di Debian 9"},"content":{"rendered":"

Redmine adalah aplikasi manajemen proyek dan pelacakan masalah open free dan open source. Redmine termasuk aplikasi lintas platform dan lintas database, serta dibangun di atas framework Ruby on Rails.<\/p>\n

Redmine<\/a> mencakup dukungan untuk beberapa proyek, wiki, sistem pelacakan masalah, forum, kalender, pemberitahuan email, dan banyak lagi.<\/p>\n

Dalam tutorial ini, kami akan membahas cara menginstal dan mengonfigurasi versi Redmine terbaru di server Debian 9 menggunakan MySQL sebagai back-end database dan Passenger + Nginx sebagai server aplikasi Ruby.<\/p>\n

Prasyarat<\/h2>\n

Pastikan Anda telah memenuhi prasyarat berikut sebelum mulai dengan tutorial ini:<\/p>\n

Membuat database MySQL<\/h2>\n

Redmine mendukung MySQL \/ MariaDB, Microsoft SQL Server, SQLite 3 dan PostgreSQL. Kami akan menggunakan MariaDB sebagai back-end database. Pastikan Anda memiliki setidaknya MySQL 5.7 atau MariaDB 10.3 terinstall di mesin Anda.<\/p>\n

Jika MariaDB atau MySQL belum terinstal di server Debian Anda, Anda dapat menginstalnya menggunakan instruksi ini<\/a>.<\/p>\n

Mulai dengan masuk ke konsol MySQL dengan mengetik:<\/p>\n

sudo mysql<\/pre>\n
Jalankan pernyataan SQL berikut untuk membuat database baru:<\/a><\/p>\n
CREATE DATABASE redmine CHARACTER SET utf8mb4;<\/pre>\n
Buat akun pengguna MySQL baru<\/a> dan berikan akses ke database:<\/p>\n
GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'ubah-dengan-password-anda';<\/pre>\n
Jangan lupa ganti ubah-dengan-password-anda<\/code> dengan kata sandi yang kuat.<\/p>\n
Setelah selesai, keluar dari konsol MariaDB dengan mengetik:<\/p>\n
EXIT;<\/pre>\n
Instal Ruby<\/h2>\n
Cara termudah untuk menginstal Ruby di Debian adalah dengan menggunakan apt package manager:<\/p>\n
Instal Ruby dengan mengetik perintah:<\/p>\n
sudo apt install ruby-full<\/pre>\n
Pada saat penulisan ini, versi Redmine yang ada di dalam repositori Debian adalah 2.3.3p222.<\/code><\/p>\n
Instal Passenger dan Nginx<\/h2>\n
Passenger<\/a> adalah server aplikasi web yang cepat dan ringan untuk Ruby, Node.js, dan Python yang dapat diintegrasikan dengan Apache dan Nginx. Kita akan menginstal Passenger sebagai modul Nginx.<\/p>\n
Pastikan Nginx diinstal sebelum melanjutkan dengan langkah-langkah berikut.<\/p>\n
Menginstal paket yang diperlukan untuk mengaktifkan repositori https:<\/p>\n
sudo apt install dirmngr gnupg apt-transport-https ca-certificates software-properties-common<\/pre>\n
Impor GPG key repositori dan aktifkan repositori Phusionpassenger<\/a>:<\/p>\n
sudo apt-key adv --recv-keys --keyserver hkp:\/\/keyserver.ubuntu.com:80 561F9B9CAC40B2F7
\n
\nsudo add-apt-repository 'deb https:\/\/oss-binaries.phusionpassenger.com\/apt\/passenger stretch main'<\/pre>\n
Perbarui daftar paket dan instal modul Passenger Nginx dengan perintah :<\/p>\n
sudo apt update
\nsudo apt install libnginx-mod-http-passenger<\/pre>\n
Instal Redmine di Debian<\/h2>\n
Mulail dengan menginstal dependensi yang diperlukan untuk membangun Redmine:<\/p>\n
sudo apt install build-essential libmariadbclient-dev imagemagick libmagickwand-dev curl ruby-dev libxslt-dev libxml2-dev zlib1g-dev<\/pre>\n
Pada saat penulisan artikel ini, versi stabil Redmine terbaru adalah versi 4.0.4.<\/p>\n
1. Download Redmine<\/h3>\n
Download archive Redmine dengan menggunakan perintah\u00a0curl<\/a> berikut :<\/p>\n
sudo curl -L http:\/\/www.redmine.org\/releases\/redmine-4.0.4.tar.gz -o \/tmp\/redmine.tar.gz<\/pre>\n
Setelah pengunduhan selesai, ekstrak<\/a> arsip dan pindahkan<\/a> ke direktori \/opt<\/code>:<\/p>\n
cd \/tmp
\n
\nsudo tar zxf \/tmp\/redmine.tar.gz
\n
\nsudo mv \/tmp\/redmine-4.0.4 \/opt\/redmine<\/pre>\n
2. Konfigurasi Database Redmine<\/h3>\n
Salin file\u00a0contoh konfigurasi (.example<\/code>) Redmine dengan mengetik perintah :<\/p>\n
sudo cp \/opt\/redmine\/config\/database.yml.example \/opt\/redmine\/config\/database.yml<\/pre>\n
Buka file contoh konfigurasi Redmine dengan teks editor di linux terminal dengan mengetik perintah :<\/p>\n
sudo nano \/opt\/redmine\/config\/database.yml<\/pre>\n
Cari bagian production<\/code> dan masukkan database MySQL serta\u00a0 informasi pengguna yang telah kita buat sebelumnya:<\/p>\n
production:
\n  adapter: mysql2
\n  database: redmine
\n  host: localhost
\n  username: redmine
\n  password: \"change-with-strong-password\"
\n  encoding: utf8<\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/code><\/pre>\n
Setelah selesai, simpan file dan keluar dari editor.<\/p>\n
3. Install dependensi Ruby<\/h3>\n
Arahkan<\/a> ke direktori redmine dan instal bundler serta dependensi Ruby lainnya:<\/p>\n
cd \/opt\/redmine\/
\nsudo gem install bundler --no-rdoc --no-ri
\nsudo bundle install --without development test postgresql sqlite<\/pre>\n
4. Hasilkan Key dan Migrasikan Database<\/h3>\n
Jalankan perintah berikut untuk menghasilkan kunci dan memigrasi database:<\/p>\n
cd \/opt\/redmine\/
\nsudo bundle exec rake generate_secret_token
\nsudo RAILS_ENV=production bundle exec rake db:migrate<\/pre>\n
5. Tetapkan Izin yang benar<\/h3>\n
Nginx berjalan sebagai pengguna dan grup www-data<\/code>. Tetapkan izin yang benar dengan menggunakan\u00a0perintah chown<\/a> berikut:<\/p>\n
sudo chown -R www-data: \/opt\/redmine\/<\/pre>\n
Konfigurasikan Nginx<\/h2>\n
Sekarang, Anda harus sudah menginstal Nginx dengan sertifikat SSL di sistem Anda, jika tidak memeriksa prasyarat untuk tutorial ini.<\/p>\n
Buka editor teks Anda dan buat file server block Nginx berikut:<\/p>\n
sudo nano \/etc\/nginx\/sites-available\/example.com<\/pre>\n
# Redirect HTTP -> HTTPS
\nserver {
\n    listen 80;
\n    server_name www.example.com example.com;
\n
\n    include snippets\/letsencrypt.conf;
\n    return 301 https:\/\/example.com$request_uri;
\n}
\n
\n# Redirect WWW -> NON WWW
\nserver {
\n    listen 443 ssl http2;
\n    server_name www.example.com;
\n
\n    ssl_certificate \/etc\/letsencrypt\/live\/example.com\/fullchain.pem;
\n    ssl_certificate_key \/etc\/letsencrypt\/live\/example.com\/privkey.pem;
\n    ssl_trusted_certificate \/etc\/letsencrypt\/live\/example.com\/chain.pem;
\n    include snippets\/ssl.conf;
\n
\n    return 301 https:\/\/example.com$request_uri;
\n}
\n
\nserver {
\n    listen 443 ssl http2;
\n    server_name example.com;
\n
\n    root \/opt\/redmine\/public;
\n
\n    # SSL parameters
\n    ssl_certificate \/etc\/letsencrypt\/live\/example.com\/fullchain.pem;
\n    ssl_certificate_key \/etc\/letsencrypt\/live\/example.com\/privkey.pem;
\n    ssl_trusted_certificate \/etc\/letsencrypt\/live\/example.com\/chain.pem;
\n    include snippets\/ssl.conf;
\n    include snippets\/letsencrypt.conf;
\n
\n    # log files
\n    access_log \/var\/log\/nginx\/example.com.access.log;
\n    error_log \/var\/log\/nginx\/example.com.error.log;
\n
\n    passenger_enabled on;
\n    passenger_min_instances 1;
\n    client_max_body_size 10m;
\n}<\/pre>\n
\u00a0<\/p>\n
Jangan lupa untuk mengganti example.com dengan domain Redmine Anda dan setel jalur yang benar ke file sertifikat SSL. Snippets yang digunakan dalam konfigurasi ini dibuat dalam panduan ini.<\/a><\/p>\n
Aktifkan server block dengan membuat symbolic link<\/a> ke direktori sites-enabled<\/code>:<\/p>\n
sudo ln -s \/etc\/nginx\/sites-available\/example.com \/etc\/nginx\/sites-enabled\/<\/pre>\n
Sebelum memulai kembali layanan Nginx, lakukan tes untuk memastikan bahwa tidak ada kesalahan sintaksis:<\/p>\n
sudo nginx -t<\/pre>\n
Jika tidak ada kesalahan, hasilnya akan terlihat seperti ini:<\/p>\n
nginx: the configuration file \/etc\/nginx\/nginx.conf syntax is ok
\nnginx: configuration file \/etc\/nginx\/nginx.conf test is successful<\/code><\/pre>\n
Terakhir, restart layanan Nginx dengan mengetik:<\/p>\n
sudo systemctl restart nginx<\/pre>\n
Mengakses Redmine<\/h2>\n
Buka browser dan ketikkan domain Anda, Jika instalasi berhasil, akan muncul tampilan yang mirip dengan screen shot berikut ini akan muncul:<\/p>\n
\"\"<\/a><\/p>\n
Kredensial login default untuk Redmine adalah:<\/p>\n