Docs

Installation et mises à jour

Orbitra est optimisé pour un démarrage rapide sans configuration complexe de l'environnement. Il repose sur une stack légère PHP + SQLite + Nginx — pas de serveur de base de données séparé (ni ClickHouse, ni Redis, ni MySQL).

Configuration requise

Orbitra stocke tout dans un unique fichier SQLite, il a donc besoin de nettement moins de RAM que les trackers basés sur ClickHouse et tourne sur les plans VPS les moins chers.

Base (requis) :

Dimensionnement selon le volume de trafic (à titre indicatif) :

Clics par jourRAMCPUDisque
jusqu'à ~100 0001–2 Go1–2 vCPU20 Go SSD
~100 000 – 500 0002–4 Go2 vCPU40 Go SSD
~500 000 – 1 000 0004–8 Go4 vCPU80 Go SSD

✅ Vérifié en pratique : Orbitra tourne de manière stable sur un VPS 2 vCPU / 2 Go de RAM / 20 Go SSD (Ubuntu 24.04) avec un trafic léger — un point de départ pratique et peu coûteux. Les lignes hautes du tableau sont de la marge pour un trafic plus élevé, pas une exigence stricte.

💡 Pourquoi moins que Keitaro ? Keitaro stocke les clics dans ClickHouse + Redis + MySQL, ses besoins en RAM montent donc jusqu'à 64 Go à des millions de clics par jour. Dans Orbitra, tout vit dans un unique fichier SQLite — le goulot d'étranglement n'est pas la RAM mais l'I/O disque et les écritures mono-thread de SQLite. Pour les volumes faibles et moyens (en mode WAL), cela suffit ; pour des millions de clics par jour soutenus avec de l'analytique lourde, un tracker à base de base columnaire (comme Keitaro) est architecturalement mieux adapté.

💡 Lors d'une installation sur un serveur de 1 Go de RAM, ajoutez 1–2 Go de swap : la construction du frontend (Vite) est l'étape la plus gourmande en mémoire. Le tracker lui-même tourne très bien avec 1 Go.

Installation automatique rapide (production)

Le moyen le plus rapide et le plus propre de lancer le projet sur un serveur est l'installateur intégré.

  1. Assurez-vous d'avoir un serveur Linux « propre » (Ubuntu 22.04+ ou Debian 12+).
  2. Lancez la commande en root/sudo :
   wget -O orbitra-install.sh https://raw.githubusercontent.com/fenjo26/Orbitra.link/main/install.sh && bash orbitra-install.sh

Le téléchargement est une étape séparée à dessein : avec wget -qO- … | bash, un téléchargement raté envoie silencieusement du vide dans bash, et l'installation « se termine » sans une seule ligne de sortie. Ainsi, elle s'arrête au &&, et wget signale la raison.

  1. Le script installe Nginx, un PHP à jour (8.5, avec repli sur 8.4 depuis le dépôt Ondřej Surý ; si celui-ci est indisponible aussi — celui de la distribution), SQLite, télécharge le code du frontend et met en place les certificats HTTPS.

Première connexion : il n'y a pas de compte « par défaut ». Après l'installation, ouvrez http://<your-domain>/admin.php — au premier lancement, Orbitra démarre l'assistant de configuration initiale, où vous créez votre propre administrateur (login ≥ 3 caractères, mot de passe ≥ 8 caractères, fuseau horaire et langue).

Accès au panneau par IP

Le panneau est toujours accessible à l'adresse du serveur — http://<ip>/admin.php — quel que soit le nombre de domaines liés et lequel vous supprimez ensuite. C'est le rôle d'un bloc catch-all qu'Orbitra place en premier dans la config Nginx ; les certificats sont émis via certbot certonly --webroot, donc Certbot ne réécrit pas la config.

https://<ip>/admin.php fonctionne aussi, mais avec un avertissement navigateur : Let's Encrypt n'émet pas de certificats pour des IP nues, donc un auto-signé est utilisé.

Si le panneau cessait quand même de répondre — par exemple, la config Nginx a été éditée à la main — reconstruisez-la depuis la base de données :

sudo php /var/www/orbitra/cli/nginx_sync.php

La commande répare aussi les configs de renouvellement Certbot héritées de l'ancienne méthode d'émission et génère un certificat auto-signé. Après une mise à jour depuis une version inférieure à 0.9.6.4, exécutez-la une fois.

Ce que l'installateur met en place

Non installé automatiquement : le nettoyage par rétention (cli/cleanup_cron.php, voir Administration), le moniteur de postbacks et les vérifications d'URL de source.

Relancer l'installateur sur un serveur en production est sans risque : il met à jour PHP, les configs et les crons sans toucher aux données.

