eLabFTW is an open-source web-based electronic laboratory notebook (ELN) that allows you to manage and organize laboratory experiments, data, and research. Here's a step-by-step tutorial on how to install eLabFTW on Linux Mint.
Before installing eLabFTW, ensure that you have the following:
If you don't have a web server installed on your computer, you can install Apache or Nginx by running the following command:
sudo apt install apache2 -y
or
sudo apt install nginx -y
Install the PHP modules required by eLabFTW by running the following command:
sudo apt install php php-curl php-intl php-mbstring php-xml php-zip -y
Install MySQL or MariaDB by running the following command:
sudo apt install mysql-server -y
or
sudo apt install mariadb-server -y
Next, secure the database server by running the following command:
sudo mysql_secure_installation
Install Composer, a dependency manager required by eLabFTW, by running the following command:
sudo apt install composer -y
Install Git source control management by running the following command:
sudo apt install git -y
Clone the eLabFTW repository into the web server root directory by running the following command:
sudo git clone https://github.com/elabftw/elabftw.git /var/www/html/elabftw
Install eLabFTW dependencies by running the following command:
cd /var/www/html/elabftw
sudo composer install
Create a new Apache configuration file for eLabFTW by running the following command:
sudo nano /etc/apache2/sites-available/elabftw.conf
Add the following lines to the file:
<VirtualHost *:80>
ServerAdmin admin@example.com
DocumentRoot /var/www/html/elabftw/web
ServerName your-domain.com
ServerAlias www.your-domain.com
<Directory /var/www/html/elabftw/web>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
Require all granted
</Directory>
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
Save and close the file.
Enable the configuration by running the following command:
sudo a2ensite elabftw.conf
Restart Apache by running the following command:
sudo systemctl restart apache2
Copy the sample configuration file to the eLabFTW configuration file by running the following command:
cd /var/www/html/elabftw/app/config
sudo cp config.yml.sample config.yml
Open the eLabFTW configuration file:
sudo nano config.yml
In the file, change the following values:
database_user: root
database_password: your-mysql-password
database_name: elabftw
site_url: http://your-domain.com
Save and close the file.
Create eLabFTW tables in the database by running the following commands:
cd /var/www/html/elabftw/upgrade
sudo php upgrade.php
Open a web browser and navigate to:
http://your-domain.com
You should now see the eLabFTW login page. Use the default login credentials:
You will be prompted to change your password when you log in for the first time.
Congratulations on successfully installing eLabFTW on Linux Mint Latest!
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!
