How to Install Framadate on Void Linux

This tutorial will guide you through the installation of Framadate on Void Linux. Framadate is an open-source web application used to schedule appointments or create polls.

Prerequisites

Before installing Framadate, you should have a running instance of Void Linux and root or sudo privileges.

Step 1: Install Dependencies

Framadate requires several dependencies that must be installed. To install them, open your terminal and run the following command:

sudo xbps-install -S git mariadb mariadb-client mariadb-server php7 php7-fpm php7-mysqli php7-curl php7-json php7-mbstring php7-xml nginx

This command will install the following dependencies:

• Git for version control
• MariaDB for the database
• PHP and required extensions for the web application
• Nginx for the web server

Step 2: Clone Framadate Repository

Once the dependencies are installed, clone the Framadate repository from GitHub by running the following command:

git clone https://framagit.org/framasoft/framadate/framadate.git

This command will clone the repository to a directory called framadate.

Step 3: Create a MariaDB Database

Create a new database for Framadate by running the following command:

sudo mysql -u root -p

This command will open the MariaDB prompt. Enter your root password and run the following commands to create a new database and user for Framadate:

MariaDB> CREATE DATABASE framadate;
MariaDB> GRANT ALL PRIVILEGES ON framadate.* TO 'framadate_user'@'localhost' IDENTIFIED BY 'your_password';
MariaDB> FLUSH PRIVILEGES;
MariaDB> EXIT;

This will create a new database called framadate, a new user framadate_user with the specified password, and grant all privileges to the user on the database.

Step 4: Configure Nginx

Create a new Nginx server block to serve your Framadate installation by opening the Nginx configuration file with your preferred text editor:

sudo nano /etc/nginx/nginx.conf

Add the following code at the bottom of the file:

server {
    listen 80;
    server_name your_domain.com;
    root /path/to/framadate;
    index index.php;

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

    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_pass unix:/run/php-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location /doc/ {
        alias /usr/share/doc/framadate/;
    }
}

Replace your_domain.com with your domain name or IP address and /path/to/framadate with the path to your framadate repository directory.

Save and close the file by hitting Ctrl + X, then Y, then Enter.

Step 5: Configure PHP-FPM

Open the PHP-FPM configuration file in your preferred text editor:

sudo nano /etc/php7/php-fpm.d/www.conf

Find the following line:

listen = 127.0.0.1:9000

Comment out this line by adding a semicolon at the beginning:

;listen = 127.0.0.1:9000

Then, add the following line below it:

listen = /run/php-fpm.sock

Save and close the file by hitting Ctrl + X, then Y, then Enter.

Step 6: Install Composer

Install Composer, a dependency manager for PHP, by running the following command:

sudo curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

Step 7: Install Dependencies with Composer

Change into the framadate directory:

cd framadate

Install the required PHP dependencies using Composer:

composer install --no-dev

This command will install all the dependencies required by Framadate.

Step 8: Configure Framadate

Copy the inc/config.php file to a new file called inc/config-custom.php:

cp inc/config.php inc/config-custom.php

Open the inc/config-custom.php file in your preferred text editor and add the following lines at the end of the file:

/* Database */
$__database__ = 'framadate';
$__user__ = 'framadate_user';
$__pass__ = 'your_password';

Replace your_password with the password corresponding to your framadate_user MariaDB user.

Save and close the file by hitting Ctrl + X, then Y, then Enter.

Step 9: Initialize the Database

Initialize the database by running the following command:

php ./index.php install

This command will create the necessary tables in the framadate database.

Step 10: Done

Congratulations! Framadate is now installed on your Void Linux server. Visit your server's domain name or IP address in your web browser to confirm that your installation is working correctly.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!