Faites tourner Tekio Delivery sur votre propre machine
Deux commandes et un token API Jira. Tout tourne à l'intérieur de votre réseau — rien n'est transmis nulle part. Comptez une vingtaine de minutes, surtout passées dans l'assistant de configuration.
Ce qu'il vous faut
- Docker avec Compose — Docker Desktop sur Windows ou macOS, Docker Engine sur Linux
- 2 Go de RAM et environ 5 Go de disque pour le cache
- Un compte Jira Cloud pouvant lire les projets à mesurer
- Aucun droit d'administration Jira — un accès en lecture suffit
Pas de Jira du tout ? Vous pouvez l'alimenter avec des fichiers CSV — voir l'étape 5.
Récupérez l'image et lancez-la
Créez un dossier, déposez-y le fichier compose, et lancez. L'image est publique — pas de connexion, pas de compte.
# 1 — compose file curl -O https://delivery.tekio.app/docker-compose.yml # 2 — a secret, so your Jira token is encrypted at rest echo "TEKIO_SECRET_KEY=$(openssl rand -hex 32)" > .env # 3 — start docker compose up -d
Ouvrez http://localhost:3000. Le premier démarrage télécharge environ 1,2 Go, laissez-lui une minute.
Connectez votre Jira
Dans Jira, créez un token API sur id.atlassian.com → Sécurité → Jetons d'API. Puis, dans Tekio Delivery, allez dans Réglages → Connexion et saisissez trois choses :
| Champ | Exemple |
|---|---|
| Jira URL | https://votresociete.atlassian.net |
| le compte auquel appartient le token | |
| Token API | le token que vous venez de créer |
Le token est chiffré avec votre propre secret et stocké dans le volume du conteneur. Il ne quitte jamais votre machine — sans TEKIO_SECRET_KEY, l'application refuse de le stocker plutôt que de l'écrire en clair.
Ajoutez votre premier projet
L'assistant lit votre Jira et propose une cartographie : types de tickets, champs contenant l'équipe et les points, statuts comptant comme « en cours ». Il classe chaque candidat avec des preuves — taux de remplissage, valeurs réellement présentes — donc vous confirmez au lieu de deviner.
Il refuse de terminer tant que la configuration n'est pas validée sur vos vrais tickets. Choisissez Scrum ou Kanban pour une seule équipe : c'est la version gratuite, sans limite de durée.
Le mode SAFe — plusieurs équipes sur un même programme, avec la consolidation inter-équipes — est ce que débloque la licence. →
Pas de Jira ? Chargez des fichiers CSV
Si votre Jira est verrouillé, ou si vous êtes sur Azure DevOps ou autre chose, vous pouvez alimenter le produit avec trois fichiers CSV au lieu d'une connexion API.
| Fichier | Une ligne par | Colonnes |
|---|---|---|
| issues.csv | ticket | key, type, status, points, team, epic, created, resolved |
| transitions.csv | changement de statut | key, from, to, timestamp |
| sprints.csv | appartenance à un sprint | sprint, key, start, end, added_at, removed_at |
Téléchargez le pack de modèles — un exemple rempli (Northwind Maritime) à côté d'un fichier vide aux mêmes colonnes. Ouvrez d'abord le rempli : c'est plus clair que n'importe quelle documentation de schéma.
C'est transitions.csv qui compte le plus. C'est l'historique des statuts, et c'est de là que viennent le temps de cycle, l'efficacité de flux, le report et l'engagé-vs-livré. Sans lui, vous n'obtenez que des compteurs et l'état courant — une image bien plus pauvre.
Mettre à jour
Atlassian fait évoluer l'API Jira régulièrement : une instance qui cesse d'être mise à jour finira par casser. La mise à jour tient en deux commandes, et votre configuration comme votre cache sont préservés dans le volume.
docker compose pull docker compose up -d
Si quelque chose cloche
| Symptôme | En général |
|---|---|
| Page blanche sur :3000 | Démarrage en cours. Vérifiez docker compose logs -f. |
| « Impossible de stocker le token » | TEKIO_SECRET_KEY n'est pas défini dans .env. |
| Erreur 401 depuis Jira | L'email et le token doivent appartenir au même compte. |
| L'assistant ne trouve aucun champ | Le compte ne voit pas le projet. Vérifiez les permissions. |
| Les graphiques sont vides | La première synchronisation tourne encore — elle lit les changelogs, ce qui prend quelques minutes. |
La version gratuite est sans support — c'est la contrepartie de la gratuité. Les bugs sont les bienvenus en issues GitHub, et si vous préférez ne rien faire de tout ça vous-même, je vous l'installe.