Documentation
Tout ce qu'il faut pour mettre une application en ligne sur MasoloCloud. Mise à jour le 6 novembre 2026.
En 5 minutes
- Créez un compte sur rdc.masolo.cloud.
- Rechargez votre solde dans Paiements (voir plus bas).
- Cliquez sur Nouvelle application : choisissez un nom, une région, une formule, puis la source (dépôt GitHub ou image Docker) et le port.
- Attendez que l'état passe à En ligne, en général une à trois minutes.
- Votre application répond sur
https://<nom>.masolo.cloud, avec un certificat HTTPS déjà en place.
Le nom devient l'adresse : 3 à 63 caractères, lettres minuscules, chiffres et tirets. Exemple : boutique-api donne https://boutique-api.masolo.cloud.
Recharger son solde
MasoloCloud est prépayé, en dollars. Vous rechargez par Mobile Money (M-Pesa, Orange Money, Airtel Money, Afrimoney) ou par carte Visa et Mastercard, de 1 $ à 1 000 $ par recharge. Pour lancer une application, le solde doit couvrir au moins 24 heures de fonctionnement.
Les recharges ouvrent très bientôt. En attendant, les comptes d'essai sont activés à la main : écrivez-nous.
Depuis GitHub
Donnez l'adresse d'un dépôt public et sa branche (main par défaut). MasoloCloud reconnaît le langage tout seul (Node.js, Python, PHP, Go, Ruby, Java, Rust, entre autres), installe les dépendances, construit puis lance l'application.
- Le dépôt doit contenir le fichier de dépendances habituel du langage :
package.json,requirements.txt,go.mod,composer.json… - La commande de démarrage doit être claire : le script
startdepackage.json, ou un fichierProcfileavec une ligneweb:. - Un
Dockerfiledans le dépôt n'est pas utilisé par ce mode. Si votre projet en a besoin, construisez l'image et suivez la section suivante.
Dépôts privés bientôt
Depuis une image Docker
Donnez le nom complet d'une image publique, avec son étiquette : nginx:1.27-alpine, ghcr.io/votre-compte/votre-appli:1.4.0. Sans étiquette, latest est utilisé.
# construire et publier votre image (exemple GitHub Container Registry)
docker build -t ghcr.io/votre-compte/votre-appli:1.0.0 .
docker push ghcr.io/votre-compte/votre-appli:1.0.0
Préférez une étiquette précise (1.0.0) à latest : vous savez toujours quelle version tourne.
Le port
Votre application doit écouter sur 0.0.0.0 (pas 127.0.0.1) et sur le port indiqué dans le formulaire, 3000 par défaut. MasoloCloud reçoit le trafic HTTPS et le transmet en HTTP simple à ce port : vous n'avez pas à gérer de certificat.
Cause n° 1 d'une application qui reste en erreur : elle écoute sur un autre port que celui du formulaire, ou seulement sur localhost.
Exemples par langage
Node.js (Express)
// server.js
const express = require("express");
const app = express();
app.get("/", (req, res) => res.send("Mbote depuis MasoloCloud !"));
app.listen(3000, "0.0.0.0");
// package.json (extrait)
"scripts": { "start": "node server.js" }
Python (FastAPI)
# requirements.txt
fastapi
uvicorn
# Procfile
web: uvicorn main:app --host 0.0.0.0 --port 3000
Site statique (HTML, React compilé…)
Le plus simple : une image nginx qui contient vos fichiers, port 80 dans le formulaire.
# Dockerfile
FROM nginx:1.27-alpine
COPY dist/ /usr/share/nginx/html/
Mettre à jour
Après un git push ou la publication d'une nouvelle image, ouvrez l'application dans le tableau de bord et cliquez sur Redéployer. La nouvelle version remplace l'ancienne une fois prête.
Redéploiement automatique à chaque git push bientôt
Formules et régions
| Formule | Mémoire | Processeur | Prix (USD / mois) | Pour |
|---|---|---|---|---|
| Mini | 256 Mo | 0,5 vCPU | 5 | site vitrine, petite API |
| Standard | 512 Mo | 1 vCPU | 8 | application web courante |
| Pro | 1 Go | 1 vCPU | 15 | API chargée, Java, plusieurs processus |
| Plus | 2 Go | 2 vCPU | 28 | gros trafic (pas encore à Johannesburg) |
Région ouverte : Johannesburg. Kinshasa, Francfort, Ashburn et Singapour arrivent. Pour choisir, mesurez le temps de réponse depuis chez vos utilisateurs sur mesure.masolo.cloud.
Une application qui dépasse la mémoire de sa formule est redémarrée. Si cela se répète, passez à la formule du dessus.
Facturation à l'heure
- Une heure coûte le prix mensuel divisé par 730. Une application Standard coûte environ 1,1 centime de l'heure.
- Une application arrêtée ne coûte rien. Arrêtez celles qui ne servent pas.
- À la suppression, l'heure commencée est due.
- Si le solde passe sous zéro, vous avez 48 heures pour recharger. Ensuite, les applications sont arrêtées, sans être effacées : elles repartent après la recharge.
Le détail est dans les conditions d'utilisation.
Ce qui arrive bientôt
MasoloCloud vient d'ouvrir. Voici ce qui n'est pas encore disponible, pour que vous puissiez vous organiser :
- Variables d'environnement (clés d'API, adresse de base de données) bientôt
- Journaux de l'application dans le tableau de bord bientôt
- Bases de données gérées (PostgreSQL, MySQL, Redis) bientôt
- Domaine personnel (
www.votre-entreprise.cd) bientôt - Stockage permanent : aujourd'hui, les fichiers écrits par l'application sont perdus à chaque redéploiement. Gardez vos données dans un service externe. bientôt
MasoloCloud ne sauvegarde pas le contenu de vos applications. Gardez toujours votre code et vos données ailleurs.
Dépannage
L'application reste « En création »
La première construction depuis GitHub peut prendre quelques minutes. Au-delà de 10 minutes, cliquez sur Redéployer, puis écrivez-nous si rien ne change.
L'application passe « En erreur »
Vérifiez le port, la commande de démarrage et le fichier de dépendances. Lancez l'application sur votre machine avec la même commande : elle doit répondre sur http://localhost:<port>.
« La formule n'est pas encore proposée »
Cette formule ne tient pas encore sur les serveurs de la région choisie. Prenez la formule du dessous ou une autre région.
« Solde insuffisant »
Le solde doit couvrir 24 heures de fonctionnement pour lancer ou relancer une application. Rechargez dans Paiements.
Aide
Une question, un blocage ? Écrivez-nous, nous répondons en français.
- WhatsApp : +1 303 507 9022
- E-mail : [email protected]