Aller au contenu principal

Cloud auto-hébergé

Le forfait Enterprise comprend une édition auto-hébergée : le cloud JodaPrint, le tableau de bord et les versions de l'agent sur votre propre serveur. Les agents, les SDK et les intégrations fonctionnent de la même façon ; il suffit de les diriger vers votre URL.

Installer​

Une seule commande, en root, sur un serveur Ubuntu 24.04 LTS ou Debian 12 neuf vers lequel pointent ses noms DNS :

curl -fsSL https://raw.githubusercontent.com/jodelin93/jodaprint/main/selfhost/install.sh \
| sudo bash -s -- --domain print.example.com --email [email protected] --license /path/license.jwt

Elle installe Node 22, PostgreSQL 16, Redis 7 et Caddy (TLS automatique), crée les services systemd, génère les secrets une seule fois dans /etc/jodaprint/*.env, exécute les migrations de la base de données et crée le premier administrateur. Tout écoute sur localhost, sauf Caddy (ports 80 et 443).

OptionEffet
--domain NAMENom d'hôte de l'API et de la passerelle des agents (obligatoire la première fois)
--dashboard-domain NAMENom d'hôte du tableau de bord (app.<domain> par défaut)
--email ADDRESSContact Let's Encrypt et premier administrateur (obligatoire la première fois)
--license FILEVotre licence auto-hébergée (JWT)
--smtp-url URLsmtp://user:pass@host:587 ; sans cette option, les e-mails vont dans le journal
--open-signupPermet à tout le monde de créer un compte (par défaut : sur invitation seulement)
--demoCrée aussi une organisation de démonstration, un code d'activation et une clé jp_test_
--dry-runAffiche chaque commande au lieu de l'exécuter

Mise à niveau (conserve les secrets et les données, fait d'abord une sauvegarde, revient en arrière si la nouvelle version n'est pas en bonne santé) :

sudo jodaprint-install --upgrade --version v1.4.0

Exploiter​

  • Sauvegardes : backup.sh et restore.sh (installés comme commandes), avec un minuteur de sauvegarde chaque nuit.
  • Versions de l'agent : mirror-releases.sh copie les versions signées de l'agent sur votre serveur, pour que les agents se mettent à jour depuis celui-ci.
  • Fichiers (contenu des travaux, journaux) : ils sont stockés sur le disque local.

Licence​

La licence hors ligne fixe le forfait de chaque organisation et plafonne le nombre d'appareils et d'organisations sur le serveur. Après son expiration, le serveur continue de fonctionner pendant 30 jours de grâce. GET /admin/license indique son état.

Diriger les agents et les SDK vers votre serveur​

ComposantParamètre
MSI WindowsCLOUD_URL=https://print.example.com
Profil macOSCloudURL
Paquets LinuxJODAPRINT_CLOUD_URL
MDM Androidcloud_url
Ligne de commandejodaprint-agent activate <code> --cloud https://print.example.com
SDK Nodenew JodaPrintClient({ apiKey, baseUrl: "https://print.example.com" })
Intégrations« API base URL » dans leurs paramètres

Le SDK navigateur communique avec l'agent local et ne demande aucun changement.

Le guide complet de l'exploitant est docs/self-hosted.md dans le dépôt JodaPrint.