eLabFTW is an open-source Electronic Laboratory Notebook software that allows you to manage your laboratory experiments securely. In this tutorial, we will guide you on how to install eLabFTW on EndeavourOS Latest.
Before we start, make sure that you have the following prerequisites:
The first step is to update your EndeavourOS system to the latest version. Open your terminal and run the following command:
sudo pacman -Syu
Next, you need to install the required packages for eLabFTW. Run the following command:
sudo pacman -S git apache mariadb php php-apache php-gd php-intl php-mbstring php-pdo_mysql
During the installation, you will be prompted to confirm the installation. Type Y and press Enter to continue.
Open the Apache configuration file using your text editor:
sudo nano /etc/httpd/conf/httpd.conf
Find the following line:
#LoadModule rewrite_module modules/mod_rewrite.so
Remove the # at the beginning of the line to enable it.
Save and close the file by pressing Ctrl + X, followed by Y, and then Enter.
Start the Apache and MariaDB services and enable them to start at boot time using the following command:
sudo systemctl start httpd mariadb
sudo systemctl enable httpd mariadb
Run the following command to secure your MariaDB installation:
sudo mysql_secure_installation
You will be prompted to enter the root password of MariaDB. Since we have just installed it, there is no root password set, so just press Enter to proceed.
Follow the prompts to set a root password, remove anonymous users, disallow root login remotely, remove test databases, and reload the privilege tables.
Log in to the MariaDB shell using the following command:
sudo mysql -u root -p
Enter the root password you have set earlier to log in.
Create a new database for eLabFTW:
CREATE DATABASE dbname;
Replace dbname with your desired database name.
Create a new user and grant all privileges for the newly created database:
GRANT ALL ON dbname.* TO 'username'@'localhost' IDENTIFIED BY 'password';
Replace username with your desired username and password with your desired password.
Flush the privileges and exit the MariaDB shell:
FLUSH PRIVILEGES;
EXIT;
Change to the Apache document root directory:
cd /srv/http/
Download the latest eLabFTW version using the following command:
sudo git clone https://github.com/elabftw/elabftw.git
Change to the newly created eLabFTW directory:
cd elabftw/
Copy the config.php.dist file to config.php:
sudo cp config.php.dist config.php
Edit the config.php file to include your database details. Replace the following lines with your own database credentials:
$config['db']['host'] = '127.0.0.1';
$config['db']['user'] = 'username';
$config['db']['pass'] = 'password';
$config['db']['dbname'] = 'dbname';
If your EndeavourOS system has SELinux installed and enabled, you need to configure it to allow Apache to access the eLabFTW files.
Install the SELinux utilities using the following command:
sudo pacman -S selinux-utils
Change the context of the eLabFTW directory:
sudo chcon -R -t httpd_sys_content_t /srv/http/elabftw/
If your EndeavourOS system has a firewall installed and enabled, you need to open the ports used by Apache and MariaDB.
Allow HTTP and HTTPS traffic:
sudo ufw allow http
sudo ufw allow https
Allow MariaDB traffic:
sudo ufw allow mysql
Open your web browser and navigate to http://localhost/elabftw. You will be prompted to create the admin user and password.
Once you have created the admin account, you can log in and start using eLabFTW.
Congratulations! You have successfully installed eLabFTW on EndeavourOS Latest. You can now manage your laboratory experiments securely using eLabFTW.
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!
Alternatively, for the best virtual desktop, try Shells!
