Rackula & Rackarr — Guide d’installation
Installer Rackula et Rackarr
Guide pas à pas — méthode [Link] (Windows)
Concepteurs d’implantation de baies / racks — installés en local sur votre PC.
Rackula et Rackarr sont deux petits logiciels web qui servent à dessiner l’implantation d’une baie
(rack) : on glisse les équipements à leur place, unité par unité, puis on exporte le plan en image ou
PDF. Ce guide explique comment les installer et les lancer sur votre ordinateur Windows.
À savoir : La méthode « Docker » n’a pas fonctionné sur votre connexion (erreur réseau « TLS
handshake timeout » au téléchargement des images). On utilise donc la méthode [Link], qui
passe par le réseau normal de Windows et fonctionne. La méthode Docker reste décrite en
annexe, pour plus tard.
Avant de commencer
Vous avez besoin de trois choses, déjà présentes sur votre PC :
• [Link] (déjà installé, version 24 — vérifiable avec la commande node -v).
• Git (sert à télécharger les logiciels).
• Une connexion internet (uniquement pour l’installation).
Ouvrir PowerShell : appuyez sur la touche Windows, tapez PowerShell, puis ouvrez-le. C’est la
fenêtre bleue dans laquelle on colle les commandes.
Astuce : Pour coller une commande dans PowerShell : copiez-la depuis ce document (Ctrl+C),
cliquez dans la fenêtre bleue, puis faites un clic droit (ou Ctrl+V). Appuyez sur Entrée pour
l’exécuter. Faites les commandes UNE par UNE et attendez la fin de chacune.
Partie 1 — Installer Rackula
1. Aller dans le dossier du projet. — Cela indique à PowerShell où travailler. La ligne de
début doit changer pour afficher ce dossier.
cd C:\Users\asoul\Documents\Claude\Projects\Test_Rackula_Rackarr
2. Télécharger Rackula. — Des lignes vont défiler (Cloning into..., des pourcentages).
Attendez le retour à la ligne PS C:\...
git clone [Link] rackula
3. Installer les composants. — Étape la plus longue (1 à 3 minutes). Des avertissements
jaunes peuvent apparaître : c’est normal. C’est fini quand un message du type « added ...
packages » s’affiche.
cd rackula
npm install
4. Lancer Rackula. — La fenêtre reste « ouverte » exprès (elle ne rend pas la main) : c’est
l’appli qui tourne. Une adresse s’affiche, du type [Link]
npm run dev
5. Ouvrir l’application dans le navigateur. — Sans fermer la fenêtre bleue, ouvrez Chrome
ou Edge et tapez l’adresse affichée :
localhost:5173
L’écran « DRackula » apparaît, avec les boutons New Layout et Import File. C’est bon, Rackula
fonctionne.
Page 1 / 3
Rackula & Rackarr — Guide d’installation
Partie 2 — Installer Rackarr
Même principe que Rackula. Si vous voulez faire tourner les deux en même temps, laissez la
fenêtre de Rackula ouverte et ouvrez une nouvelle fenêtre PowerShell pour Rackarr.
6. Aller dans le dossier du projet (nouvelle fenêtre PowerShell).
cd C:\Users\asoul\Documents\Claude\Projects\Test_Rackula_Rackarr
7. Télécharger Rackarr.
git clone [Link] rackarr
8. Installer les composants.
cd rackarr
npm install
9. Lancer Rackarr.
npm run dev
[Link] l’application dans le navigateur.
Important (les deux en même temps) : Si Rackula tourne déjà sur l’adresse 5173, Rackarr se
mettra automatiquement sur l’adresse suivante : [Link] Regardez toujours
l’adresse exacte affichée dans la fenêtre bleue, et tapez celle-là dans le navigateur.
Partie 3 — Relancer plus tard (sans tout réinstaller)
Une fois installé, pas besoin de refaire les téléchargements. Pour relancer une appli, ouvrez
PowerShell et faites seulement :
Pour Rackula :
cd C:\Users\asoul\Documents\Claude\Projects\Test_Rackula_Rackarr\rackula
npm run dev
Pour Rackarr :
cd C:\Users\asoul\Documents\Claude\Projects\Test_Rackula_Rackarr\rackarr
npm run dev
Puis ouvrez l’adresse affichée dans le navigateur. (Les commandes git clone et npm install
ne se font qu’une seule fois, à la première installation.)
Partie 4 — Arrêter une application
• Cliquez dans la fenêtre bleue de l’appli, puis appuyez sur Ctrl + C (les deux touches
ensemble).
• Ou fermez simplement la fenêtre. L’appli s’arrête, mais vos plans restés dans le navigateur ne
sont pas perdus si vous les avez exportés/sauvegardés.
Partie 5 — En cas de coupure pendant le téléchargement
Si une commande git clone échoue avec un message du type « Failed to connect » ou « Could
not connect to server », ce n’est pas grave : c’est une coupure passagère. Relancez simplement
la même commande — le 2e essai passe généralement (c’est exactement ce qui s’est produit
lors de l’installation).
Page 2 / 3
Rackula & Rackarr — Guide d’installation
Annexe — Méthode Docker (optionnelle, pour plus tard)
Si un jour votre réseau permet à Docker de télécharger (problème « TLS handshake timeout »
résolu), voici la méthode la plus rapide. Docker Desktop doit être installé et démarré (« Engine
running » en bas à gauche).
Rackula (adresse [Link] :
docker run -d --name rackula -p 8080:8080
[Link]/rackulalives/rackula:latest
Rackarr (adresse [Link] :
docker run -d --name rackarr -p 8081:80 [Link]/rackarr/rackarr:latest
Si Docker affiche « TLS handshake timeout »
C’est un problème de taille de paquets réseau (MTU) propre à Docker. Dans Docker Desktop :
icône Settings (roue dentée) → Docker Engine. Ajoutez la ligne "mtu": 1400 dans le texte
JSON, par exemple :
{
"builder": { "gc": { "defaultKeepStorage": "20GB", "enabled": true } },
"experimental": false,
"mtu": 1400
}
Cliquez Apply & restart, attendez « Engine running », puis réessayez le téléchargement. Si ça ne
passe toujours pas, restez sur la méthode [Link] (Parties 1 et 2).
Récapitulatif des adresses
Logiciel Méthode [Link] Méthode Docker
Rackula localhost:5173 localhost:8080
Rackarr localhost:5174 (si localhost:8081
Rackula tourne)
Document préparé d’après une installation réelle testée et validée.
Page 3 / 3