Add miniflux doc
This commit is contained in:
parent
5c1980ca7c
commit
26bca11c46
|
@ -0,0 +1,111 @@
|
||||||
|
---
|
||||||
|
title: Mettre en place un serveur Miniflux
|
||||||
|
---
|
||||||
|
|
||||||
|
# Mettre en place un serveur Miniflux
|
||||||
|
|
||||||
|
Miniflux est un agrégateur de flux libre écrit en Go assez simple à mettre en place.
|
||||||
|
|
||||||
|
{{<hint warning>}}
|
||||||
|
Pensez à installer avant un serveur de base de données PostgreSQL !
|
||||||
|
{{</hint>}}
|
||||||
|
|
||||||
|
{{<hint info>}}
|
||||||
|
Cette documentation est fortement inspirée de la [documentation officielle](https://miniflux.app/docs).
|
||||||
|
{{</hint>}}
|
||||||
|
|
||||||
|
## Préparer la base de données
|
||||||
|
|
||||||
|
on commence par créer un utilisateur pour le service :
|
||||||
|
|
||||||
|
```
|
||||||
|
CREATE ROLE miniflux WITH LOGIN PASSWORD '<mot de passe fort>';
|
||||||
|
```
|
||||||
|
|
||||||
|
puis on crée la BDD :
|
||||||
|
|
||||||
|
```
|
||||||
|
CREATE DATABASE miniflux WITH OWNER miniflux;
|
||||||
|
```
|
||||||
|
|
||||||
|
Il faut ensuite installer l'extension htsore :
|
||||||
|
|
||||||
|
```
|
||||||
|
CREATE EXTENSION hstore;
|
||||||
|
```
|
||||||
|
|
||||||
|
## Installer le serveur
|
||||||
|
|
||||||
|
On commence par se placer dans le dossier `/DATA/miniflux` on y crée le dossier `versions` puis on télécharge l'exécutable (en remplaçant la version et l'architecture) :
|
||||||
|
|
||||||
|
```
|
||||||
|
wget -O versions/miniflux-<version> https://github.com/miniflux/miniflux/releases/download/<version>/miniflux-linux-<arch>
|
||||||
|
```
|
||||||
|
|
||||||
|
on pense à autoriser l'exécution avec
|
||||||
|
|
||||||
|
```
|
||||||
|
chmod +x versions/miniflux-<version>
|
||||||
|
```
|
||||||
|
|
||||||
|
On fait enfin un lien symbolique
|
||||||
|
|
||||||
|
```
|
||||||
|
ln -s /DATA/miniflux/versions/miniflux-<version> /DATA/miniflux/miniflux
|
||||||
|
```
|
||||||
|
|
||||||
|
On va ensuite créer le fichier de configuration su serveur (voir la doc officielle pour plus de détails sur la configuration) `/DATA/miniflux/config` :
|
||||||
|
|
||||||
|
```
|
||||||
|
DATABASE_URL=user=miniflux password=<mon mot de passe> dbname=miniflux sslmode=disable
|
||||||
|
LISTEN_ADDR=127.0.0.1:5832
|
||||||
|
BASE_URL=<url d'écoute>
|
||||||
|
```
|
||||||
|
|
||||||
|
On peut enfin lancer notre exécutable pour lancer la migration de la base de données avec :
|
||||||
|
|
||||||
|
```
|
||||||
|
./miniflux --migration -c /DATA/miniflux/config
|
||||||
|
```
|
||||||
|
|
||||||
|
On crée l'administrateur avec :
|
||||||
|
|
||||||
|
```
|
||||||
|
./miniflux -create-admin
|
||||||
|
```
|
||||||
|
|
||||||
|
On peut enfin créer un service systemd dans `/DATA/miniflux/miniflux.service` :
|
||||||
|
|
||||||
|
```
|
||||||
|
[Unit]
|
||||||
|
Description=Miniflux
|
||||||
|
|
||||||
|
After=syslog.target
|
||||||
|
After=network.target
|
||||||
|
|
||||||
|
Requires=postgresql.service
|
||||||
|
|
||||||
|
[Service]
|
||||||
|
RestartSec=2s
|
||||||
|
Type=simple
|
||||||
|
|
||||||
|
ExecStart=/DATA/miniflux/miniflux -c /DATA/miniflux/config
|
||||||
|
Restart=always
|
||||||
|
|
||||||
|
[Install]
|
||||||
|
WantedBy=multi-user.target
|
||||||
|
```
|
||||||
|
|
||||||
|
puis l'activer avec :
|
||||||
|
|
||||||
|
```
|
||||||
|
sudo systemctl enable --now /DATA/miniflux/miniflux.service
|
||||||
|
```
|
||||||
|
|
||||||
|
## Mise à jour de miniflux
|
||||||
|
|
||||||
|
* On télécharge la dernière version de miniflux
|
||||||
|
* On met à jour le lien symbolique
|
||||||
|
* On arrête le serveur
|
||||||
|
* On lance la migration
|
||||||
|
* On remet en route le serveur
|
Loading…
Reference in New Issue