FluxCloud Deployment Guide

Deploy apps via Docker or Git CI/CD, manage instances, marketplace templates, and pricing model.

15 min read

fluxclouddeploymentdockercicd

FluxCloud — Complete Deployment Guide

FluxCloud is the consumer-facing deployment interface for the Flux decentralized cloud. It allows anyone to deploy Docker-based applications across the global Flux network — spanning 75+ countries and 25,000+ running applications. Think of it as the "AWS Console" of the Flux ecosystem.

Deployment Methods

FluxCloud supports two deployment methods: Docker image (for pre-built containers) and Git-based CI/CD (for source code deployments).

Method 1: Deploy with Docker Image

1
Details tab
Enter your app name, description, and select the Docker image from Docker Hub or a private registry (v7+ supports private images).
2
Component tab
Configure container settings: exposed ports, environment variables, commands, resource allocation (CPU, RAM, HDD), and the number of instances (minimum 3, or 1 for v8+ enterprise).
3
Enterprise Nodes (optional)
For v8 specs, you can target ArcaneOS enterprise nodes specifically. This provides dedicated resources and enhanced security.
4
Geolocation tab
Select geographic regions where your app should run. Options include specific continents, countries, or "any" for global distribution.
5
Validate & Pay
Review the total cost (calculated in FLUX and USD equivalent), then sign the deployment transaction with your wallet.

Method 2: Deploy with Git (CI/CD)

Git-based deployments use the Orbit Docker image (`runonflux/orbit:latest`) to automatically build and deploy from your repository. This enables full CI/CD pipelines with GitHub or GitLab.

Environment Variable	Description	Required
GIT_REPO_URL	Your Git repository URL (HTTPS)	Yes
APP_PORT	Port your app listens on	Yes
WEBHOOK_SECRET	Secret for push webhook verification	Yes
GIT_TOKEN	Personal access token for private repos	If private

Set up a webhook in your GitHub/GitLab repository pointing to your Flux app URL. Every push to the configured branch will trigger an automatic rebuild and redeploy.

Managing Deployed Apps

The FluxCloud dashboard provides comprehensive management tools for each app:

•Specifications: View the app spec (CPU, RAM, HDD, ports, environment)
•Monitoring: Real-time resource usage graphs (CPU, memory, network I/O)
•Log Files: Stream container logs in real-time
•Interactive Terminal: Execute commands inside running containers
•Volume Browser: Browse, upload, and download files from app volumes
•Backup & Restore: Create and restore backups of application data
•Control: Start, stop, restart, pause, unpause, and remove apps (local or global)
•Running Instances: See which nodes are running your app and their health status
•Update & Renew: Update app specifications or extend the subscription period

Marketplace Apps

FluxCloud offers pre-configured marketplace templates for popular applications:

•Blockchain nodes: Kaspa, Ergo, Firo, and more — deploy full nodes with one click
•WordPress: Full WordPress installation with custom domain support and admin setup
•Gaming: Minecraft servers with configurable settings
•Storage: FluxDrive and FluxDrive Pro for decentralized file storage

App Pricing Model

Resource	Cost (per 22,000 blocks / ~1 month)
CPU	0.03 FLUX per 0.1 core
RAM	0.01 FLUX per 100 MB
HDD/SSD	0.004 FLUX per 1 GB
Enterprise port	0.4 FLUX per port
Private image / Targeting	0.8 FLUX
Static IP targeting	0.4 FLUX
Minimum	0.01 FLUX

Registration periods range from 100 blocks (~3 hours) to 264,000 blocks (~1 year). After the v8/PON fork, maximum extends to 1,056,000 blocks (~4 years).