Installer sous Linux
Il y a deux façons d'exécuter l'agent sous Linux : comme service système qui démarre avec la machine, ou comme simple processus que vous lancez vous-même. La même archive couvre les deux.
Choisissez votre archive
| Archive | Pour |
|---|---|
filemote-<version>-linux-x64.tar.gz | PC et serveurs ordinaires |
filemote-<version>-linux-arm64.tar.gz | Raspberry Pi 4/5, AWS Graviton, Oracle Ampere |
Les deux se décompressent en un seul dossier contenant FilemoteAgent, FilemoteCli,
install.sh, apply-update.sh, un app_settings.json vide et le répertoire AiService.
Les archives sont empaquetées sous Windows, qui ne porte pas le bit exécutable Unix :
chmod +x est donc toujours la première étape. Les binaires eux-mêmes sont autonomes,
l'agent n'a donc besoin d'aucune installation de .NET — le script d'installation provisionne
.NET quand même, parce qu'il met en place un environnement complet, IA comprise.
Installer comme service (nécessite root)
tar xzf filemote-<version>-linux-x64.tar.gz
cd filemote-<version>-linux-x64
chmod +x install.sh
sudo ./install.sh
Le script :
- détecte votre gestionnaire de paquets (apt, dnf, yum, zypper ou pacman) et avertit au lieu d'abandonner s'il n'en reconnaît aucun ;
- installe l'environnement d'exécution .NET 8, en ajoutant le dépôt de paquets de Microsoft
sur Debian et Ubuntu, et en se rabattant sur le
dotnet-install.shde Microsoft si la voie des paquets échoue ; - installe un Python récent s'il n'y a rien de plus récent que 3.10 — explicitement 3.12 sur apt, dnf et zypper, et ce que la distribution considère comme courant sur yum et pacman — et si cela échoue aussi, il désactive le service d'IA et continue plutôt que de renoncer à toute l'installation ;
- copie l'agent dans
/opt/filemote, avec le service d'IA et l'utilitaire de mise à jour ; - crée l'unité systemd
filemote-agent.
L'unité s'exécute sous votre utilisateur, pas root, redémarre après un échec au bout de cinq secondes, est plafonnée à 8 Go de mémoire et 80 % de CPU, et journalise dans journald.
L'unité est activée mais pas démarrée. Activée signifie qu'elle remonte après un
redémarrage ; une installation neuve reste à inactive (dead) jusqu'à ce que vous la
démarriez, ce que vous faites après l'avoir configurée à l'étape suivante.
Configurez la copie que le service lit réellement
C'est là que la plupart des premières installations échouent. FilemoteCli n'est pas
copié dans /opt/filemote, et par défaut il écrit app_settings.json à côté de son propre
binaire. Lancez-le directement depuis l'archive extraite et vous configurerez un fichier que
le service ne lit jamais — sans la moindre erreur nulle part, car du point de vue du service
il n'a tout simplement pas encore d'identifiants.
Pointez-le vers le fichier du service :
sudo ./FilemoteCli --config /opt/filemote/app_settings.json
Choisissez [2] Pair with a code, collez le code depuis le site web, puis [7] Save and exit — le déroulé complet est dans relier un appareil à votre compte. Démarrez ensuite le service :
sudo systemctl start filemote-agent
sudo systemctl status filemote-agent
Installer sans root
Sur un hébergement partagé ou dans un conteneur, ignorez complètement le script :
tar xzf filemote-<version>-linux-x64.tar.gz
cd filemote-<version>-linux-x64
chmod +x FilemoteCli FilemoteAgent
./FilemoteCli # configurer et appairer
./FilemoteAgent # l'exécuter
Rien ne démarre après un redémarrage et les dépendances d'IA ne sont pas provisionnées, mais
l'accès aux fichiers fonctionne exactement pareil. Exécutez l'agent sous tmux, screen ou
une unité systemd utilisateur si vous voulez qu'il survive à votre session.
Options du script
| Option | Effet |
|---|---|
--no-ai | Ignorer entièrement le service d'IA — ni Python, ni dépendances |
--no-autostart | Installer les fichiers sans créer d'unité systemd |
--prefix /path | Installer ailleurs que dans /opt/filemote |
--model <id> | Présélectionner le modèle d'IA principal |
--device cpu|gpu|auto | Périphérique de calcul pour l'IA |
--gpu | Compiler le moteur d'IA avec la prise en charge du GPU |
--hf-token <token> | Jeton Hugging Face, pour les modèles à accès restreint |
Les options de modèle, de périphérique et de jeton sont fusionnées dans app_settings.json
sans toucher aux paramètres déjà présents : relancer le script ne défait donc pas votre
configuration. Une option non reconnue fait l'objet d'un avertissement et est ignorée.
L'IA sous Linux
Sans --gpu, le moteur d'IA s'installe sous forme de paquet CPU précompilé. Avec --gpu il
est compilé depuis les sources — avec CUDA si nvidia-smi est présent, sinon avec Vulkan —
ce qui implique d'installer d'abord un compilateur et CMake, et cette étape prend plusieurs
minutes.
Sur un Raspberry Pi disposant de moins de 8 Go de RAM, installez avec --no-ai.
Journaux et commandes du service
sudo systemctl start filemote-agent # démarrer maintenant
sudo systemctl status filemote-agent # est-il en cours d'exécution ?
sudo journalctl -u filemote-agent -f # suivre le journal
Si l'appareil n'apparaît jamais en ligne, déroulez l'appareil apparaît hors ligne.
Mise à niveau depuis une installation d'avant le changement de nom
Si la machine porte encore l'ancien service rfm-agent, le script l'arrête, le désactive et
supprime son unité — deux agents en concurrence pour le même compte n'aident personne — et
déplace vos paramètres et vos modèles d'IA téléchargés de /opt/rfm vers le nouveau préfixe.
L'ancien répertoire est laissé en place pour que vous le supprimiez une fois rassuré.
Mis à jour le 2026-07-31