How to Install Phabricator on Void Linux

Phabricator is a collection of open-source web applications that help software development teams plan, build, and manage their projects. In this tutorial, we will guide you through the process of installing Phabricator on Void Linux.

Prerequisites

Before we proceed, make sure the following prerequisites are installed on your system:

  • A running instance of Void Linux
  • A user account with sudo privileges
  • A web server (such as Apache or Nginx)
  • PHP version 7.2 or higher (with necessary extensions)
  • MySQL or MariaDB database server

Installing Phabricator

Follow the steps below to install Phabricator on your Void Linux instance.

Step 1: Install Required Packages

First, we need to install some packages and extensions required by Phabricator. To do so, run the following command:

sudo xbps-install git php php-fpm php-mysql php-mbstring php-gd php-curl php-apcu php-json php-pcntl php-zip mysql mariadb mariadb-client mariadb-server pcre nginx

Step 2: Configure MySQL/MariaDB

Next, let’s configure the MySQL/MariaDB database server. Follow the steps below:

  1. Start the MySQL/MariaDB service:
sudo service mysql start
  1. Log in to the MySQL/MariaDB server as the root user:
sudo mysql -u root
  1. Create a new database for Phabricator:
CREATE DATABASE phabricator;
  1. Create a new user and assign privileges to the new database:
CREATE USER 'phabricator'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON phabricator.* TO 'phabricator'@'localhost';
FLUSH PRIVILEGES;
  1. Exit the MySQL/MariaDB server:
exit

Step 3: Clone Phabricator Repository

Now, let’s clone the Phabricator repository from GitHub:

git clone https://github.com/phacility/phabricator.git /var/www/phabricator

Step 4: Configure Nginx

Let’s configure Nginx to work with Phabricator. Create a new server block in the Nginx configuration file:

sudo nano /etc/nginx/conf.d/phabricator.conf

Insert the following configuration:

server {
listen 80;
server_name example.com;

root /var/www/phabricator/webroot;
index index.php;

access_log /var/log/nginx/access.log combined;
error_log /var/log/nginx/error.log error;

location / {
    try_files $uri $uri/ =404;
}

location /index.php {
    fastcgi_pass unix:/run/php-fpm/php-fpm.sock;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
}

location /static {
    alias /var/www/phabricator/webroot/static;
    expires 30d;
    add_header Cache-Control public;
}

location /ws/ {
    proxy_pass http://127.0.0.1:9000/ws/;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}

location /repo/ {
    proxy_pass http://127.0.0.1:8080/; 
}

error_page 500 502 503 504 /50x.html;
location = /50x.html {
    root /usr/share/nginx/html;
   }
}

Save the file and exit.

Step 5: Configure Phabricator

Now, let’s configure Phabricator. Navigate to the Phabricator installation directory:

cd /var/www/phabricator

Then, run the following command:

sudo ./bin/config set mysql.user phabricator
sudo ./bin/config set mysql.pass password
sudo ./bin/config set mysql.host localhost
sudo ./bin/config set mysql.port 3306
sudo ./bin/config set storage.local-disk.path /var/tmp/phabricator

# Email Configuration
sudo ./bin/config set metamta.mail-adapter PhabricatorMailImplementationPHPMailerAdapter
sudo ./bin/config set phpmailer.mailer-type smtp
sudo ./bin/config set phpmailer.smtp-host smtp.gmail.com
sudo ./bin/config set phpmailer.smtp-port 587
sudo ./bin/config set phpmailer.smtp-user [email protected]
sudo ./bin/config set phpmailer.smtp-password XXXXXXXX
sudo ./bin/config set phpmailer.smtp-auth true
sudo ./bin/config set phpmailer.smtp-secure tls
sudo ./bin/config set metamta.default-address [email protected]
sudo ./bin/config set metamta.domain example.com

Step 6: Start Services

Now, let’s start the necessary services:

sudo service php-fpm start
sudo service nginx start
sudo ./bin/phd start
sudo ./bin/aphlict start

Step 7: Access Phabricator

Finally, access Phabricator on your web browser by visiting:

http://example.com

Replace "example.com" with your domain or server IP address.

That’s it! You have successfully installed Phabricator on Void Linux.