Aller au contenu
Tûm Docs

Auto-hébergement

Faites tourner Tûm sur votre propre infrastructure sous licence AGPLv3.

Tûm est un logiciel libre distribué sous la licence publique générale GNU Affero v3. Vous pouvez l'installer gratuitement sur vos propres serveurs. Une installation auto-hébergée dispose de toutes les fonctionnalités, sans limite d'offre.

Obligation de la licence

Si vous modifiez Tûm et que vous le mettez à disposition d'utilisateurs via un réseau, l'AGPLv3 vous oblige à leur proposer le code source de votre version modifiée.

Composants

ComposantImageRôle
Webghcr.io/youmssi/tum_webInterface Next.js et authentification
Appghcr.io/youmssi/tum_appAPI REST, mises à jour en temps réel, e-mails, tâches planifiées
PostgreSQL 17Instance gérée ou auto-hébergéeBase de données partagée
Stockage compatible S3MinIO, Cloudflare R2, AWS S3Pièces jointes et avatars
E-mailRelais SMTP, Resend ou BrevoNotifications et invitations

Démarrage rapide

Le dépôt d'infrastructure contient un fichier Docker Compose pour PostgreSQL, MinIO et un serveur de messagerie local.

git clone https://github.com/youmssi/tum_infra.git
cd tum_infra
cp .env.example .env
docker compose up -d

Lancez ensuite les conteneurs app et web avec les variables ci-dessous.

Configuration requise

Web

VariableDescription
BETTER_AUTH_URLAdresse publique de l'application web, par exemple https://tum.example.com.
NEXT_PUBLIC_BETTER_AUTH_URLMême valeur que BETTER_AUTH_URL.
BETTER_AUTH_SECRETSecret aléatoire long. Générez-le avec openssl rand -base64 32.
DATABASE_URLChaîne de connexion PostgreSQL.
NEXT_PUBLIC_API_BASE_URLAdresse publique de l'app (API).
INTERNAL_API_URLAdresse utilisée par le web pour joindre l'app sur votre réseau privé.
INTERNAL_SERVICE_TOKENSecret partagé entre web et app. Utilisez la même valeur des deux côtés.

App

VariableDescription
DATABASE_URL, DATABASE_USERNAME, DATABASE_PASSWORDConnexion PostgreSQL.
AUTH_JWKS_URIhttps://<web>/api/auth/jwks, pour vérifier les jetons de connexion.
CORS_ALLOWED_ORIGINSAdresse publique de l'application web.
WEB_URLAdresse publique de l'application web : liens des e-mails, retour après paiement et appels internes.
MINIO_ENDPOINT, MINIO_ACCESS_KEY, MINIO_SECRET_KEY, MINIO_BUCKETStockage d'objets.
MAIL_TRANSPORT, MAIL_FROMsmtp, resend ou brevo, ou plusieurs par ordre de préférence (resend,brevo) ; et l'adresse d'expédition.
INTERNAL_SERVICE_TOKENMême valeur que côté web.

Laissez TUM_CLOUD_ENABLED vide ou à false. Cela désactive les limites d'offre et les paiements : chaque espace de travail dispose de toutes les fonctionnalités.

Mises à jour

Récupérez les nouvelles images et redémarrez les conteneurs. Les migrations de la base de données s'exécutent automatiquement au démarrage de l'app. Sauvegardez votre base avant chaque mise à jour.

Obtenir de l'aide

Ouvrez un ticket sur GitHub pour signaler un bug. Pour une aide à l'installation ou un déploiement géré, écrivez à [email protected] avec « Tûm » dans l'objet, ou prenez rendez-vous.

Sur cette page