> ## Documentation index
> Fetch the complete documentation index at: https://tgcloud.docs7.io/llms.txt
> Ask it with GET https://tgcloud.docs7.io/ask?q=<keywords or question>. Short keywords rank best.
> Use these to discover all available pages before exploring further.

# Dépannage

> Erreurs fréquentes et correctifs

# Dépannage

## `"tgcloud login" requires an interactive terminal`

La CLI veut un TTY. Utilisez `login_bot` : il envoie le jeton sur stdin avec `TGCLOUD_ASSUME_TTY=1`. En CI : `TGCLOUD_TOKEN='app...'`.

## `Token format looks wrong. Expected "app<id>:<secret>"`

C'était le jeton Bot API. Il faut le **jeton d'accès CLI** : @BotFather → bot → Serverless → CLI Access.

## `Could not reach the tgcloud server`

`cloud.telegram.org` est injoignable. Vérifiez le réseau et le proxy, et dirigez la CLI via `TGCLOUD_CLI` vers une enveloppe avec `HTTPS_PROXY` et `NODE_USE_ENV_PROXY=1`.

## `This bot already has N deployed modules (revision R)`

Le nuage et le projet ont divergé : `fetch` → `diff` → `push` (ou, en connaissance de cause, `push { force: true, confirm: true }`).

## `non-interactive session — specify --safe, --yes, or --dry-run`

Utilisez `migrate`. Le défaut est `--dry-run`. Appliquer exige `dry_run: false` et `confirm: true`. `apply: "safe"` correspond à `--safe` (les suppressions en avertissement sont sautées). `apply: "yes"` correspond à `--yes` (ces suppressions sont appliquées, les changements de type manuels non).

## Les commandes refusent un projet dont `schema.js` est à la racine

C'est la disposition d'avant la CLI 0.2.0. `upgrade` avec `dry_run: true`, puis `upgrade { dry_run: false, confirm: true }`.

## `chat not found` dans `run_handler`

Attendu avec un identifiant de chat fictif : les écritures en base réussissent, seul l'envoi réel vers Telegram échoue. La logique du handler s'exécute quand même.

## Aucun log d'un bot déployé

Aucune commande ne télécharge les logs d'un bot déployé. `tgcloud run`
(`run_handler`) capture `console.*`, mais il exécute vos fichiers locaux sur la
plateforme sans déployer — ce n'est pas la sortie du bot déployé. Pour
diagnostiquer un échec après déploiement, lisez `webhook_status`
(`tgcloud webhook`) : la dernière erreur de livraison et l'état de
synchronisation sont les premiers indices. Reproduisez ensuite le chemin avec
`run_handler`.

## La Mini App montre un ancien front

`push` ne lance pas le bundler. Appelez `deploy`, ou construisez puis poussez. `immutable` dans `tgcloud.jsonc` met en cache les fichiers correspondants pendant un an — seulement pour les chemins au contenu haché, par exemple `/assets/*`.