Installer sur un serveur

Qubix s'exécute sur votre propre serveur — une seule commande d'installation démarre toute la pile (base de données, backend, serveur web, services auxiliaires). Vous n'avez besoin que d'un serveur Linux vierge avec accès SSH et Docker.

Prérequis serveur

L'installateur vérifie le serveur avant de démarrer et refuse de continuer sur une machine manifestement trop petite. Le minimum recommandé :

Ressource	Minimum recommandé
CPU	4 vCPU
RAM	8 Go
Disque	20 Go SSD ou HDD

Ce sont les valeurs que l'installateur recommande ; en dessous, il fonctionne tout de même mais avertit que ClickHouse sera lent lors des journées chargées. Il existe un seuil dur de 10 Go d'espace disque libre — en dessous, l'installation s'arrête.

Le type de disque n'a aucune importance pour la diffusion du trafic — SSD et HDD fonctionnent tous les deux, et le HDD permet d'économiser ; le SSD n'accélère que les rapports d'administration à grands volumes. 20 Go sont largement suffisants pour démarrer : cela contient la plateforme plus des milliers de créatifs, et l'historique du trafic ne pèse presque rien. Pour savoir précisément quel trafic et combien de créatifs un disque donné peut contenir, consultez Choisir son serveur.

Quelques prérequis absolus :

• Un serveur Linux 64 bits (un VPS/VDS ou une machine dédiée), pas un ordinateur personnel ni un hébergement mutualisé.
• Docker avec le plugin docker compose (V2). L'ancien docker-compose autonome (V1) n'est pas pris en charge — l'installateur le détecte et s'arrête.
• HTTPS sortant pour que le serveur puisse télécharger les images Qubix.

Un serveur dédié

Installez Qubix sur un serveur qui lui est entièrement dédié. La pile nécessite que les ports 80, 443 (et 8443 pour l'option Cloudflare) soient libres. Si un autre serveur web les occupe déjà, libérez-les d'abord ou choisissez l'option Cloudflare plus loin dans l'assistant.

Installation

1. Connectez-vous au serveur en SSH en tant que root.

2. Exécutez la commande d'installation :

   Bash

   curl -sSL https://qubix.pro/install.sh | bash

   (ou wget -qO- https://qubix.pro/install.sh | bash)

   

3. L'installateur affiche la bannière Qubix, vérifie le serveur, pose quelques questions (dossier d'installation, interface réseau à exposer), puis télécharge et démarre la pile. Attendez qu'il indique que tout est opérationnel.

Ne pas interrompre

Laissez l'installateur se terminer. L'arrêter en cours d'exécution peut laisser une pile partiellement configurée — si cela se produit, la solution la plus sûre est de supprimer le dossier d'installation et de relancer la commande sur un serveur vierge.

Ce que vous obtenez

L'installateur démarre un petit ensemble de conteneurs qui constituent Qubix : la base de données analytique, le backend Qubix, le serveur web, ainsi que les services de mise à jour automatique, de certificats et d'IA. Vous n'avez pas à les gérer manuellement — Qubix les pilote pour vous.

Finaliser la configuration dans le navigateur

Lorsque la pile est opérationnelle, l'installateur affiche un lien du type :

http://<adresse-ip-de-votre-serveur>:7000/install?k=…

Ouvrez ce lien complet dans un navigateur (la clé ?k=… est obligatoire). Il ouvre l'assistant de configuration, où vous choisissez comment Qubix sera accessible, saisissez votre licence et créez le premier administrateur.

Le lien ne fonctionne qu'une fois

L'assistant de configuration n'est accessible que jusqu'à ce que vous l'ayez terminé. Une fois le premier administrateur créé, le lien cesse de fonctionner — c'est le comportement attendu. À partir de ce moment, vous vous connectez à l'adresse propre de votre panneau.

Et ensuite

Créer un administrateur

Suivre l'assistant de configuration : adresse, licence, administrateur.

Présentation de l'interface

Organisation du panneau d'administration.