Auto-héberger BloomFeed

BloomFeed est pensé pour être installé sur votre propre serveur, pour vous (ou votre foyer). Tout tourne dans Docker : l'application, le planificateur et la base de données MariaDB.

Prérequis

  • Un serveur Linux avec Docker et le plugin Docker Compose.
  • Le port 7081 libre (modifiable dans docker-compose.yml).
  • Optionnel : un nom de domaine et un reverse proxy si vous voulez du HTTPS.

Installation

  1. Clonez le dépôt sur votre serveur. 
    git clone https://git.eldorianet.work/esteban/BloomFeed-RSS bloomfeed
cd bloomfeed
  2. Lancez le script de déploiement : 
    bash scriptsite.sh
    Il crée automatiquement un fichier .env (à partir de .env.example) et y génère des secrets aléatoires (APP_KEY, mots de passe de base de données) s'ils sont absents — ils ne sont jamais régénérés lors des déploiements suivants.
  3. Le script construit les images et démarre les conteneurs (application, planificateur, MariaDB).
  4. Ouvrez http://votre-serveur:7081 et créez le compte propriétaire — les inscriptions se referment ensuite automatiquement.

Configuration

  • Depuis le menu Paramètres, le compte propriétaire peut créer directement des comptes pour ses proches, ou ouvrir/fermer les inscriptions publiques d'un clic.
  • L'interface est disponible en français, anglais, espagnol et allemand — chaque utilisateur choisit sa langue via le sélecteur en haut de page.
  • Le catalogue de flux intégré se personnalise en éditant resources/data/bloomflux.json puis en redéployant.

Mettre à jour

Relancez simplement le script de déploiement : il récupère les derniers changements et reconstruit la stack sans toucher à vos données.

bash scriptsite.sh

Avant chaque redéploiement, la base de données est automatiquement sauvegardée dans backups/ (les 10 dernières sauvegardes sont conservées). Si la sauvegarde échoue, la mise à jour est annulée pour ne jamais risquer de perdre des données.

Mise à jour automatique

Le script auto-update.sh vérifie périodiquement les nouveaux commits sur le dépôt et ne redéploie que si nécessaire, via une tâche planifiée sur le serveur (jamais depuis le conteneur applicatif).

bash auto-update.sh --install       # active la vérification toutes les 30 min
bash auto-update.sh --status        # affiche l'état et les derniers logs
bash auto-update.sh --uninstall     # désactive la mise à jour automatique

Réinitialiser

Le script reset.sh remet l'instance à zéro (comptes, flux, articles, notifieurs) sans toucher au code, au .env ni aux images Docker — utile pour repartir sur une instance vierge.

bash reset.sh

Désinstaller

Le script uninstall.sh arrête et supprime proprement la stack Docker. Il demande une confirmation explicite avant de supprimer vos données et ne supprime jamais le code source sans confirmation séparée.

bash uninstall.sh

Code source

git.eldorianet.work/esteban/BloomFeed-RSS