Les réglages de sécurité du panneau après installation — chemin de panneau personnalisé, accès par IP, connexion à deux facteurs — sont couverts dans Administration.

Mise à jour de PHP

Alerte sécurité : CVE-2026-109618 / CVE-2026-109619 (octobre 2026)

Deux vulnérabilités RCE critiques non authentifiées dans PHP lui-même (« php2shell », CVSS v4.0 9.2, exploit public) ont été corrigées en amont le 2026-10-21. Versions corrigées : 8.5.12, 8.4.27, 8.3.36, 8.2.35. Un tracker est une application PHP exposée sur Internet, donc chaque interpréteur exposé au web doit être patché. Le panneau affiche un bandeau rouge sur le dashboard tant que le PHP en cours ne rapporte pas l'une de ces versions (ou plus récente).

Mise à niveau de routine

Ubuntu 22.04 / Debian 12 / Ubuntu 24.04 livrent PHP 8.1 / 8.2 / 8.3 en standard — ces versions ne reçoivent plus de mises à jour de sécurité (8.1 et 8.2 sont EOL ; 8.3 ne reçoit que des correctifs de sécurité jusqu'à fin 2027). Orbitra v1.5.10 tourne sur toutes, mais une installation neuve ou une mise à niveau de serveur devrait partir de PHP 8.4+.

Le chemin le plus simple est de relancer l'installateur (il est idempotent et supporte la mise à niveau par-dessus une installation existante) :

sudo bash /var/www/orbitra/install.sh

L'installateur ajoute le dépôt des builds PHP à jour (ondrej/php sur Ubuntu, packages.sury.org sur Debian), installe PHP 8.5 (avec repli sur 8.4) à côté de l'ancien, bascule l'alternative php du CLI (utilisée par les crons et Composer), réécrit la config Nginx vers le nouveau socket FPM, applique les réglages du pool et redémarre les services. L'ancienne version de PHP reste installée mais cesse de servir le trafic ; vous pouvez la retirer après vérification, si vous voulez.

Manuel (Ubuntu) :

sudo add-apt-repository -y ppa:ondrej/php && sudo apt-get update
sudo apt-get install -y php8.5-fpm php8.5-cli php8.5-sqlite3 php8.5-curl php8.5-mbstring php8.5-xml php8.5-zip php8.5-intl php8.5-bcmath
sudo update-alternatives --set php /usr/bin/php8.5
sudo bash /var/www/orbitra/install.sh   # switches nginx/FPM/crons to the new version

Manuel (Debian) :

. /etc/os-release
curl -fsSL https://packages.sury.org/php/apt.gpg | sudo gpg --dearmor --yes -o /usr/share/keyrings/deb.sury.org-php.gpg
echo "deb [signed-by=/usr/share/keyrings/deb.sury.org-php.gpg] https://packages.sury.org/php/ ${VERSION_CODENAME} main" | sudo tee /etc/apt/sources.list.d/php-sury.list
sudo apt-get update
sudo apt-get install -y php8.5-fpm php8.5-cli php8.5-sqlite3 php8.5-curl php8.5-mbstring php8.5-xml php8.5-zip php8.5-intl php8.5-bcmath
sudo update-alternatives --set php /usr/bin/php8.5
sudo bash /var/www/orbitra/install.sh

Après la mise à jour, vérifiez : php -v affiche 8.4/8.5, le panneau s'ouvre, Logs → System log ne contient aucune entrée postback.php database error, et le ping du worker dans les réglages de la file des postbacks est récent. Lors d'une mise à jour via le bouton, le panneau vous avertira de lui-même si le serveur reste sur PHP < 8.4.

Étape serveur unique après mise à jour (1.6.0+)

Le bouton « Update » du panneau s'exécute comme l'utilisateur web et ne peut pas modifier sudoers. Les serveurs installés avant 1.6.0 ont besoin d'une seule exécution de cli/server_setup.sh en root après la mise à jour — le panneau affichera un bandeau avec la commande :

curl -fsSL https://raw.githubusercontent.com/fenjo26/Orbitra.link/v1.6.0/cli/server_setup.sh | sudo ORBITRA_REF=v1.6.0 bash

Le script est téléchargé depuis le tag de release, pas depuis /var/www/orbitra (ce répertoire appartient à l'utilisateur web, et root ne doit pas exécuter des fichiers que l'utilisateur web peut réécrire). Il remplace les anciennes règles sudo (certbot avec tous arguments, et cp vers sites-available — chacune pouvait permettre à l'utilisateur web d'obtenir root) par des helpers qui valident les arguments, installe le cron de la file des clics et écrit la version dans /etc/orbitra/server-setup-version. Le relancer est sans risque. install.sh appelle le même script, donc les nouvelles installations obtiennent la même chose.

Après la mise à jour vers 1.8.4 : durcissement nginx (avis d'octobre 2026)

Rien à exécuter sur le serveur : la mise à jour elle-même régénère le vhost nginx sans la directive alias et recharge nginx (par le même chemin vérifié qu'utilise l'enregistrement d'un domaine). Il reste la moitié système d'exploitation des avis d'octobre 2026 — le paquet nginx lui-même (noté jusqu'à CVSS 9.2), le kernel et le magasin de confiance des CA — que seul l'opérateur peut mettre à jour :

apt update && NEEDRESTART_MODE=a apt upgrade -y   # Debian/Ubuntu; dnf upgrade on the RHEL family
systemctl reload nginx
reboot                                             # loads the fixed kernel
nginx -v                                           # fixed: 1.31.7+ mainline / 1.30.6+ stable

Les builds de distribution peuvent rétroporter le correctif sans changer la version — vérifiez avec apt changelog nginx. Le dashboard affiche un bandeau ignorable tant que le nginx en cours ne rapporte pas une version corrigée (quand un shell est disponible pour le lire). Le tracker n'est pas concerné par les items PostgreSQL / Redis / Node.js du même digest : il tourne en PHP + SQLite et n'embarque aucun Node.js sur le serveur.

Après la mise à jour vers 1.8.3 : session recordings pour des sites entiers

Rien à exécuter sur le serveur. La mise à jour ajoute les session recordings au niveau campagne avec le collage de visites One click per visit et le mode consentement, le tout désactivé par défaut — statistiques de clics et recordings ne changent que là où vous les activez vous-même. Aucun cron à ajouter : le nettoyage continue de profiter des recordings entrants.

Après la mise à jour vers 1.8.2 : browser check

Rien à exécuter sur le serveur. La mise à jour ajoute le browser check mais le laisse désactivé sur une installation existante, pour que le routage ne change pas tout seul. Les admins voient un bandeau unique sur le dashboard : Turn on soft mode l'active, Learn more ouvre Settings → Bots, Not now masque le bandeau (le mode se change à tout moment dans Settings → Bots). Une installation neuve démarre en mode soft.

Intégrité des mises à jour

Développement local (React & serveur PHP)

Si vous comptez modifier le code source du frontend (React) et la partie visuelle du tracker, il vous faut un environnement local PHP + Vite.

Partie 1 : démarrer l'API backend

Ouvrez un premier terminal et démarrez le serveur PHP intégré avec le routeur :

cd Orbitra
php -S localhost:8080 router.php

Ce serveur gérera les requêtes API et les redirections.

Partie 2 : démarrer le frontend (Vite)

Ouvrez un second terminal, installez les paquets npm et démarrez le serveur de dev :

cd Orbitra/frontend
npm install
npm run dev

Ouvrez ensuite http://localhost:5173 dans votre navigateur. Toutes les requêtes API du frontend sont automatiquement proxifiées (via le proxy vite.config.js) vers http://localhost:8080/api.php, ce qui évite les problèmes de CORS et de session en mode développement.

Construire le panneau

Nécessaire seulement si vous modifiez le code du panneau :

cd Orbitra/frontend
npm run build

Le build atterrit dans frontend/dist/, qui est commité dans le dépôt — le serveur récupère le panneau tout fait via git pull ou une mise à jour depuis le panneau et ne construit rien lui-même.

Bot Telegram

Connexion et modes de fonctionnement — Bot Telegram.

← Précédent
Démarrage rapide : votre première campagne
Suivant →
Migrer depuis Keitaro
Voir la source sur GitHub: github.com/fenjo26/Orbitra.link/wiki
Tous les guides
Docs

Démarrage rapide : votre première campagne

Le chemin court : installez le tracker, créez une campagne et obtenez vos premiers clics et conversions en moins d'une heure.

Lire le guide →
Docs

Installation et mises à jour

Installez Orbitra sur un serveur Ubuntu ou Debian tout neuf en une commande, et passez aux nouvelles versions sans risque.

Lire le guide →
Docs

Migrer depuis Keitaro

Déplacez campagnes, offres, sources et domaines de Keitaro vers Orbitra : ce qui est transféré et quoi vérifier après l'import.

Lire le guide →
Docs

Migrer depuis Binom

Déplacez campagnes et streams de Binom vers Orbitra via l'API publique v2 : ce qui est transféré automatiquement et quoi régler à la main.

Lire le guide →
Docs

Aperçu des fonctionnalités

Tout ce qu'Orbitra sait faire : campaigns et streams, cloaking, landings, PWA, postbacks, coûts, rapports et intégrations.

Lire le guide →
Docs

Campaigns et streams

La référence complète : réglages de campagne, types de streams, schémas, rotation, filtres, test links et chaque option expliquée.

Lire le guide →
Docs

Cloaking

La référence complète du cloaking : couches de détection, réglages globaux, filtres par stream, verdicts et rapports.

Lire le guide →
Docs

Browser check

Comment la vérification JS attrape bots, VM et émulateurs à travers les contradictions de l'environnement du navigateur.

Lire le guide →
Docs

Landing pages

Types de landings, la macro {offer}, l'adaptateur JS, LeadForge et les landings multi-offres — la référence complète.

Lire le guide →
Docs

PWA et Web Push

Construisez des apps PWA installables et collectez des abonnés push : réglages, icônes, événements et notifications.

Lire le guide →
Docs

Funnel de visite PWA

Le funnel configurable des landings PWA : étapes ordonnées, store, instructions et carte push, tracking par écran, statistiques de transitions et éditeur.

Lire le guide →
Docs

Popups de conversion

Un popup avec bouton d'offre sur vos landings : templates par vertical, déclencheurs, designs, une vraie étape du funnel et les métriques Popup CTR.

Lire le guide →
Docs

Enregistrements de session

Replay des visites façon vidéo, heatmap de clics et carte de scroll : activation, sites entiers, consentement cookies, stockage et dépannage.

Lire le guide →
Docs

Content Gallery : référence complète

La médiathèque partagée du tracker : dossiers, uploads, limites de formats, MediaPicker et contrat de taille dans les éditeurs PWA, landing et offre.

Lire le guide →
Docs

Bibliothèque de créas

L'onglet Creatives de la galerie : sync Facebook/TikTok, dépense et ROI par créa, rattachement des brouillons, alertes burnout et rapports.

Lire le guide →
Docs

PWA externes et chaînes Telegram

Builders PWA tiers comme cibles de stream avec installs et postbacks attribués, et offres chaîne Telegram via funnel bots avec conversions tg_join.

Lire le guide →
Docs

Postbacks et conversions

Postbacks entrants, types de conversion et devises, postbacks S2S sortants, macros, file de livraison, testeur, import et Conversions API.

Lire le guide →
Docs

Coûts : import de la dépense

Import de la dépense Facebook, TikTok, Google Ads et réseaux push/pop : matching par IDs, diagnostics, agences, métriques plateforme et agrégateur de revenus.

Lire le guide →
Docs

Réseaux push et pop

Import de dépense AdMaven, PropellerAds, Kadam et autres, et le Zone Killer : règles dry-run/auto pour bloquer les zones qui brûlent de l'argent.

Lire le guide →
Docs

Facebook / Meta

Les deux intégrations Facebook : import de coûts avec mapping des paramètres, et Conversions API avec matching navigateur, consentement et dépannage.

Lire le guide →
Docs

Dolphin / Fbtool

Recevoir les coûts Facebook de Dolphin et Fbtool.pro sur l'endpoint compatible Keitaro : clé API, matching par adset/ad et répartition de la dépense sur les clics.

Lire le guide →
Docs

Nettoyage des commentaires FB

Modération planifiée des commentaires spam sous vos pubs Facebook : dry-run, stop words, regexes admin, whitelist, journal et restauration en un clic.

Lire le guide →
Docs

Sources de trafic et réseaux d'affiliation

Les deux annuaires du funnel : templates de sources avec paramètres et macros, postback vers la source, réseaux d'affiliation et paramètres d'offre.

Lire le guide →
Docs

Rapports, logs et métriques

Dashboard, liste des campagnes, rapport à dimensions, tendances et cohortes, journal du trafic, carte du clic et le détail du calcul de chaque métrique.

Lire le guide →
Docs

Domaines et SSL

Ajouter des domaines, réglages par domaine, certificats Let's Encrypt et Cloudflare, registrars connectés et surveillance Backorder.

Lire le guide →
Docs

Cloudflare

Connecter Cloudflare via l'API : parking DNS automatique, proxy orange, modes SSL de zone, import des zones et réécriture des enregistrements A.

Lire le guide →
Docs

Administration

Utilisateurs, rôles et permissions, clés API, réglages du tracker, bases geo, mises à jour et menu ⚙ : archive, statuts, logs et extension Ads Manager.

Lire le guide →
Docs

Bot Telegram

Statistiques, conversions et digest quotidien dans Telegram : connexion par token, webhook ou polling, commandes, notifications et alertes vers les chaînes.

Lire le guide →
Docs

MCP : un assistant IA dans le tracker

Connecter Claude Desktop ou tout client MCP à Orbitra via le serveur MCP : clés API, options de connexion et les 41 tools disponibles.

Lire le guide →