diff --git a/content/docs/hosting/miniflux.md b/content/docs/hosting/miniflux.md new file mode 100644 index 0000000..40601c5 --- /dev/null +++ b/content/docs/hosting/miniflux.md @@ -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. + +{{}} +Pensez à installer avant un serveur de base de données PostgreSQL ! +{{}} + +{{}} +Cette documentation est fortement inspirée de la [documentation officielle](https://miniflux.app/docs). +{{}} + +## Préparer la base de données + +on commence par créer un utilisateur pour le service : + +``` +CREATE ROLE miniflux WITH LOGIN PASSWORD ''; +``` + +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- https://github.com/miniflux/miniflux/releases/download//miniflux-linux- +``` + +on pense à autoriser l'exécution avec + +``` +chmod +x versions/miniflux- +``` + +On fait enfin un lien symbolique + +``` +ln -s /DATA/miniflux/versions/miniflux- /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= dbname=miniflux sslmode=disable +LISTEN_ADDR=127.0.0.1:5832 +BASE_URL= +``` + +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