How to Install Wallabag on Linux Mint

In this tutorial, we will guide you on how to install Wallabag, an open-source self-hosted read-it-later application, on Linux Mint. The installation process is straightforward and can be completed in a few simple steps.

Prerequisites

Before installing Wallabag, you should have:

• A dedicated Linux Mint server with root access
• LAMP stack (Apache, MySQL, PHP) installed on your server
• PHP version 7.2 or higher

Step 1: Download Wallabag

First, you need to download the latest version of Wallabag. You can download Wallabag using the following command:

wget https://www.wallabag.org/releases/wallabag-2.4.3.zip

Step 2: Unzip Wallabag

Now, unzip the downloaded zip file:

unzip wallabag-2.4.3.zip

After unzipping the file, you will get a wallabag directory.

Step 3: Move Wallabag to the Web Directory

Next, move the unzipped wallabag directory to the web directory:

sudo mv wallabag /var/www/html/

Step 4: Configure Apache for Wallabag

Create a new virtual host configuration file in Apache for your Wallabag installation:

sudo nano /etc/apache2/sites-available/wallabag.conf

Add the following lines in the configuration file:

<VirtualHost *:80>
ServerAdmin [email protected]
ServerName example.com
DocumentRoot /var/www/html/wallabag/web

<Directory /var/www/html/wallabag/web>
AllowOverride All
Order Allow,Deny
Allow from All
Require all granted

FallbackResource /index.php
</Directory>

ErrorLog ${APACHE_LOG_DIR}/wallabag_error.log
CustomLog ${APACHE_LOG_DIR}/wallabag_access.log combined
</VirtualHost>

Save and close the file.

Step 5: Enable the Virtual Host

Now that the virtual host configuration is complete, you need to enable it using the following command:

sudo a2ensite wallabag.conf

Step 6: Configure Database for Wallabag

Create a new database for Wallabag and a user for it:

sudo mysql -u root -p

Then, enter the following MySQL commands:

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

Step 7: Install Dependencies

Now, you need to install the dependencies for Wallabag:

cd /var/www/html/wallabag/
sudo apt install composer
sudo composer install --no-dev --optimize-autoloader

Step 8: Install Wallabag

Run the following command to install Wallabag:

sudo php bin/console wallabag:install

Follow the on-screen instructions to complete the installation process.

Step 9: Configure Cron Job

Wallabag uses Cron to update feeds and send emails. You need to configure a Cron job for Wallabag:

sudo crontab -e

Add the following line to the Cron file:

*/5 * * * * [ -x /usr/bin/php ] && /usr/bin/php /var/www/html/wallabag/bin/console wallabag:sync

Save and close the file.

Step 10: Restart Apache

Finally, restart the Apache server to apply the changes:

sudo service apache2 restart

Conclusion

In this tutorial, we have shown you how to install Wallabag on Linux Mint. After installation, you can access the Wallabag application by visiting your server's IP address or domain name.