title: $:/language/Help/listen
description: Fournit à TiddlyWiki une interface serveur HTTP

Sert un wiki via HTTP.

La commande //listen// utilise des [[paramètres de commande nommés|NamedCommandParameters]] :

```
--listen [<nom>=<valeur>]...
```

Tous les paramètres sont optionnels avec des valeurs par défaut sûres, et peuvent être spécifiés dans n'importe quel ordre. Les paramètres reconnus sont les suivants :

* ''host'' - nom ou adresse de machine hôte à laquelle sera attaché le service (par défaut "127.0.0.1", autrement dit "localhost")
* ''path-prefix'' - préfixe optionnel pour les noms de chemin
* ''port'' - numéro de port sur lequel écouter ; une valeur non numérique est interprétée comme un nom de variable d'environnement dont sera extrait le numéro de port (par défaut à "8080")
* ''credentials'' - chemin vers le fichier CSV d'autorisations (relativement au dossier du wiki)
* ''anon-username'' - nom d'utilisateur qui servira à signer les modifications si l'utilisateur est anonyme
* ''username'' - nom d'utilisateur optionnel pour l'authentification basique
* ''password'' - mot de passe optionnel pour l'authentification basique
* ''authenticated-user-header'' - nom d'en-tête optionnel à utiliser pour les authentifications de confiance
* ''readers'' - liste de personnes de confiance autorisées à lire ce wiki, séparées par des virgules 
* ''writers'' - liste de personnes de confiance autorisées à modifier ce wiki, séparées par des virgules
* ''csrf-disable'' - donner la valeur "yes" pour désactiver les vérifications CSRF (vaut "no" par défaut)
* ''sse-enabled'' - donner la valeur "yes" pour activer les événement envoyés par le serveur (valeur "no" par défaut)
* ''root-tiddler'' - le tiddler à servir à la racine (par défaut "$:/core/save/all")
* ''root-render-type'' - le type de contenu avec lequel le tiddler racine doit être rendu (par défaut "text/plain")
* ''root-serve-type'' - le type de contenu avec lequel le tiddler racine doit être servi (par défaut "text/html")
* ''tls-cert'' - nom de chemin du fichier de certificat TLS (relativement au dossier du wiki)
* ''tls-key'' - nom de chemin du fichier de clé TLS (relativement au dossier du wiki)
* ''debug-level'' - niveau de débogage optionnel ; mettre à "debug" pour voir le détail des requêtes (par défaut à "none")
* ''gzip'' - donner la valeur "yes" pour activer la compression gzip pour certaines interactions http (par défaut à "no")
* ''use-browser-cache'' - une valeur "yes" autorise le navigateur à mettre en cache les réponses pour économiser de la bande passante ("no" par défaut)

Pour plus d'informations sur la manière de donner accès à votre instance de serveur à l'ensemble de votre réseau local, ainsi que sur les risques éventuels en matière de sécurité, voir le tiddler [[WebServer sur tiddlywiki.com|https://tiddlywiki.com/#WebServer]].

