Documentation
Tout ce qu'il faut pour piloter ton VPS
De l'installation de l'app au premier déploiement, chaque écran expliqué simplement. Aucune commande à taper.
Installer Coxios
Coxios est une application de bureau. Télécharge-la depuis le bouton Télécharger du site, puis ouvre le fichier .dmg et glisse Coxios dans ton dossier Applications.
La version macOS (Universal, puces Apple et Intel) est disponible aujourd'hui. Les versions Windows et Linux arrivent : le bouton de téléchargement l'indique pour ton système.
L'app est signée et notarisée par Apple : macOS l'ouvre sans avertissement. Elle se met ensuite à jour toute seule, un bandeau te prévient quand une nouvelle version est prête.
Créer ton compte et connecter l'app
Le compte Coxios sert à rattacher ton abonnement à l'app. Il se crée sur le site, par email ou avec Google.
Dans l'app, la connexion s'ouvre dans ton navigateur : tu te connectes sur coxios.com, puis tu reviens dans l'app, déjà connectée. Aucun mot de passe n'est jamais saisi dans l'app, et la session reste active même après un redémarrage.
Sans connexion, l'app fonctionne avec le plan gratuit (1 serveur).
Ajouter un serveur
Clique sur Ajouter un serveur. Coxios te demande d'abord si ton VPS est tout neuf ou si tu l'utilises déjà.
- 1
VPS tout neuf
Tu viens de l'acheter et tu as reçu un email avec une adresse IP, l'utilisateur
rootet un mot de passe. Saisis-les tels quels : Coxios se connecte, puis l'assistant de configuration sécurise tout. - 2
VPS déjà configuré
Tu as déjà un utilisateur dédié et une clé SSH. Coxios cherche tes raccourcis dans
~/.ssh/configet te propose de les importer en un clic. Il ne modifie rien sur le serveur sans ta confirmation. - 3
Mot de passe ou clé SSH
Tu choisis le mode de connexion. Si ta clé est protégée par une phrase secrète, Coxios peut la garder dans le trousseau de ton système.
- 4
Empreinte du serveur
À la première connexion, Coxios enregistre l'empreinte SSH du serveur dans son propre fichier (il ne touche pas à ton
~/.ssh/known_hosts). Si elle change un jour sans que tu aies réinstallé le VPS, l'app t'alerte au lieu de se connecter.
L'assistant de configuration
Sur un VPS neuf, l'assistant applique les bonnes pratiques de sécurité, étape par étape. Chaque étape vérifie d'abord ce qui est déjà en place, et tu vois les commandes envoyées.
Structure de déploiement
Prépare les dossiers où vivront tes applications.
Utilisateur non-root
Crée ton utilisateur avec les droits sudo et y installe ta clé SSH.
Durcissement SSH
Désactive la connexion
rootet l'authentification par mot de passe.Pare-feu
Active UFW (ou firewalld sur Rocky, Alma, RHEL) et n'ouvre que les ports choisis.
Durcissement du noyau
Règle les paramètres réseau du système (sysctl) contre l'usurpation d'IP et les attaques SYN.
Fail2ban
Bloque les adresses qui essaient des mots de passe en boucle.
Docker et Compose
Installe Docker Engine et Docker Compose pour tes applications.
Reverse proxy
Installe Caddy, qui gère le HTTPS tout seul, ou respecte le proxy déjà présent (Nginx, Traefik).
Mises à jour automatiques
Active les mises à jour de sécurité automatiques du système.
Sécurité au quotidien
L'onglet Sécurité d'un serveur lit en continu ce qui le protège : fail2ban et ses blocages, le pare-feu, la configuration SSH, les certificats HTTPS et les ports ouverts. Un code couleur indique ce qui demande ton attention.
Deux analyses plus poussées se lancent à la demande, en lecture seule :
- Lynis : environ 250 contrôles de configuration, et un indice de durcissement sur 100 avec des suggestions numérotées.
- Trivy : compare les images Docker déployées à la base publique des failles connues.
Applications Docker
L'onglet Applications déploie tes apps dans des conteneurs Docker, de deux façons :
- Catalogue : des services prêts à l'emploi en un clic (WordPress, Vaultwarden, Plausible, n8n, Nextcloud, Invoice Ninja, Supabase…) avec une configuration guidée.
- Dépôt Git : Coxios clone ton dépôt directement sur le VPS (GitHub, GitLab, Bitbucket ou auto-hébergé) et le construit avec son
Dockerfileou sondocker-compose.yml. - Les accès Git se rangent une fois dans Sources Git : jeton d'accès (gardé dans le trousseau), clé de déploiement SSH, ou GitHub App.
- Le déploiement automatique redéploie l'app à chaque push sur la branche choisie, via un webhook signé.
- Les variables d'environnement de chaque app se modifient depuis l'app, sans ouvrir le fichier
.env.
Domaines et HTTPS
Pour relier un domaine à une app, crée chez ton registraire (OVH, Gandi, Cloudflare, Namecheap…) un enregistrement A qui pointe vers l'IP du serveur. Coxios vérifie le DNS pour toi et te dit s'il est bien propagé.
Avec Caddy, le certificat HTTPS Let's Encrypt est obtenu et renouvelé automatiquement, en une trentaine de secondes. Avec Nginx, la liaison se fait en HTTP pour l'instant.
Supervision et journaux
L'onglet Monitoring affiche le processeur, la mémoire, le disque, le swap, la charge, le réseau, les services et les processus les plus gourmands. Tu règles des seuils d'alerte et l'app te notifie quand ils sont dépassés.
L'onglet Journaux suit en direct les logs d'un conteneur, d'un service ou d'un fichier système, avec filtre, pause et défilement automatique.
Utilisateurs du serveur
L'onglet Utilisateurs gère les comptes système du VPS : créer un utilisateur, lui donner ou retirer les droits administrateur, ajouter sa clé SSH publique ou en générer une, définir un mot de passe de secours, le verrouiller ou le supprimer.
Coxios explique les groupes qui donnent en pratique tous les pouvoirs (comme docker), et écrit les règles sudo dans un fichier séparé validé par visudo : il ne touche jamais /etc/sudoers.
Verrouiller l'app
Dans les réglages, tu peux demander Touch ID ou un code pour ouvrir Coxios, après un temps d'inactivité, et avant les actions irréversibles (supprimer un serveur, une app avec ses données, un utilisateur).
Abonnement
Le plan gratuit gère 1 serveur. Pro en gère 5 et Business 50 (au-delà, tu déclares le nombre de serveurs, jusqu'à 200). Les tarifs sont sur la page Tarifs.
Tu t'abonnes et tu gères ton abonnement depuis ton espace compte. L'abonnement est rattaché à ton organisation : l'app le reconnaît dès que tu t'y connectes.
Dépannage
L'app me demande le mot de passe sudo
Ton utilisateur demande un mot de passe pour sudo. Coxios l'utilise pour les actions d'administration, sans le stocker en clair. Un bandeau propose de rendre ces droits permanents si tu le souhaites.
Le serveur apparaît injoignable
Lance le Diagnostic complet depuis la fiche du serveur. Les causes les plus courantes : le VPS est éteint, le port SSH a changé, ou ton IP a été bloquée par fail2ban après plusieurs essais. Dans ce dernier cas, attends la fin du blocage ou débloque-la depuis la console de ton hébergeur.
Le bouton Terminal demande un mot de passe
Après le durcissement, seule ta clé SSH permet de se connecter. Vérifie que la clé ~/.ssh/coxios-… existe toujours sur ton ordinateur.
Mon domaine ne répond pas en HTTPS
Vérifie que l'enregistrement A pointe bien vers l'IP du serveur (Coxios le teste), puis laisse quelques minutes à la propagation. Si Caddy ne démarre pas, un autre programme occupe sans doute le port 80 ou 443.
Un conteneur exposé reste accessible malgré le pare-feu
C'est un comportement de Docker : un port publié avec -p contourne UFW. Préfère relier l'app à un domaine, elle passe alors derrière le reverse proxy en HTTPS.