Aller au contenu
Passerelle
Mon compte

Installation

Comptez une quinzaine de minutes, de la commande à votre première session Claude sur le téléphone.

Prérequis

  • Un serveur Linux 64 bits (Debian, Ubuntu…) avec Docker et Docker Compose. 4 Go de mémoire conseillés.
  • Un accès SSH avec un utilisateur qui peut lancer Docker.
  • Un abonnement Claude Pro ou Max. La connexion se fait sur votre serveur, avec votre compte.
  • Votre clé de licence, visible dans votre espace client.

Comment vous accéderez à Passerelle

Passerelle donne la main sur votre serveur : il n'est jamais exposé à tout internet. Il rejoint votre réseau privé Tailscale (gratuit pour un usage personnel) et n'est visible que par vos appareils, avec une adresse HTTPS du type https://passerelle.votre-reseau.ts.net. Aucun port à ouvrir, aucun nom de domaine à configurer.

Avant d'installer :

  1. créez un compte sur tailscale.com et installez l'application sur votre téléphone et votre ordinateur ;
  2. dans la console Tailscale, page DNS, activez HTTPS Certificates (une seule fois).

Rien à installer sur le serveur : Tailscale est inclus dans Passerelle.

Installer

Connectez-vous en SSH au serveur, puis lancez la commande avec votre clé :

curl -fsSL https://passerelle.valtiks.fr/install.sh | LICENSE=VOTRE-CLÉ bash

Le script :

  1. vérifie Docker et l'architecture du serveur ;
  2. active la licence auprès de passerelle.valtiks.fr (seuls la clé et un identifiant anonyme du serveur sont envoyés) ;
  3. télécharge l'image Passerelle et démarre le conteneur ;
  4. affiche un lien Tailscale : ouvrez-le, connectez-vous et validez. Passerelle rejoint alors votre réseau ;
  5. affiche l'adresse HTTPS de votre Passerelle.

Vous préférez lire avant d'exécuter ? C'est une bonne habitude : consultez le script.

Première connexion

À la première ouverture, un assistant vous guide :

  1. connexion à Claude avec claude auth login (votre compte, dans votre navigateur) ;
  2. accès GitHub en option, pour cloner vos dépôts privés ;
  3. création ou clonage de votre premier projet.

Ces connexions restent sur votre serveur. Nous ne les voyons jamais.

Sur l'iPhone

Ouvrez Passerelle dans Safari, touchez le bouton Partager puis « Sur l'écran d'accueil ». Passerelle s'ouvre alors en plein écran, comme une application.

Mises à jour

Passerelle vérifie régulièrement s'il existe une nouvelle version et affiche un bandeau avec ses notes. Pour l'appliquer, lancez sur le serveur curl -fsSL https://passerelle.valtiks.fr/install.sh | bash (la clé est déjà enregistrée) : vos projets et vos connexions sont conservés. Toutes les versions sont listées dans les notes de version.

Si notre site est indisponible, rien ne change pour vous : Passerelle continue de fonctionner, seule la vérification des mises à jour attend.

Changer de serveur

Dans votre espace client, révoquez l'ancien serveur, puis lancez la commande d'installation sur le nouveau.

Désinstaller

Sur le serveur :

curl -fsSL https://passerelle.valtiks.fr/uninstall.sh | bash

Le script arrête Passerelle, libère la place de ce serveur sur votre licence et se déconnecte du registre. Vos projets sont conservés dans un volume Docker. Pour tout effacer, ajoutez PURGE=1 devant bash.