Virtana / Documentation
Bien démarrer avec votre conteneur.
Des guides pas à pas : clé SSH, connexion, publication web, ports, domaines, sauvegardes et abonnement.
01Créer votre clé SSH
Votre conteneur n’a pas de mot de passe : vous vous connectez avec une paire de clés SSH. La clé privée reste sur votre ordinateur. Vous ne communiquez que la clé publique, une ligne de texte qui commence par ssh-ed25519.
macOS et Linux
-
Ouvrez le Terminal. Sur macOS : Applications › Utilitaires › Terminal.
-
Créez la clé. Le texte après
-Cest un simple nom pour la reconnaître.ssh-keygen -t ed25519 -C "mon-ordinateur" -
Appuyez sur Entrée pour accepter l’emplacement proposé,
~/.ssh/id_ed25519. Si le terminal propose d’écraser une clé existante (« Overwrite »), répondezn: vous avez déjà une clé, gardez-la. -
Choisissez une phrase de passe. Elle protège votre clé si quelqu’un copie le fichier ; elle n’est jamais envoyée à Virtana.
-
Affichez la clé publique et copiez la ligne entière. Sur macOS,
pbcopy < ~/.ssh/id_ed25519.publa copie directement.cat ~/.ssh/id_ed25519.pub
Windows 10 et 11
-
Ouvrez PowerShell depuis le menu Démarrer. Si la commande
ssh-keygenest introuvable, ajoutez la fonctionnalité facultative « Client OpenSSH » dans les paramètres de Windows. -
Créez la clé :
ssh-keygen -t ed25519 -C "mon-pc" -
Appuyez sur Entrée pour accepter l’emplacement proposé,
C:\Users\votre-nom\.ssh\id_ed25519, puis choisissez une phrase de passe. -
Copiez la clé publique dans le presse-papiers :
Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub | Set-Clipboard
Vous utilisez PuTTY ? Dans PuTTYgen, choisissez le type EdDSA (Ed25519), cliquez sur « Generate », puis copiez le texte du cadre « Public key for pasting into OpenSSH authorized_keys file ».
Coller la clé à la commande
Dans le configurateur, collez la ligne complète dans le champ « Clé SSH publique ». Trois formats sont acceptés : ssh-ed25519 (recommandé), ssh-rsa et ecdsa-sha2-nistp256.
Ne transmettez jamais la clé privée, c’est-à-dire le fichier sans extension .pub : ni dans le configurateur, ni au support.
Ajouter ou retirer une clé plus tard
- Sur la fiche du conteneur, onglet « Accès et fichiers », le propriétaire peut ajouter jusqu’à 20 clés, par exemple une par appareil, et retirer celles qui ne servent plus. Le conteneur doit être démarré.
- La dernière clé ne peut pas être retirée : ajoutez et testez d’abord sa remplaçante. Un retrait ne coupe pas les sessions déjà ouvertes.
- Clé privée perdue ? Créez une nouvelle paire de clés et ajoutez la nouvelle clé publique depuis cet onglet : l’espace client ne demande aucun accès SSH.
02Se connecter en SSH ou SFTP
Dès la livraison, la fiche du conteneur affiche la commande de connexion exacte, vers son adresse IPv6 publique, sur le port 22. Si votre connexion n’a pas d’IPv6, la fiche donne aussi une commande par le nom de l’instance et son port publié. Un conteneur sans IPv6, dans un projet par exemple, se joint par un port SSH qui lui est attribué : sa commande l’indique avec -p, et ce port ne change pas.
-
Ouvrez Mon infrastructure, puis la fiche de votre conteneur et l’onglet « Accès et fichiers ». La commande figure aussi dans « Vue d’ensemble », avec un bouton pour la copier.
-
Collez-la dans votre terminal. Elle a cette forme :
ssh root@ADRESSE-IPV6 -
À la première connexion, le terminal affiche l’empreinte du serveur et demande de la confirmer : répondez
yes. Votre phrase de passe vous est ensuite demandée si vous en avez choisi une.
Si votre clé n’est pas à l’emplacement par défaut, indiquez-la avec -i :
ssh -i ~/.ssh/ma-cle root@ADRESSE-IPV6Vous êtes connecté en root : le système vous appartient. Appliquez régulièrement les mises à jour, par exemple apt update && apt upgrade sur Debian et Ubuntu.
Transférer des fichiers en SFTP
SFTP utilise la même adresse, le même port, le compte root et la même clé. sftp et scp veulent l’adresse IPv6 entre crochets, et notent un port avec un -P majuscule.
sftp root@[ADRESSE-IPV6]scp site.zip root@[ADRESSE-IPV6]:/root/Avec un logiciel comme FileZilla, Cyberduck ou WinSCP, choisissez le protocole SFTP, puis saisissez l’adresse, le port, l’utilisateur root et votre fichier de clé privée.
BientôtUne console web et un gestionnaire de fichiers dans l’espace client. En attendant, utilisez SSH ou SFTP.
Retour au sommaire03Publier une application web
Chaque conteneur reçoit sa propre adresse HTTPS : son nom sur nos serveurs, v- suivi des 12 premiers caractères de son identifiant, puis .instances.virtana.fr. Elle figure dans « Vue d’ensemble ». Virtana gère le certificat et transmet les visites en HTTP au port 80 de votre conteneur.
-
Installez un serveur web qui écoute en HTTP sur le port 80. Par exemple, sur Debian ou Ubuntu :
apt update && apt install -y nginx -
Vérifiez depuis le conteneur que la page répond :
curl -I http://localhost -
Ouvrez l’adresse HTTPS de « Vue d’ensemble » dans votre navigateur : la page de votre serveur web s’affiche.
Bon à savoir
- N’activez pas HTTPS sur le port 80 du conteneur : la connexion chiffrée s’arrête au relais de Virtana, qui transmet ensuite en HTTP.
- Votre application doit écouter sur toutes les interfaces (
0.0.0.0), pas seulement sur127.0.0.1. - Une application qui écoute sur un autre port, comme 3000 ou 8080 : placez un serveur web devant elle sur le port 80, ou reliez un domaine personnalisé directement à ce port (voir Relier un domaine).
- Les visites arrivent depuis le relais de Virtana : l’adresse du visiteur figure dans l’en-tête
X-Forwarded-For. - Le trafic Internet est illimité et offert pendant le lancement.
04Ajouter un port public
Pour un service qui n’est pas un site web (serveur de jeu, base de données, VPN…), ouvrez un port public. Les conteneurs partagent une adresse IPv4 : Virtana attribue un numéro de port public et le redirige vers le port de votre choix dans le conteneur.
-
Démarrez le conteneur, puis ouvrez l’onglet « Réseau et domaines ».
-
Dans « Ports publics », choisissez TCP ou UDP et le port sur lequel votre service écoute dans le conteneur, puis cliquez sur « Ajouter un port ».
-
La redirection s’affiche sous la forme
NOM-DE-L’INSTANCE:PORT-PUBLIC → PORT-DU-CONTENEUR, avec son état (ADRESSE-IP:PORT-PUBLICpour un conteneur sans IPv6). Elle devient active dès que la passerelle l’a confirmée : actualisez la page après quelques instants. -
Communiquez cette adresse à vos utilisateurs. En IPv6, ils joignent aussi le service directement, à l’adresse du conteneur et sur son propre port.
Bon à savoir
- Le nombre de ports inclus dépend de l’offre et s’affiche dans cet onglet, en plus du port SSH. Une redirection TCP et une redirection UDP comptent chacune pour un port, même avec le même numéro.
- Besoin de plus de ports ? L’option « pack de ports » se choisit dans le configurateur, à la commande, avec un supplément mensuel. Elle s’ajoute aussi plus tard, sous la liste des ports de cet onglet : vous payez la part de la période en cours qui reste, puis le supplément à chaque renouvellement.
- Le numéro public est attribué automatiquement : vous ne pouvez pas réserver un numéro précis.
- Le pare-feu du conteneur n’accepte que les ports déclarés ici, en plus de SSH et du port 80.
- L’arrêt ou la suspension du conteneur coupe aussi ses redirections. Si une redirection ne revient pas après le démarrage, ou après une erreur que vous avez corrigée, cliquez sur « Synchroniser les accès ».
BientôtRetirer un port depuis l’espace client, et l’IPv6.
Retour au sommaire05Relier un domaine
Servez votre application sous votre propre nom, par exemple app.example.fr, avec HTTPS géré par Virtana. Un enregistrement DNS TXT prouve d’abord que le nom vous appartient.
-
Démarrez le conteneur. Dans l’onglet « Réseau et domaines », section « Domaines personnalisés », saisissez le nom complet et le port HTTP du conteneur (80 par défaut), puis cliquez sur « Ajouter le domaine ».
-
Chez le fournisseur DNS du domaine, créez les deux enregistrements affichés sous le nom : un TXT
_virtana.app.example.fravec la valeurvirtana=…indiquée, et un Aapp.example.frvers l’adresse IPv4 indiquée. -
Attendez que ces enregistrements soient visibles, de quelques minutes à quelques heures selon leur durée de vie (TTL), puis cliquez sur « Vérifier le DNS ».
-
Une fois le TXT trouvé, Virtana publie la route et obtient le certificat HTTPS. Le domaine passe ensuite à l’état actif.
Domaine acheté avec votre compte, chez OVH
Si le domaine est actif dans votre compte et a été enregistré chez OVH, le bouton « Configurer le DNS chez OVH » crée les enregistrements d’adresse et le TXT à votre place, puis il ne reste qu’à cliquer sur « Vérifier le DNS ». Il ne remplace jamais un enregistrement A, AAAA ou CNAME qui pointe ailleurs : il signale le conflit, que vous corrigez vous-même. Vos enregistrements de messagerie ne sont pas modifiés.
Bon à savoir
- Ajoutez chaque nom séparément :
example.fretwww.example.frsont deux domaines. - Supprimez tout enregistrement AAAA (IPv6) de ce nom : Virtana n’a pas encore d’IPv6 et ces visiteurs n’atteindraient pas votre conteneur.
- Les noms génériques comme
*.example.frne sont pas pris en charge. - Jusqu’à 20 domaines par conteneur. Un même nom ne peut être relié qu’à un seul conteneur.
- Comme pour l’adresse Virtana, votre application reçoit les visites en HTTP sur le port indiqué, ouvert automatiquement dans le pare-feu du conteneur.
06Acheter un domaine
Commandez un nom de domaine depuis la fiche d’un conteneur. Il est enregistré chez OVHcloud pour un an, puis relié automatiquement à ce conteneur.
-
Dans l’onglet « Réseau et domaines », section « Commander un domaine », saisissez le nom souhaité, par exemple
example.fr, puis cliquez sur « Vérifier la disponibilité et le prix ». -
S’il est disponible, le prix pour un an s’affiche, HT et TTC. Le devis est valable une heure ; rien n’est acheté à ce stade.
-
Confirmez votre demande, puis payez par carte avec Stripe, dans la fenêtre de paiement sécurisée. La carte est enregistrée pour le renouvellement annuel ; le solde commun ne peut pas régler un domaine.
-
Après le paiement, le domaine est enregistré chez OVHcloud. Virtana le relie ensuite au port 80 de votre conteneur, DNS et HTTPS compris, sans action de votre part. Le suivi s’affiche sous le formulaire.
Bon à savoir
- Avant votre premier achat, vos coordonnées de titulaire doivent être validées. Si un message vous le demande, ouvrez un ticket depuis votre espace client.
- Certaines extensions qui exigent des justificatifs particuliers ne peuvent pas être commandées : le devis l’indique avant tout paiement.
- Une fois le domaine enregistré, vous ne pouvez plus exercer de droit de rétractation (conditions générales de vente).
Renouvellement
- Le domaine se renouvelle automatiquement pour un an. Son échéance figure sur sa page, accessible depuis la section « Commander un domaine » de l’onglet « Réseau et domaines ».
- 35 jours avant l’échéance, vous recevez un email avec le prix du renouvellement et la date du débit.
- 14 jours avant l’échéance, ce prix est débité sur la carte de votre dernier paiement. En cas d’échec, une seconde tentative a lieu 7 jours avant, et vous pouvez payer par carte depuis la page du domaine, bouton « Payer le renouvellement », jusqu’à 3 jours avant l’échéance.
- Pour ne pas renouveler, cliquez sur « Désactiver le renouvellement automatique » sur la page du domaine : rien n’est débité et le domaine expire à son échéance. Vous pouvez le réactiver jusqu’à 3 jours avant.
- Sans paiement à cette date, le domaine n’est pas renouvelé : il expire et peut ensuite être enregistré par un tiers.
07Sauvegardes et restauration
Chaque conteneur actif est sauvegardé automatiquement une fois par jour sur un serveur de sauvegarde dédié. Les sept dernières sauvegardes quotidiennes sont conservées.
Consulter et lancer une sauvegarde
- L’onglet « Sauvegardes » liste les sauvegardes avec leur date et leur état.
- « Créer une sauvegarde » lance une sauvegarde immédiate, par exemple avant une mise à jour importante. Elle compte parmi les sept sauvegardes conservées : les plus anciennes sont effacées au fur et à mesure.
- Une sauvegarde est aussi faite automatiquement avant chaque réinstallation.
- Un conteneur suspendu, en période de conservation ou occupé par une autre opération n’est pas sauvegardé.
Restaurer une sauvegarde
-
Arrêtez le conteneur depuis « Vue d’ensemble ».
-
Dans « Sauvegardes », sous la sauvegarde choisie, saisissez le nom exact du conteneur pour confirmer, puis cliquez sur « Restaurer ».
-
Le disque du conteneur est remplacé par la sauvegarde : tout ce qui a été écrit après elle est perdu. Les accès publics sont coupés pendant l’opération.
-
À la fin, le conteneur reste arrêté : démarrez-le depuis « Vue d’ensemble ».
Seul le propriétaire du conteneur peut restaurer une sauvegarde.
BientôtLa restauration d’une sauvegarde dans un nouveau conteneur.
BientôtL’export d’une sauvegarde en archive à télécharger.
Gardez vos propres copies
Les sauvegardes de Virtana sont un service d’appoint. Gardez aussi vos propres copies, surtout avant une résiliation. Par exemple, depuis votre ordinateur :
scp -r root@[ADRESSE-IPV6]:/var/www ./copie-wwwBientôtLes snapshots instantanés.
Retour au sommaire08Modifier les ressources ou réinstaller
Depuis l’onglet « Réglages » de la fiche, agrandissez un conteneur à tout moment, programmez une réduction pour le renouvellement ou repartez d’un système neuf.
Agrandir ou changer d’offre
-
Dans « Réglages », section « Modifier les ressources », choisissez d’autres paliers de processeur, de mémoire ou de disque, ou une offre supérieure, puis cliquez sur « Calculer le prix ».
-
Le prix affiché est la différence pour les jours restants de la période en cours, hors taxes et toutes taxes comprises, suivie du nouveau prix de renouvellement.
-
Payez avec « Payer avec le solde commun » ou par carte. La capacité du serveur est vérifiée avant le paiement : si elle manque, rien n’est débité.
-
Les ressources sont ajoutées en une à deux minutes, sans redémarrage. Un email confirme le changement, avec la facture.
Le système de fichiers est agrandi avec le disque. Pour vérifier la nouvelle taille :
df -h /Réduire
- Choisissez moins de processeur ou de mémoire, puis « Programmer la réduction ». La réduction prend effet au prochain renouvellement, au nouveau prix ; la période en cours n’est pas remboursée.
- Jusqu’au renouvellement, « Annuler la réduction » l’annule.
- Le disque ne peut pas être réduit, et une offre ne peut pas être remplacée par une offre inférieure.
- Avant la date, vérifiez que vos applications tiennent dans la nouvelle mémoire : au-delà, le système arrête des processus.
Réinstaller le système
-
Dans « Réglages », section « Réinstaller le système », choisissez une distribution et saisissez le nom exact du conteneur pour confirmer.
-
Une sauvegarde est faite d’abord. Le disque est ensuite effacé et le système neuf démarré, avec la même adresse IP, les mêmes ports, domaines et adresse HTTPS, vos clés SSH actuelles et le pare-feu. Comptez quelques minutes ; un email vous prévient à la fin.
-
Pour revenir à l’ancien système, restaurez cette sauvegarde depuis « Sauvegardes ».
-
Votre ordinateur signale que la clé d’hôte SSH a changé : c’est normal. Effacez l’ancienne, puis reconnectez-vous :
ssh-keygen -R ADRESSE-IPV6
La réinstallation est gratuite et illimitée, une opération à la fois. Les règles complètes figurent dans les conditions générales de vente.
Retour au sommaire09Renouvellement, solde, carte et résiliation
Votre conteneur est un abonnement payé d’avance pour un, trois, six ou douze mois, avec une remise sur les périodes longues. Il se renouvelle pour la même durée, au prix de votre contrat.
Paiement et renouvellement
- La première période se règle avec le solde commun ou en ligne avec Stripe. Chaque paiement donne lieu à une facture, disponible dans votre espace client.
- La date du prochain renouvellement figure dans « Vue d’ensemble ».
- À l’échéance, le renouvellement est prélevé sur votre solde commun, partagé avec les autres services de la suite Newscloud, s’il le couvre. Le solde n’est jamais rechargé automatiquement : rechargez-le à l’avance depuis Mon infrastructure, avec le lien « Recharger le solde commun ».
- S’il ne le couvre pas, votre carte de renouvellement est débitée, si vous en avez enregistré une. Sans carte enregistrée, aucune carte n’est débitée.
- Un email vous rappelle chaque échéance 7 jours avant. Si vous êtes un particulier, un abonnement de trois, six ou douze mois fait aussi l’objet d’un email, un à trois mois avant son terme, qui vous rappelle que vous pouvez ne pas le reconduire.
Carte de renouvellement
- Elle est facultative. Cochez « Renouveler automatiquement avec cette carte » en payant votre commande par carte, ou enregistrez-en une depuis la page Facturation, section « Carte de renouvellement », ou depuis l’onglet « Réglages » de la fiche, sous-onglet « Renouvellement ». Vous la saisissez sur une page sécurisée de Stripe : Virtana ne voit jamais son numéro, seulement sa marque, ses quatre derniers chiffres et sa date d’expiration.
- Une seule carte par compte, pour tous vos conteneurs : en enregistrer une autre remplace la précédente. Elle n’est débitée qu’à une échéance que votre solde commun ne couvre pas. Un email confirme son enregistrement.
- Retirez-la à tout moment avec « Retirer la carte » : elle n’est plus débitée et vos renouvellements se paient de nouveau avec le solde commun.
Si le renouvellement n’est pas payé
-
À l’échéance, un email vous prévient, avec un lien vers la fiche du conteneur pour payer par carte. Vous disposez d’un délai de grâce : 2 jours pour un abonnement mensuel, 7 jours pour un trimestriel, 14 jours pour un semestriel et 30 jours pour un annuel.
-
Pendant ce délai, payez par carte depuis la fiche ou rechargez votre solde : le renouvellement est alors effectué automatiquement. Une carte de renouvellement refusée est de nouveau débitée une fois par jour ; si votre banque demande une confirmation, payez depuis la fiche.
-
Sinon, le conteneur est suspendu : il est arrêté et ses accès sont coupés. Ses données sont conservées 7 jours.
-
Pendant cette conservation, payer le renouvellement, par carte depuis la fiche ou en rechargeant votre solde, redémarre le conteneur automatiquement, avec ses données et ses accès. La nouvelle période commence le jour du paiement.
-
Un dernier email vous avertit au moins 24 heures avant la suppression définitive.
Arrêter n’est pas résilier
Arrêter le conteneur ne change ni l’abonnement ni son prix : ses ressources restent réservées pour vous.
Résilier
-
Sur la fiche du conteneur, onglet « Réglages », cliquez sur « Résilier à échéance ».
-
Le conteneur reste disponible jusqu’à la fin de la période payée, qui n’est pas remboursée, sauf exercice du droit de rétractation.
-
À l’échéance, il est arrêté et ses données sont conservées 7 jours, puis supprimées après un dernier avertissement. Récupérez vos données avant la fin de l’abonnement.
Résilier immédiatement
-
Récupérez d’abord vos données : après la suppression, rien ne peut être restauré, pas même une sauvegarde.
-
Sur la fiche du conteneur, onglet « Réglages », section « Résilier immédiatement », saisissez le nom exact du conteneur pour confirmer, puis cliquez sur « Supprimer définitivement ».
-
Le conteneur est arrêté puis supprimé avec son disque, ses snapshots et ses sauvegardes. Son adresse IP, ses ports, son adresse HTTPS, la liaison de ses domaines et ses clés SSH sont libérés. Un email confirme la suppression et le conteneur disparaît de votre liste d’instances.
- Rien n’est remboursé : la période payée reste due jusqu’à son terme. L’abonnement n’est pas renouvelé et une réduction programmée est annulée.
- Vos commandes et vos factures restent disponibles dans votre espace client.
- Un nom de domaine acheté pour ce conteneur reste à vous et continue de se renouveler selon ses réglages. Vous pouvez le relier à un autre conteneur depuis l’onglet « Réseau et domaines » de celui-ci.
- Si vous êtes un particulier, le droit de rétractation reste un droit distinct pendant 14 jours : il vous rembourse au prorata. Pour l’exercer, écrivez au support au lieu de résilier.
- La résiliation immédiate est refusée tant qu’une autre opération est en cours ou en vérification sur le conteneur.
Annuler une commande pas encore livrée
-
Tant que le conteneur n’est pas livré, la section « Annuler la commande » de l’onglet « Réglages » remplace les deux résiliations. Saisissez le nom exact du conteneur, puis cliquez sur « Annuler la commande ».
-
Une commande payée est remboursée intégralement et un avoir annule sa facture. Payée avec le solde commun, elle lui est recréditée. Payée par carte, choisissez de la recevoir sur votre carte (sous 5 à 10 jours ouvrés) ou sur votre solde commun (aussitôt) : rien n’est choisi à l’avance.
-
Une commande impayée est simplement annulée, sans rien facturer. Un email confirme l’annulation et le conteneur disparaît de votre espace client ; pour une commande payée, la facture et son avoir restent dans la facturation.
Si la livraison a déjà commencé à créer le conteneur, ou si elle est en cours de vérification, écrivez au support : il supprime ce qui a été créé, puis rembourse la commande de la même façon.
Les règles complètes figurent dans les conditions générales de vente.
Retour au sommaire10Automatiser avec l’API
Une API JSON permet à vos scripts de lister vos conteneurs, de lire leur état, leurs sauvegardes et leurs mesures, et de les démarrer, arrêter, redémarrer ou sauvegarder. Elle s’utilise avec un jeton d’accès personnel, créé depuis votre compte.
- Le guide complet, avec des exemples
curl, se trouve sur la page API. - La description OpenAPI 3.1 est publique : openapi.json.