Démarrage rapide

PNeX s'installe en une seule commande sur un Raspberry Pi (4 ou 5, OS 64 bits) ou sur n'importe quelle machine Debian / Ubuntu (amd64 ou arm64). L'installeur ajoute Docker si besoin, génère tous les secrets, met en place le TLS partout et démarre la pile.

PrérequisCopy Anchor Link

InstallerCopy Anchor Link

Cette page couvre l'installeur en une commande. Windows (WSL 2), Kubernetes et les autres cibles sont dans Installation.

Sur votre réseau local (servi sur https://<hostname>.local avec une autorité de certification privée générée sur le serveur) :

curl -fsSL https://raw.githubusercontent.com/Pnex/pnex-deploy/main/install.sh \
  | sudo bash -s -- --admin-user [email protected] --admin-password 'choose-a-strong-one'

Sur un serveur public avec un certificat Let's Encrypt (nécessite un nom DNS public et les ports 80/443 ouverts, plus 4443 pour les appareils) :

curl -fsSL https://raw.githubusercontent.com/Pnex/pnex-deploy/main/install.sh \
  | sudo bash -s -- --domain pnex.example.com --tls cloud \
      --acme-email [email protected] \
      --admin-user [email protected] --admin-password 'choose-a-strong-one'

Ajoutez --storage s3 pour ranger les fichiers sur le RustFS fourni (recommandé : le stockage sur volume local est en voie de retrait). Toutes les autres options (--profile raspi|server, SMTP, ports…) sont facultatives ; voir le README de pnex-deploy ou install.sh --help.

Faire confiance au serveurCopy Anchor Link

En mode TLS local, chaque appareil client fait confiance une fois à l'autorité de certification du serveur. Sur Ubuntu, une commande s'en charge (ainsi que l'accès série USB utilisé pour le flash depuis le navigateur) :

curl -fsSL https://raw.githubusercontent.com/Pnex/pnex-deploy/main/client/setup-ubuntu.sh \
  | bash -s -- --server pnex.local

Les autres systèmes téléchargent la CA sur https://<serveur>/api/v1/meta/ca ; le README de pnex-deploy détaille Windows, macOS et Android.

Première connexionCopy Anchor Link

Ouvrez PNeX dans un navigateur, ou dans l'une des apps natives, et connectez-vous avec le compte admin. La première connexion provisionne automatiquement votre profil et une organisation personnelle.

Tous les clients sont construits depuis le même code Rust et parlent au même serveur. Les apps natives sont reconstruites à chaque build vert de pnex-rs et publiées sur sa release nightly (les liens ci-dessus) ; chaque version publiée (0.1.0-beta.1 … beta.8, puis 0.2.0-beta.1 et beta.2 ; la version de fin d'année sera plutôt une 0.3.0) a sa propre release sur la page des releases, à associer à un serveur installé avec --version ; vérifiez les téléchargements avec SHA256SUMS. Le build Windows est vérifié au démarrage sur une vraie machine Windows mais n'a pas encore servi au quotidien ; l'APK Android est signé en debug (sideload uniquement) en attendant la diffusion en store.

ExploiterCopy Anchor Link

sudo pnexctl status     # conteneurs, versions, santé des endpoints, expiration du certificat
sudo pnexctl upgrade    # dernière recette et images, secrets conservés
sudo pnexctl upgrade --version 0.1.0-beta.7   # passer à une release donnée
sudo pnexctl backup     # pg_dump + .env + CA dans /var/backups/pnex/

Relancer l'installeur met à jour sur place ; les migrations de base s'appliquent au démarrage du serveur.

Pour continuerCopy Anchor Link

• Enregistrez votre premier appareil depuis Devices › Catalogue d’appareils et flashez-le depuis le navigateur.
• Câblez un premier flow dans Automatisation › Flows.
• Regardez les données arriver dans Surveiller › Graphiques rapides, puis montez un tableau de bord dans Surveiller › Tableaux de bord.

Consultez Architecture pour comprendre comment les pièces s'emboîtent. Les contributeurs lancent la pile de développement depuis le dépôt pnex-rs.