From d44c3b80f6cab8926c4183c4f3a685467951f444 Mon Sep 17 00:00:00 2001 From: Luke Smith Date: Fri, 1 Jul 2022 08:20:12 -0400 Subject: yarr tweaks, release --- content/yarr.md | 49 +++++++++++++++++++++++-------------------------- 1 file changed, 23 insertions(+), 26 deletions(-) (limited to 'content/yarr.md') diff --git a/content/yarr.md b/content/yarr.md index d649f61..6882fa1 100644 --- a/content/yarr.md +++ b/content/yarr.md @@ -1,53 +1,50 @@ --- title: "Yarr" -date: 2022-06-28 -pix: 'yarr.svg' +date: 2022-07-01 icon: 'yarr.svg' tags: ['service'] short_desc: 'A self-hosted, web-based feed aggregator' --- -Yarr (yet another rss reader) is a web-based feed aggregator which can be used both as a desktop application and a personal self-hosted server. - +[Yarr](https://github.com/nkanaev/yarr) (yet another rss reader) is a web-based feed aggregator which can be used both as a desktop application and a personal self-hosted server. + It is written in Go with the frontend in Vue.js. The storage is backed by SQLite. - -More information can be found on the [github](https://github.com/nkanaev/yarr) - + ## Installing Yarr Firstly, we have to download yarr binary from github on our system - + ```sh wget https://github.com/nkanaev/yarr/releases/download/v2.3/yarr-v2.3-linux64.zip ``` - + Unzip the archive ```sh unzip -x yarr-v2.3-linux64.zip ``` - + Move the binary to your bin folder -```sh -sudo mv yarr /usr/local/bin/yarr +```sh +mv yarr /usr/local/bin/yarr ``` - + ## Configuration - -Now we need to create a auth.conf file that include user and password to create a local yarr account. -I personnaly store this file in a directory called yarr in ~/.config folder, but you can place the file wherever you want. + +Now we need to create a `auth.conf` file that include user and password to create a local yarr account. +I personnaly store this file in a directory called yarr in `~/.config` folder, but you can place the file wherever you want. ```sh mkdir ~/.config/yarr echo 'landchad:password' > ~/.config/yarr/auth.conf ``` - + ## Creating a service - + Create a new file /etc/systemd/system/yarr.service and add the following: -```systemd +```systemd [Unit] Description=Yarr @@ -62,7 +59,7 @@ WantedBy=multi-user.target After creating the config, load, start and enable the service with the following commands. -```sh +```sh systemctl daemon-reload systemctl enable --now yarr ``` @@ -74,7 +71,7 @@ Create an Nginx configuration file for Yarr, say /etc/nginx/sites-available/yarr server { listen 80 ; listen [::]:80 ; - + server_name rss.example.org ; location / { @@ -85,20 +82,20 @@ server { Now let's enable the Nginx Yarr site and reload Nginx to make it active. -```sh +```sh ln -s /etc/nginx/sites-available/yarr /etc/nginx/sites-enabled systemctl reload nginx ``` ### Encryption - + You can encrypt your yarr subdomain as well. Let's do that with certbot: -```sh +```sh certbot --nginx -d rss.example.org ``` -Now you can go to rss.example.org, login and start to add your feeds ! - +Now you can go to rss.example.org, login and start to add your feeds! + ## Contribution Author: Jppaled -- [jppaled.xyz](https://jppaled.xyz) \-- XMR: `86bVp8bcx1F3y3NsfuTRs6D7FfnDyLomV7dLJmus2YMiY9Aat6W5m8JGwuvH39HKrq3immS7noKq8HeW4gb4BFbyLoz5WSZ`{.crypto} -- cgit v1.2.3