Accueil/Documentation

Documentation Technique

Guide complet de référence pour concevoir, compiler, isoler et exécuter des applications autonomes au format .box.

Démarrage Rapide

Box regroupe votre code applicatif, son runtime et ses dépendances dans un fichier unique .box prêt à être exécuté sans installation préalable sur la machine cible.

Pourquoi utiliser le format Box ?

Le format Box permet de packager des applications Python et Node.js en archives autonomes scellées. L'objectif est de distribuer et faire tourner des projets sans avoir à configurer d'environnements virtuels, sans installer de paquets système et sans conflits de versions sur l'hôte.

Créer et exécuter votre première Box en 4 étapes

1Installer le CLI Box

Téléchargez et installez le binaire officiel sur votre système d'exploitation.

$ curl -fsSL https://boxhub.paxiz.org/install.sh | bash

2Définir la configuration boxconfig.yml

Créez un fichier déclaratif minimal boxconfig.yml spécifiant le runtime, la version, le fichier d'entrée et les dépendances.

3Compiler le paquet avec box build

Lancez la compilation pour résoudre les dépendances, calculer les signatures SHA-256 et générer l'archive mon-application.box.

$ box build .

4Exécuter l'application avec box run

Démarrez l'archive dans un environnement sandbox isolé.

$ box run mon-application.box