Leed is a free and open-source RSS reader written in PHP that lets you keep up with your favorite websites and blogs. This tutorial will guide you through the process of installing Leed on Arch Linux.
Before you begin, make sure that you have the following:
Open a terminal and run the following commands to install the required packages:
sudo pacman -S git apache php php-apache mariadb
During the installation, you will be prompted to specify a root password for MariaDB.
Change into the web server root directory, for example, if using Apache:
cd /srv/http
Then, clone the Leed repository:
sudo git clone https://github.com/LeedRSS/Leed.git
This will create a new directory named "Leed" containing all Leed files in the current location.
If you are using Apache as your web server, you need to create a virtual host for Leed. Open the Apache configuration file:
sudo nano /etc/httpd/conf/httpd.conf
Add the following lines at the end of the file:
<VirtualHost *:80>
ServerName example.com
DocumentRoot "/srv/http/Leed"
<Directory "/srv/http/Leed">
Options FollowSymLinks
AllowOverride none
Require all granted
</Directory>
</VirtualHost>
Replace example.com with the domain name or IP address of your server. Save and close the file.
Restart Apache for the changes to take effect:
sudo systemctl restart httpd
If you are using Nginx as your web server, you need to create a server block for Leed. Open the Nginx configuration file:
sudo nano /etc/nginx/nginx.conf
Add the following lines inside the http { } block:
server {
listen 80;
server_name example.com;
root /srv/http/Leed;
index index.php index.html index.htm;
location / {
try_files $uri $uri/ /index.php?$args;
}
location ~ \.php$ {
fastcgi_pass unix:/run/php-fpm/php-fpm.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;
include fastcgi_params;
}
}
Replace example.com with the domain name or IP address of your server. Save and close the file.
Restart Nginx for the changes to take effect:
sudo systemctl restart nginx
Open the Leed configuration file:
sudo nano /srv/http/Leed/config/config.default.php
Change the following settings according to your preferences:
define("BASE_URL", "http://example.com/Leed"); // Replace example.com with your domain name or IP address
define("DB_TYPE", "mysql");
define("DB_HOST", "localhost");
define("DB_PORT", "3306");
define("DB_NAME", "leed");
define("DB_USER", "leed");
define("DB_PASS", "password"); // Replace password with your MariaDB root password
define("LANGUAGE", "en");
define("ARTICLE_PER_PAGE", "30");
define("THEME", "default");
define("CACHE_TIME", "86400");
define("TOKEN_PASS", "");
define("EMAIL_SEND", false);
define("EMAIL_SMTP_SERVER", "smtp.server.com");
define("EMAIL_SMTP_PORT", "587");
define("EMAIL_SMTP_LOGIN", "user@server.com");
define("EMAIL_SMTP_PASS", "password");
define("SESSION_NAME", "Leed");
define("SESSION_CHECK_IP", false);
define("ADMIN_LOGIN", "admin");
define("ADMIN_PASSWORD", "password"); // Replace password with your desired admin password
Save and close the file.
Log in to MariaDB as root:
sudo mysql -u root -p
Enter the MariaDB root password you specified during installation.
Create a new database:
CREATE DATABASE leed;
Create a new user:
CREATE USER 'leed'@'localhost' IDENTIFIED BY 'password'; // Replace password with your desired user password
Grant access to the database:
GRANT ALL PRIVILEGES ON leed.* TO 'leed'@'localhost';
FLUSH PRIVILEGES;
exit
Open your web browser and navigate to your Leed installation URL, for example:
http://example.com/Leed
Follow the on-screen instructions to complete the installation.
Congratulations, you have successfully installed Leed on Arch Linux! You can now access your new RSS reader and start adding your favorite websites and blogs to your feed.
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!