Comment me connecter la première fois ?

Ouvrez https://votre-domaine juste après l'installation : Kutt affiche le formulaire de création du compte administrateur. Saisissez votre e-mail et votre mot de passe ; le premier compte créé devient l'administrateur, c'est pourquoi il faut le créer sans attendre. Le formulaire est ensuite refusé, et aucun mot de passe n'est généré à l'avance.

N'importe qui peut-il créer des liens sur mon instance ?

Non. Les inscriptions publiques et les liens anonymes sont fermés par défaut : seuls l'administrateur et les comptes qu'il crée depuis la page d'administration peuvent raccourcir des liens. C'est volontaire — un raccourcisseur ouvert est vite utilisé pour masquer des liens d'hameçonnage, et votre domaine en paierait la réputation.

Comment créer un lien court depuis un script ?

Générez une clé d'API dans les paramètres de votre compte, puis envoyez un POST sur https://votre-domaine/api/v2/links avec l'en-tête X-API-KEY et un corps JSON contenant target (l'adresse longue) et, en option, customurl, password, expire_in ou description. La réponse JSON contient le champ link, le lien court prêt à partager.

Puis-je récupérer un mot de passe oublié par e-mail ?

Pas tant que l'envoi d'e-mails n'est pas configuré : Kutt est installé avec les e-mails désactivés. Pour activer la réinitialisation du mot de passe et la vérification des adresses, renseignez un serveur SMTP dans les variables MAIL_ de l'application et passez MAIL_ENABLED à true, puis redémarrez le conteneur.

Automatiser les processus métier.

Kutt

Kutt — vos liens courts sur votre propre domaine : API REST, adresses personnalisées, expiration, mot de passe et statistiques privées.

512 Mo minimum RAM 1 vCPU Port 8107 En validation

En validation

L'installation automatique de cette solution est prête et passe actuellement nos tests sur serveur réel. La commande ouvrira dès que la validation sera terminée.

Code source

Stack technique

DockerNode.jsKuttSQLite

RAM minimum512 Mo minimum

CPU minimum1 vCPU

Port par défaut8107

OS compatiblesDistributions Linux au choix

Kutt (licence MIT, plus de 11 000 étoiles sur GitHub) est un raccourcisseur d'URL moderne que vous hébergez vous-même. Chaque lien court porte votre domaine — go.votre-domaine.ma/promo plutôt qu'une adresse bit.ly — et chaque clic reste dans votre base, pas chez un service tiers.

Un lien se crée depuis l'interface web ou par l'API REST, avec une clé d'API par utilisateur : c'est ce qui en fait un outil de développeur autant que de marketing. Vos scripts, votre CRM ou vos campagnes d'e-mailing raccourcissent leurs liens automatiquement, et le tableau de bord montre les statistiques de chacun : visites, navigateurs, systèmes, pays et sites référents.

Sur ServOrbit, Kutt tourne dans un seul conteneur avec une base SQLite conservée dans un volume, derrière nginx en HTTPS. Les inscriptions publiques et les liens anonymes sont fermés par défaut : seul l'administrateur que vous créez au premier accès, et les comptes qu'il ajoute, peuvent raccourcir des liens.

Fonctionnalités clés

Liens courts sur votre domaine — chaque lien porte votre marque (go.votre-domaine.ma/offre), ce qui inspire davantage confiance qu'un raccourcisseur public et survit au changement d'outil.

Adresses personnalisées — choisissez le code du lien (/rentree, /webinar) ou laissez Kutt en générer un de six caractères, sans caractères ambigus comme 0 et O.

Mot de passe, expiration et description — protégez un lien par mot de passe, fixez une date ou une durée de validité, et documentez chaque lien pour l'équipe.

Statistiques privées — visites dans le temps, navigateurs, systèmes d'exploitation, pays et sites référents, visibles uniquement par le propriétaire du lien.

API REST avec clé par utilisateur — créez, modifiez et supprimez des liens depuis un script, un CRM ou une chaîne CI ; API documentée par le projet.

Administration intégrée — l'administrateur crée les comptes de l'équipe, consulte tous les liens et bannit un lien ou un domaine malveillant.

Léger et sobre — un conteneur Node.js et une base SQLite : environ 200 Mo de RAM, aucune base de données externe à maintenir.

Quand utiliser cette solution ?

1

Liens de campagne à votre marque

Une agence ou une PME publie ses liens sur les réseaux sociaux, dans des SMS et sur des affiches : go.votre-domaine.ma/ramadan inspire plus confiance qu'une adresse bit.ly et se lit à voix haute. Les statistiques par lien montrent quel canal a vraiment apporté les visites, sans outil d'analyse tiers.

2

Raccourcir par l'API depuis vos outils

Votre application génère des liens de suivi, de partage ou de paiement trop longs pour un SMS. Un appel POST sur /api/v2/links avec la clé d'API rend un lien court en quelques millisecondes : intégrez-le à un CRM, à un script de facturation ou à une chaîne CI qui publie des liens de recette.

3

Des liens qui expirent tout seuls

Une offre limitée, un document partagé pour une semaine, un lien d'inscription à un événement : fixez une durée de validité et le lien cesse de rediriger à l'échéance. Ajoutez un mot de passe pour un document réservé à un client.

Déployer Kutt sur votre VPS

Guide optimisé pour les VPS Cloud ServOrbit.

01

Créer le VPS et choisir l'adresse

Commandez un VPS Ubuntu 24.04 avec 512 Mo de RAM. Kutt exige un domaine : c'est lui qui forme chaque lien court, et un lien qui pointe vers une adresse locale ne s'ouvre chez personne. Choisissez de préférence un sous-domaine court de l'un de vos domaines (par exemple go.votre-domaine.ma) ; le sous-domaine gratuit du VPS (kutt.{dns_slug}.servorbit-dns.com), HTTPS compris, fonctionne aussi pour démarrer. Inutile d'acheter un nom de domaine pour tester.

02

Installer Kutt depuis le Marketplace

Dans votre espace client, sélectionnez Kutt, choisissez l'adresse et cliquez sur Installer. Le script déploie le conteneur officiel, génère la clé secrète qui signe les sessions, crée le volume de la base SQLite et configure le reverse proxy nginx en HTTPS.

03

Se connecter la première fois

Ouvrez https://votre-domaine dès la fin de l'installation : Kutt vous redirige vers le formulaire de création du compte administrateur. Saisissez votre e-mail et un mot de passe solide, deux fois ; ce premier compte devient l'administrateur et le formulaire est ensuite refusé à tout le monde. Aucun identifiant n'est créé à l'avance.

04

Créer votre premier lien

Collez une adresse longue dans le champ principal, choisissez éventuellement un code personnalisé, une date d'expiration ou un mot de passe, puis validez. Le lien court apparaît dans votre liste avec son compteur de visites ; cliquez sur ses statistiques pour voir les navigateurs, les pays et les sites référents.

05

Générer une clé d'API

Dans les paramètres de votre compte, générez une clé d'API. Envoyez-la dans l'en-tête X-API-KEY d'un POST sur /api/v2/links avec un corps JSON {"target": "https://…"} : la réponse contient le lien court. Chaque membre de l'équipe a sa propre clé, révocable en la régénérant.

Questions fréquentes

Oui. Kutt forme chaque lien court avec son domaine : sans adresse publique, les liens pointeraient vers une machine locale. Inutile d'en acheter un pour commencer : chaque VPS ServOrbit dispose d'un sous-domaine gratuit (kutt.{dns_slug}.servorbit-dns.com) avec un certificat HTTPS. Pour des liens vraiment courts, préférez un sous-domaine bref de l'un de vos domaines, par exemple go.votre-domaine.ma.

Solutions complémentaires

Automatisation & Workflows

Kutt n'est pas encore commandable.