Guides

Des guides pas à pas, sans terminal

Un objectif, quelques clics. Chaque guide part d'un cas réel et va jusqu'au résultat.

Sécuriser un VPS tout neuf

Durée : une dizaine de minutes. Il te faut l'email de ton hébergeur avec l'IP et le mot de passe root.

1
Ajoute le serveur
Clique sur Ajouter un serveur, choisis VPS tout neuf, puis saisis l'IP, l'utilisateur root et le mot de passe reçus.
2
Lance l'assistant de configuration
Choisis le nom de ton utilisateur et les ports à ouvrir (par défaut SSH, HTTP et HTTPS). L'assistant affiche chaque étape avant de l'exécuter.
3
Laisse-le travailler
Utilisateur non-root, durcissement SSH, pare-feu, noyau, fail2ban, Docker, reverse proxy et mises à jour automatiques : chaque étape vérifie ce qui existe déjà avant d'agir.
4
Confirme le durcissement SSH
Avant de couper la connexion root et les mots de passe, Coxios vérifie que ta nouvelle clé fonctionne et te demande une confirmation explicite.
5
Vérifie le résultat
Ouvre l'onglet Sécurité : tout doit être au vert. Pour aller plus loin, lance l'audit Lynis et regarde l'indice de durcissement.

Pour une app qui a un Dockerfile ou un docker-compose.yml à la racine de son dépôt.

1
Enregistre ta source Git
Dans Sources Git, ajoute ton compte GitHub, GitLab ou Bitbucket : un jeton d'accès en lecture suffit (Contents: Read-only). Il est gardé dans le trousseau, jamais en clair.
2
Ajoute l'application
Sur la fiche du serveur, onglet Applications, clique sur Ajouter puis Dépôt Git. Colle l'URL du dépôt : Coxios vérifie l'accès et liste les branches.
3
Choisis le type de déploiement
Dockerfile ou docker-compose, la branche, le port de l'app et ses variables d'environnement.
4
Déploie
Coxios clone le dépôt directement sur le VPS et construit l'image. Si quelque chose bloque (Docker arrêté, Dockerfile introuvable), il te dit quoi corriger.
5
Active le déploiement automatique
Dans la configuration de l'app, configure le webhook : à chaque push sur la branche surveillée, l'app est redéployée. La signature est vérifiée, et seule la branche choisie déclenche un déploiement.

Il te faut un nom de domaine et une app déjà déployée avec un port exposé.

1
Crée l'enregistrement DNS
Chez ton registraire (OVH, Gandi, Cloudflare, Namecheap…), crée un enregistrement A pour ton domaine ou sous-domaine, qui pointe vers l'IP du serveur.
2
Relie le domaine à l'app
Sur l'app, clique sur Ajouter un domaine et saisis-le. Coxios vérifie que le DNS pointe au bon endroit et te prévient si la propagation n'est pas terminée.
3
Laisse Caddy faire le reste
Coxios ajoute le bloc dans la configuration de Caddy et le recharge. Le certificat Let's Encrypt arrive en une trentaine de secondes, et se renouvelle tout seul.

Pour suivre un VPS déjà configuré, sans rien changer dessus.

1
Choisis « VPS déjà configuré »
Coxios cherche tes raccourcis dans ~/.ssh/config.
2
Importe-le
Coche les serveurs à importer, ou saisis l'adresse, l'utilisateur et ta clé SSH à la main.
3
Regarde l'état réel
Coxios lit ce qui tourne : conteneurs, proxy, pare-feu, ports ouverts. L'assistant de configuration reste optionnel, et rien n'est modifié sans ta confirmation.
4
Vérifie les droits
Si ton utilisateur a besoin d'un mot de passe pour sudo, ou n'est pas dans le groupe docker, un bandeau l'explique et propose une réparation.

Chacun son compte et sa clé : personne ne partage le même accès.

1
Demande sa clé publique
Ton collègue t'envoie sa clé SSH publique, une ligne qui commence par ssh-ed25519 ou ssh-rsa. Elle se partage sans risque.
2
Crée son utilisateur
Dans l'onglet Utilisateurs, crée un compte à son nom. Coche les droits administrateur seulement s'il en a besoin.
3
Ajoute sa clé
Sur sa fiche, importe sa clé publique. Il peut maintenant se connecter avec sa propre clé privée.
4
Retire l'accès le jour venu
Verrouille ou supprime son compte en un clic. Ton accès et celui des autres ne sont pas touchés.