Cercle · serveur

Installer Cercle chez un client

Le client a son propre Raspberry Pi (Raspberry Pi OS ou Debian, neuf). Un seul script installe le serveur Cercle dessus, sans rien de privé : base vide et nouvelle clé de chiffrement créée sur son Pi.

  1. Copier le dossier « serveur » sur le Pi

    Depuis le PC, dans PowerShell. Remplace pi@ADRESSE-DU-PI par le compte et l'adresse du Pi du client.

    scp -r C:\Projets\cercle\serveur pi@ADRESSE-DU-PI:~/cercle-serveur

  2. Lancer le script sur le Pi

    Choisis une de ces façons de mettre le serveur sur internet :

    Le plus simple

    Tailscale Funnel

    Gratuit, rien à régler sur la box. Il faut un compte sur tailscale.com.

    sudo bash ~/cercle-serveur/installer-cercle.sh --tailscale

    Ouvre les liens affichés : d'abord la connexion à Tailscale, puis l'autorisation de Funnel. Adresse obtenue : https://nom-du-pi.reseau.ts.net

    Avec son nom de domaine

    Nom de domaine + HTTPS

    Avant : un enregistrement A vers l'adresse IP de la box, et les ports 80 et 443 de la box redirigés vers le Pi.

    sudo bash ~/cercle-serveur/installer-cercle.sh --domaine cercle.exemple.fr

    Caddy s'installe et obtient le certificat HTTPS tout seul.

    Sans option, le script installe seulement et explique à la fin comment publier. Avec --adresse https://…, il prend une adresse déjà publiée autrement.

  3. Relier l'app

    À la fin, le script affiche l'adresse de la page /relier. Ouvre-la sur un ordinateur et scanne son code QR avec l'appareil photo du téléphone où Cercle est installé.

    Ou dans l'app : « Créer un cercle », puis « Mon propre serveur », et tape l'adresse.

    Les proches rejoignent ensuite avec le code du cercle : il contient déjà l'adresse du serveur.

Garde une copie de la clé /var/lib/cercle/cle-messages.key ailleurs que sur le Pi (clé USB, PC). Sans elle, les messages sauvegardés ne peuvent plus être relus. Pour l'afficher : sudo base64 /var/lib/cercle/cle-messages.key

Ce que le script installe

/opt/cercleLe programme (server.py, app web, polices, pages)
/var/lib/cercleLes données : base, clé de chiffrement, sauvegardes
/etc/cercle/cercle.envLes réglages (adresse publique, caméras IP)
cercle-apiCompte et service du serveur, dans un bac à sable : il ne peut joindre aucun appareil du réseau local
cercle-sauvegardeSauvegarde chaque nuit à 4 h, gardée 30 jours

À savoir