Flux-Orbit: Zero-Config Universal Deployment
Deploy any project without a Dockerfile — auto-detection for Node.js, Python, Rust, Go, Java, Bun, Ruby, and static sites.
Flux-Orbit: Zero-Config Universal Deployment
Flux-Orbit is a universal Docker deployment system that eliminates the need to write Dockerfiles entirely. Point Orbit at your source code, and it automatically detects your project type, installs dependencies, builds, and starts your application — all with zero configuration. It supports Node.js, Python, Rust, Go, Java, Bun, Ruby, and static sites.
How Orbit Works
- 1
Auto-detect project type
Orbit scans your repository and identifies the language/framework based on files like package.json (Node.js), requirements.txt (Python), Cargo.toml (Rust), go.mod (Go), pom.xml (Java), etc.
- 2
Install dependencies
Runs the appropriate package manager: npm install, pip install, cargo build, go build, etc.
- 3
Build the project
Executes the standard build command for the detected framework (npm run build, python setup.py, etc.).
- 4
Start the application
Launches the app using the detected start command (npm start, python app.py, ./binary, etc.).
Using Orbit
To deploy with Orbit, use the Docker image runonflux/orbit:latest as your repotag in the Flux app spec and pass your Git repository URL as an environment variable.
Flux app spec using Orbit
{
"version": 4,
"name": "my-orbit-app",
"description": "Auto-deployed via Flux-Orbit",
"owner": "YOUR_ZELID",
"instances": 3,
"compose": [
{
"name": "app",
"repotag": "runonflux/orbit:latest",
"ports": [3000],
"containerPorts": [3000],
"domains": ["myapp.example.com"],
"environmentParameters": [
"GIT_REPO_URL=https://github.com/user/my-python-app.git",
"APP_PORT=3000"
],
"commands": [],
"containerData": "/appdata",
"cpu": 0.5,
"ram": 256,
"hdd": 2
}
]
}Supported Languages
| Language | Detection File | Package Manager |
|---|---|---|
| Node.js | package.json | npm / yarn / pnpm |
| Python | requirements.txt / setup.py / pyproject.toml | pip |
| Rust | Cargo.toml | cargo |
| Go | go.mod | go build |
| Java | pom.xml / build.gradle | maven / gradle |
| Bun | bun.lockb | bun |
| Ruby | Gemfile | bundler |
| Static Sites | index.html | served directly |
When to Use Which Deployment Method
| Method | Best For | Complexity |
|---|---|---|
| Flux-Orbit | Quick prototypes, simple apps, no Docker knowledge | Lowest |
| Deploy with Git | Active development, CI/CD workflows, auto-deploy on push | Low |
| Custom Dockerfile | Complex apps, specific dependencies, optimized images | Medium |
| Compose v4 | Multi-service architectures, databases, microservices | Higher |
Orbit is accessible at orbit.app.runonflux.io for a visual deployment experience. You can also use the Orbit Docker image directly in any Flux app specification for full control.
Sources & Further Reading
Other articles in FluxCloud Advanced Deployment
Docker Prerequisites & Best Practices for Flux
Install Docker, create optimized Dockerfiles, multi-stage builds, image registries, containerData volumes, and common mistakes.
Compose v4: Multi-Component Applications
Deploy up to 5 components with Flux Compose v4 — internal DNS, inter-component communication, ports, and environment variables.
Enterprise Deployments (Private Images, Secrets & Static IP)
Enterprise mode features — private Docker registries, secrets management, static IPs, node targeting, and pricing.
Deploy with Git (CI/CD & Auto-Deploy)
Auto-deploy from GitHub/GitLab/Bitbucket — webhooks, polling, zero-downtime updates, rollback, and CI/CD integration.
Shared Databases & Auto-Replication
Deploy databases on Flux with persistent storage — MongoDB, PostgreSQL, Redis replication strategies and backup patterns.
Tiered Resources, Spec Builder & Cost Calculator
Basic/Super/BAMF resource tiers, Visual Spec Builder, Cost Calculator, pricing model, and cloud cost comparison.
App Troubleshooting & Post-Deployment Management
Diagnose deployment failures, domain issues, DB connection problems — plus updating specs, monitoring, and app lifecycle management.