How to Install Baïkal on Void Linux

Baïkal is a CalDAV and CardDAV server that allows you to sync your contacts, calendars, and tasks across various devices. In this tutorial, we will be showing you how to install Baïkal on Void Linux.

Prerequisites

A running instance of Void Linux
Basic knowledge of the command line

Installation

Open a terminal on your Void Linux machine.
Update the system by running the following command:
```
sudo xbps-install -Syu
```
Install the necessary packages for Baïkal by running the following command:
```
sudo xbps-install nginx php-fpm php-pdo_mysql php-mbstring php-xml
```
Download the latest version of Baïkal from the official website:
```
wget https://github.com/fruux/Baikal/releases/latest/download/baikal-0.X.X.zip
```
Replace 0.X.X with the latest version number.
Unzip the file:
```
unzip baikal-0.X.X.zip
```
Move the extracted files to the web server's document root directory:
```
sudo mv baikal /var/www/localhost/htdocs/
```

Set the appropriate ownership and permission:

sudo chown -R nginx /var/www/localhost/htdocs/baikal
sudo chmod -R 755 /var/www/localhost/htdocs/baikal

Configure Nginx by creating a virtual host file for Baïkal:

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

Paste the following configuration:

server {
    listen 80;
    server_name yourdomain.com; # Replace with your own domain name
    root /var/www/localhost/htdocs/baikal/Specific;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php$is_args$args;
    }

    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_pass unix:/run/php-fpm.sock; # Check the path to the PHP-FPM socket
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location /.well-known/carddav {
        return 301 /baikal/card.php/addressbooks/*/default;
    }

    location /.well-known/caldav {
        return 301 /baikal/cal.php/calendars/*/default;
    }
}

Test the Nginx configuration for syntax errors:
```
sudo nginx -t
```
If the syntax is correct, restart the Nginx service:
```
sudo systemctl restart nginx
```

Set up the database by creating a new MySQL database and user:

sudo mysql -u root -p

Enter the MySQL root password when prompted.

CREATE DATABASE baikal;
CREATE USER 'baikal'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON baikal.* TO 'baikal'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Replace password with your own secure password.

Install the database schema by running the following command:
```
mysql -u root -p baikal < /var/www/localhost/htdocs/baikal/Specific/db/DBEngine/MySQL/MySQL.sql
```
You will be prompted to enter the MySQL root password.

Configure Baïkal by creating a configuration file:

sudo nano /var/www/localhost/htdocs/baikal/Specific/Config/config.php

Paste the following configuration:

<?php
    $bd->DSN="mysql:host=localhost;dbname=baikal;charset=utf8";
    $bd->user="baikal";
    $bd->password="password"; # Replace with your own password

Replace password with the password you set during Step 10.

Test the Baïkal installation by navigating to http://yourdomain.com/baikal/html/admin/ in your web browser. You should see the Administration interface.

Congratulations! You have successfully installed Baïkal on Void Linux. You can now start syncing your contacts, calendars, and tasks across your various devices.