# Support Coolidash

Une question, un bug, une demande de fonctionnalité : écrivez à **x@n4th4n.dev**,
la réponse arrive généralement sous 48 heures ouvrées.

Page HTML : https://n4th4n.dev/coolidash/support/

## Démarrer

1. Ouvrez Coolidash, touchez **Connecter un serveur**.
2. Choisissez le protocole : **HTTPS** pour une adresse publique, **HTTP** uniquement si votre instance est sur le réseau local.
3. Saisissez le domaine ou l'IP, avec le port si nécessaire — par exemple `coolify.mondomaine.fr` ou `192.168.1.10:8000`.
4. Collez un jeton API Coolify, puis validez. La connexion est testée avant l'enregistrement.

## Créer un jeton API

Dans Coolify : **Keys & Tokens** → **API tokens** → **Create New Token**.

Permissions conseillées : `read` et `deploy`. Ajoutez `read:sensitive` pour consulter les logs.
N'accordez jamais la permission `root` : elle n'est pas nécessaire et donnerait bien plus
d'accès que ce dont l'application a besoin.

Vérifiez aussi que l'API est activée dans **Settings** → **API**, et que votre IP n'est pas
exclue si vous avez configuré une liste d'adresses autorisées.

## Problèmes fréquents

### « Serveur introuvable »

Le domaine ne résout pas. Vérifiez l'orthographe, et testez la même adresse depuis Safari
sur le même iPhone.

### « Connexion refusée »

L'adresse répond mais rien n'écoute sur ce port. Coolify écoute souvent sur `8000` derrière
son proxy : essayez d'ajouter le port explicitement.

### « Le jeton n'a pas les permissions nécessaires »

Le jeton existe mais son périmètre est trop étroit. Recréez-le avec `read` et `deploy`.

### « Le certificat HTTPS du serveur a été refusé »

Certificat auto-signé ou expiré. iOS refuse ces certificats. Utilisez un certificat valide,
par exemple via Let's Encrypt, tel que Coolify le configure par défaut.

### « HTTP n'est accepté que sur votre réseau local »

Envoyer un jeton API en clair sur Internet l'expose à toute machine sur le trajet.
L'application l'autorise donc uniquement vers `192.168.x.x`, `10.x.x.x`, `172.16-31.x.x`,
`localhost` et les domaines `.local`.

### Statut « inconnu » sur un service

L'API Coolify ne renvoie pas d'état pour les services. Coolidash le déduit de la liste des
ressources de la machine, ce qui demande à votre jeton l'accès en lecture aux serveurs.
Sans cet accès, le statut reste inconnu, mais les actions restent utilisables.

### Métriques CPU et mémoire

Elles ne sont pas exposées par l'API publique de Coolify (`/api/v1`), uniquement par son
interface web. Coolidash affiche donc la joignabilité des machines et l'état de leurs
ressources. Le jour où Coolify publiera ces endpoints, l'application les affichera.

## Abonnement

Coolidash Pro est un abonnement mensuel géré par Apple. Résiliation à tout moment depuis
**Réglages** → votre nom → **Abonnements** sur l'iPhone. Pour un remboursement, la demande
passe par Apple via https://reportaproblem.apple.com.

Le bouton **Restaurer mes achats** de l'application rétablit l'accès sur un nouvel appareil
connecté au même compte Apple.

## Signaler un bug

Précisez la version de l'application, celle d'iOS, celle de Coolify, et le message d'erreur
exact. Ne joignez jamais votre jeton API dans un e-mail.

---

Coolidash : https://n4th4n.dev/coolidash/ · Confidentialité : https://n4th4n.dev/coolidash/confidentialite/ · Éditeur : https://n4th4n.dev/
Application indépendante, sans lien ni affiliation avec le projet Coolify.