Installing Wallabag on POP! OS Latest

Wallabag is a self-hosted web application used for saving web pages to read later. In this tutorial, we will guide you step by step on how to install Wallabag on POP! OS Latest.

Prerequisites

Before proceeding with the installation, ensure that you have the following:

• A non-root user with sudo privileges.
• A LAMP stack (Linux Apache MySQL PHP) installed on your system.
• A domain name or subdomain set up and pointed to your server’s IP address.

Step 1: Installing Required Packages

To install Wallabag on POP! OS Latest, run the following command:

sudo apt-get update

sudo apt-get install php-curl php-gd php-dom php-mysql

Step 2: Downloading the Latest Version of Wallabag

Download the latest version of Wallabag by executing the following command:

wget https://wllbg.org/latest-v2-package -O wallabag.tar.gz

After the download is complete, extract the downloaded file:

tar -xvzf wallabag.tar.gz

Move the extracted files to the Apache document root directory:

sudo mv wallabag /var/www/html/

Step 3: Configuring Wallabag

Create a new MySQL database for Wallabag:

sudo mysql -u root -p

CREATE DATABASE wallabagdb;

Create a new user and grant privileges to the database:

GRANT ALL PRIVILEGES ON wallabagdb.* TO 'wallabaguser'@'localhost' IDENTIFIED BY 'password';

FLUSH PRIVILEGES;

exit

Modify the database configuration file:

sudo nano /var/www/html/wallabag/app/config/parameters.yml

Replace the following lines:

database_host: 127.0.0.1
database_name: symfony
database_user: root
database_password: root

With:

database_host: localhost
database_port: null
database_name: wallabagdb
database_user: wallabaguser
database_password: password

Save and exit the file by pressing Ctrl + X, then Y, and then Enter.

Set the proper permissions for the Wallabag directory:

sudo chown -R www-data:www-data /var/www/html/wallabag/

Step 4: Setting Up Apache

Create a new Apache virtual host configuration file for Wallabag:

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

Add the following lines to the new file:

<VirtualHost *:80>
        ServerName your-domain.com
        ServerAlias www.your-domain.com
        DocumentRoot /var/www/html/wallabag/web

        <Directory /var/www/html/wallabag/web>
                AllowOverride All
                Require all granted
        </Directory>

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

Save and exit the file by pressing Ctrl + X, then Y, and then Enter.

Disable the default Apache virtual host:

sudo a2dissite 000-default.conf

Enable the newly created virtual host:

sudo a2ensite wallabag.conf

Restart Apache:

sudo systemctl restart apache2

Step 5: Completing the Installation

Access your Wallabag installation by entering your domain name or subdomain in a web browser. You will be prompted to create a new administrator account and to configure your language and default settings.

After the installation is complete, delete the install directory from the Wallabag directory:

sudo rm -rf /var/www/html/wallabag/install/

Congratulations! You have successfully installed Wallabag on POP! OS Latest.

Conclusion

Wallabag is a powerful self-hosted solution that allows you to save web pages to read later. By following the steps outlined in this tutorial, you can install and set up Wallabag on your POP! OS Latest system.