Configurer l'agent à la main
Tout ce que l'agent sait tient dans un fichier, app_settings.json. Le configurateur
l'écrit pour vous, et pour des installations scriptées ou sans écran vous pouvez l'écrire
vous-même. Cette page est la référence des champs.
Si vous voulez seulement connecter un appareil, cette page ne vous est pas nécessaire : relier un appareil à votre compte est plus court et plus sûr.
Où se trouve le fichier
L'agent lit app_settings.json dans le dossier où réside son propre exécutable. C'est-à-dire :
- Windows — à côté de
FilemoteAgent.exe, dans le dossier d'installation ou le dossier portable. - Une installation en service sous Linux —
/opt/filemote/app_settings.json, puisque c'est là que le script d'installation place l'agent. - Partout ailleurs — à côté du binaire que vous avez lancé.
Le configurateur en terminal utilise par défaut le fichier situé à côté de lui, et accepte
--config <path> pour en modifier un autre — ce qui est exactement ce dont une installation
en service a besoin, puisque FilemoteCli n'est pas copié dans le préfixe. Un chemin relatif
y est résolu par rapport à votre répertoire courant.
Connexion
| Champ | Signification |
|---|---|
ip | Nom d'hôte ou adresse du serveur que l'agent appelle |
port | Port du serveur |
EnforceHttps | Refuser de se connecter en HTTP simple. Activé par défaut ; l'appairage via le client en terminal le désactive, car le relais est atteint en HTTP |
Laissez ip et port pointer vers votre propre serveur. Un ip vide ne veut pas dire
« débrouille-toi » — l'agent se rabat sur une valeur par défaut compilée qui n'est presque
certainement pas votre déploiement.
Identité
| Champ | Signification |
|---|---|
login | Adresse e-mail du compte |
pass | Mot de passe du compte chiffré — voir plus bas |
PairCode | Un code d'appairage en attente d'échange |
DeviceToken | Le jeton durable stocké après l'échange d'un code |
pass n'est pas un mot de passe en clair. Le configurateur le stocke via la protection
locale de la plateforme — DPAPI sous Windows, un fichier de clé local ailleurs — et l'agent
attend cette forme. Coller un mot de passe en clair dans ce champ ne fonctionnera pas ;
définissez le mot de passe via le configurateur, ou mieux, appairez l'appareil et laissez
pass vide.
Ce que l'agent peut atteindre
rootPaths est la liste des répertoires que le navigateur est autorisé à voir. Tout ce qui
se trouve en dehors est refusé, y compris les tentatives d'en sortir avec ... L'agent
refuse de démarrer quand la liste est vide : ce champ n'est donc pas facultatif.
rootPath (au singulier) est un champ hérité conservé uniquement pour que les anciens
fichiers de paramètres se chargent encore. Utilisez rootPaths.
Réglages de transfert
| Champ | Défaut | Signification |
|---|---|---|
ChunkSizeKb | 64 | Taille de chaque bloc de transfert |
MaxDownloadMb | 2048 | Plus gros téléchargement unitaire ; 0 signifie illimité |
ReconnectDelayMs | 5000 | Premier délai de reconnexion. Il double ensuite à chaque tentative, avec un aléa, jusqu'à 30 secondes |
TransferSpeedLimitKbps | 0 | Plafond de débit sortant ; 0 signifie illimité |
IA et base de connaissances
| Champ | Défaut | Signification |
|---|---|---|
AiModelId | qwen2.5-1.5b-instruct | Le modèle principal |
AiDevice | auto | auto choisit le GPU quand un GPU Vulkan est présent ; cpu et gpu l'imposent. cuda est encore accepté comme valeur héritée |
AiTemperature | 0.7 | Température d'échantillonnage |
AiMaxNewTokens | 512 | Plafond de longueur des réponses |
AiSystemPrompt | vide | Ajouté au début de chaque conversation |
AiAutoStart | false | Démarrer le service d'IA avec l'agent |
AiDocumentModel, AiVisionModel, AiCodeModel, AiSummaryModel | vide | Modèles spécialisés ; un emplacement vide se rabat sur le modèle principal |
KbEnabled | true | Injecter le contexte de la base de connaissances dans le chat d'IA |
KbPaths | vide | Dossiers à indexer |
KbIncludeBrowser | false | Indexer l'historique du navigateur |
KbIncludeEmail | false | Indexer les fichiers .eml et .msg |
KbPrivacyAccepted | false | Enregistre que la boîte de dialogue de consentement a été affichée |
KbScheduleEnabled | false | Réindexer selon un calendrier |
KbScheduleDays | non défini | Jours de la semaine pour la réindexation ; une liste vide signifie jamais |
KbScheduleTime | 03:00 | Heure de l'exécution planifiée, sur 24 heures |
KbScheduleIntervalHours apparaît encore dans d'anciens fichiers de paramètres. Il n'est lu
que pour que ces fichiers continuent de se charger et ne contrôle plus rien — les deux
champs ci-dessus l'ont remplacé.
Le port du service d'IA n'est plus configurable — il est fixé à 8765. D'anciens fichiers de
paramètres peuvent encore contenir un champ AiPort ; il est ignoré.
Mises à jour
| Champ | Défaut | Signification |
|---|---|---|
UpdateCheckEnabled | true | Interrupteur général de la vérification des mises à jour |
UpdateChannel | stable | stable ou beta |
UpdateSkippedVersion | vide | La seule version que vous avez choisi d'ignorer |
Ce que ces paramètres font réellement est traité dans maintenir Filemote à jour.
Pourquoi l'appairage reste préférable
Un agent configuré avec un mot de passe de compte dérive de ce mot de passe la clé de chiffrement de vos fichiers. Changez le mot de passe dans le navigateur et les deux côtés cessent de s'accorder : le navigateur dérive immédiatement la nouvelle clé tandis que l'agent en cours d'exécution garde l'ancienne, et tout ce qu'il renvoie se déchiffre en charabia. Le symptôme, et le remède, sont dans l'appareil apparaît hors ligne.
L'appairage évite tout le problème en transportant la clé dans le code lui-même, hors bande. La configuration manuelle existe pour les installations sans écran et scriptées ; si vous avez un écran et un navigateur, appairez l'appareil.
Mis à jour le 2026-07-31