Installation

npm install -g @runeya/runeya
runeya

Runeya demande Node.js 22 ou plus. Lancé depuis un terminal, runeya ouvre la page d'installation dans le navigateur. Elle installe Runeya globalement s'il ne l'est pas encore (cas de npx), puis crée un raccourci dans le menu de votre bureau. Si le dossier global de npm demande les droits administrateur (Node installé par le système sous Linux, installateur officiel sous macOS), Runeya s'installe dans ~/.runeya/npm, sans sudo. Le raccourci et la mise à jour depuis l'application utilisent alors ce dossier.

Runeya se démarre ensuite depuis ce raccourci. Il lance le serveur et l'agent, puis ouvre l'interface dans le navigateur.

Répertoire de données

Chaque projet local a son dossier .runeya/, dans le dossier du projet. Il contient les services, les environnements et les réglages du projet. La liste des projets de la machine est enregistrée séparément, dans ~/.runeya/.

Runeya place dans chaque .runeya/ un .gitignore qui exclut la clé de chiffrement et les données privées. Le reste peut être commité avec le projet.

Pour sauvegarder les environnements d'un projet, sauvegardez son .runeya/. Sur une autre machine, ce dossier ne suffit pas à relire les secrets. Le master password est combiné à un secret enregistré dans le trousseau du système. Si le trousseau n'est pas disponible, ce secret est enregistré dans le dossier de données, et cette protection ne s'applique plus. Voir Master password.

Supprimer .runeya/ remet le projet à zéro dans Runeya sans toucher à son code.

Mise à jour et désinstallation

npm update -g @runeya/runeya
npm uninstall -g @runeya/runeya

Si Runeya s'est installé dans ~/.runeya/npm, ajoutez --prefix ~/.runeya/npm à ces deux commandes, ou mettez à jour depuis l'application.

Désinstaller ne touche pas à .runeya/.