How to Install eLabFTW on Void Linux

eLabFTW is a popular open-source electronic lab notebook used to store, manage, and share experimental data. In this tutorial, we will walk you through the step-by-step installation of eLabFTW on Void Linux.

Step 1: Update Packages

First, you need to update the packages on your system using the following command:

sudo xbps-install -Suv

This will download and install the latest updates for all packages on your system.

Step 2: Install Required Dependencies

To set up eLabFTW, you need to install a few dependencies on your system. Use the following command to install them:

sudo xbps-install -y php php-fpm nginx mariadb-server mariadb-client

The above command installs the required dependencies for eLabFTW to run correctly.

Step 3: Configure MariaDB

Now that your system is up-to-date and required dependencies have been installed, you need to configure MariaDB.

We recommend you use the following command to make your MariaDB installation more secure:

sudo mysql_secure_installation

This command will prompt you to set a root password, remove anonymous users and restrict remote login access.

Step 4: Install eLabFTW

In this step, you need to download and install eLabFTW. Use the following command to download the latest version of eLabFTW on your system:

sudo wget https://github.com/elabftw/elabftw/archive/{version_number}.tar.gz

Replace {version_number} with the version you want to download.

After you have downloaded the file, extract it using the following command:

sudo tar xf {version_number}.tar.gz -C /usr/share/nginx/html

This command will extract eLabFTW to /usr/share/nginx/html directory.

Step 5: Configure Nginx

In this step, you need to configure Nginx to host eLabFTW.

Create a new configuration file with the following command:

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

Add the following configuration to the file:

server {
  listen 80;
  server_name {your_domain_name};
  root /usr/share/nginx/html/elabftw-XXX;

  index index.php index.html;

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

  # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
  location ~ \.php$ {
    try_files $uri =404;
    fastcgi_pass 127.0.0.1:9000;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
  }
}

Replace {your_domain_name} with your domain.

Save the file and exit nano.

Step 6: Start Services

Finally, start the necessary services using the following command:

sudo systemctl enable nginx php-fpm mariadb
sudo systemctl start nginx php-fpm mariadb

This will start Nginx, PHP-FPM, and MariaDB services.

Conclusion

Congratulations! You have successfully installed eLabFTW on your Void Linux system. You can access eLabFTW by navigating to http://{your_domain_name} in your web browser.