Installer erugo avec Docker

zarev 24 févr. 2025 6 min de lecture

Table des matières

Aujourd'hui, nous allons parler de erugo ! Une application qui n'a que quelques heures au moment d'écrire ces lignes. Elle repose sur le principe de WeTransfer ! Sauf qu'ici, c'est votre propre instance.

On peut déjà apprécier sa grande personnalisation, bien que certains petits bugs subsistent. Laissons le temps au dev de continuer son travail. Pour le fonctionnement, tout est opérationnel. Par contre, le logo de personnalisation ne fonctionne pas encore, tandis que l'arrière-plan, oui.

Le serveur mail n'est pas encore fonctionnel. On peut deviner qu'à l'instar de WeTransfer, il sera possible que la personne soit directement prévenue par mail pour télécharger les fichiers. Malgré son jeune âge, elle est déjà bien fonctionnelle !

C'est une application que je vais tenir à l’œil, car je compte bien la mettre sur belginux.

⚡ Caractéristiques

Déploiement facile : Déploiement facile sur Docker avec le fichier docker-compose fourni.
Liens de partage conviviaux : URL faciles à lire comme https://mondomaine.com/shares/silence-nuage-criard-tonnerre.
Contrôle d'accès sécurisé : Seuls les utilisateurs autorisés peuvent créer des partages, tandis que toute personne disposant d'un lien de partage peut télécharger.
Gestion simple des données : Base de données SQLite pour un stockage efficace des métadonnées.
Configuration flexible : Configuration de la taille maximale des partages, de la marque, de l'expiration, etc.
Configuration interactive : Configuration conviviale lors du premier chargement de l'interface web.
Interface moderne : Interface web propre et intuitive.
Source ouverte : Sous licence MIT.

💾 L'installation

Prérequis

Avant de commencer, assurez-vous d’avoir :

Distribution Linux (Ubuntu, Debian, etc ...).
Docker installé.
Accès terminal.
Connexion internet.

Étapes d'Installation

Créez votre compose.yml dans le dossier ou vous comptez installer erugo :

sudo nano compose.yml

Et collez ça dedans :

services:
  app:
    image: wardy784/erugo:latest
    restart: unless-stopped
    volumes:
      - ./storage:/var/www/html/storage
    ports:
      - "9998:80"
    networks:
      - erugo

networks:
  erugo:
    driver: bridge

On va déployer l'application :

docker compose up -d

Rendez-vous sur l'ip:port, suivant l'IP de votre serveur local et du port choisi, 9998 par défaut :

http://ip:9998/

ou votre domaine :

https://erugo.mondomaine.com

👤 Création du compte administrateur

Lorsque vous arrivez sur votre instance erugo pour la première fois, il faudra créer votre compte administrateur :

Email => Indiquez une adresse e-mail, elle fera office de nom d'utilisateur.
Full Name => Indiquez un nom.
Password => Indiquez un mot de passe, fort, de préférence.
Confirm Password => Confirmez le mot de passe.

Cliquez sur Create Admin Account pour terminer la création de votre compte administrateur, vous arriverez sur votre tableau de bord :

⤴️ Envoyer des fichiers

Cliquez sur une des options suivantes :

Add Files => Permet d'envoyer un fichier. Vous pouvez également envoyer un lot de fichiers.
Add Folders => Permet d'envoyer un dossier. En réalité ça ne va pas envoyer le dossier directement, mais tout son contenu.

Ce qui donne :

Cliquez sur Upload pour terminer. erugo va vous renvoyer à une page avec le lien à copier :

La personne qui va se rendre sur le lien de partage verra ceci :

🔗 Consulter les partages

Cliquez sur l'engrenage :

Cliquez à présent sur My Shares :

Expire Now => Permet de mettre fin à la validité d'un lien de téléchargement.
Extend => Permet de prolonger le temps de téléchargement quand il est expiré.
⬇️ => Permet de télécharger le fichier.
+ Create Share => Vous renvoie vers la page principale de erugo.

🔧 Configurer les partages

Cliquez sur l'engrenage :

Dans l'onglet Shares, configurez les options selon vos souhaits :

Max expiry time => Délai d'expiration maximal.
Max share size => Taille maximale du partage.
Clean files after => Nettoyer les fichiers du système après x jours.

Cliquez sur Save System Settings pour terminer.

👥 Ajouter un utilisateur

Cliquez sur l'engrenage :

Dans l'onglet Users, cliquez sur Add User :

Remplissez les informations nécessaires à la création du compte :

Email => Indiquez l'e-mail de la personne.
Full Name => Indiquez son nom.
Password => Choisissez un mot de passe, fort, de préférence.
Password Confirmation => Confirmez le mot de passe.
Admin => Cochez cette option si la personne peut administrer l'instance.
Must change password => Force la personne à changer son mot de passe.

Cliquez sur Add User pour terminer.

🎨 Personnaliser votre instance

Cliquez sur l'engrenage :

Dans l'onglet Branding & Ui, vous pourrez trouver les options suivantes :

Background Images => Images d'arrière-plan. Images au pluriel car vous pouvez choisir une image unique ou plusieurs, qui vont changer régulièrement au chargement de la page.

Logo => Changez le logo.

Application Name => Changez le nom de votre instance par le vôtre.

Other UI Settings => Affichez ou masquez le texte Powered by erugo en bas de la page. Ce texte permet à erugo d'être découvert par d'autres utilisateurs et nous aide à nous développer, cependant, vous pouvez le masquer si vous le souhaitez.