How to Install Wallabag on Manjaro

In this tutorial, we'll guide you through the process of installing Wallabag on Manjaro. Wallabag is an open-source self-hosted read-it-later app that allows you to save web pages and read them offline later. With Wallabag, you can save articles, blog posts, and any other web page content for later reading, either on the web or using one of the official mobile apps.

Prerequisites

Before we begin with the installation process, there are some prerequisites that you need to have in place:

A Manjaro installation (we'll use Manjaro KDE for this tutorial).
A non-root user with sudo privileges.

Step 1: Update the System

The first thing you need to do is update the system packages by running the following command:

sudo pacman -Syu

This will ensure that your system packages are up to date.

Step 2: Install Dependencies

Wallabag requires a few dependencies to be installed first. To install them, run the following command:

sudo pacman -S php php-fpm php-gd php-pgsql php-intl php-apcu nginx mariadb mariadb-clients composer

This will install PHP, NGINX, MariaDB, and Composer.

Step 3: Create a Database

Next, we need to create a database for Wallabag. You can do this by running the following command:

sudo mysql -u root -p

This will open the MySQL prompt. Once you're in, run the following commands:

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

Here, wallabag is the name of the database, wallabaguser is the username, and password is the password you want to use. You can replace these values with your own, but make sure you remember them as we'll need to use them later.

Step 4: Install Wallabag

Now that we have installed the dependencies and created a database, we can proceed with installing Wallabag.

First, clone the Wallabag repository using the following command:

git clone https://github.com/wallabag/wallabag.git /var/www/html/wallabag

Next, change into the Wallabag directory:
```
cd /var/www/html/wallabag
```
Now, run the following command to install the required packages:
```
sudo composer install --no-dev --optimized-autoloader
```
Once the packages are installed, we'll need to configure the application by copying the sample configuration file:
```
cp app/config/parameters.yml.dist app/config/parameters.yml
```
Open the configuration file using a text editor:
```
sudo nano app/config/parameters.yml
```
Change the following lines to match your settings:
```
database_host: 127.0.0.1
database_port: null
database_name: wallabag
database_user: wallabaguser
database_password: password
```
Replace wallabaguser and password with the username and password you chose in Step 3.
Save and close the file.

Step 5: Configure NGINX

Now that we have installed Wallabag and configured it, we need to configure NGINX to serve the web pages.

First, create a new NGINX configuration file for Wallabag:
```
sudo nano /etc/nginx/conf.d/wallabag.conf
```

Copy and paste the following code into the file:

server {
    listen 80;
    server_name wallabag.local;

    root /var/www/html/wallabag/web;
    index index.php;

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

    location ~ \.php$ {
        fastcgi_pass unix:/run/php-fpm/php-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

Here, we're telling NGINX to listen on port 80 and to serve Wallabag from the /var/www/html/wallabag/web directory.

Save and close the file.
Now, restart NGINX and PHP-FPM to apply the changes:
```
sudo systemctl restart nginx php-fpm
```

Step 6: Finish Wallabag Installation

Now that we have installed Wallabag, configured it, and configured NGINX, we can finish the installation process.

Open a web browser and navigate to http://localhost. You should see the Wallabag installation page.
Follow the on-screen instructions to complete the installation process. When prompted for the database details, enter the details you chose in Step 3.

Congratulations! You have successfully installed Wallabag on Manjaro. You can now start using it to save your favorite web pages and read them later.