Interactive Playground

Build your Flux deployment specification visually - no JSON editing required!

Quick Tips

• Configure your application details and add as many components as needed
• The cost estimate updates in real-time as you adjust resources
• Port range: All ports must be between 0 and 65535 (system limit)
• Use the internal DNS pattern for multi-component communication: flux{componentname}_{appname}
• Download the generated spec and deploy it via home.runonflux.io
• Start with smaller resources and scale up if needed to save costs

Application Details

App NameThe unique name for your application across the Flux network. Only letters (a-z, A-Z) and numbers (0-9) are allowed. No special characters or spaces.

DescriptionA brief description of your application. This will be displayed on the Flux app marketplace and dashboard.

ZelID (Optional)Your Flux ZelID that will own this app. Leave empty to set it during deployment. Required to manage and update your app.

Advanced Options

Static IPRestricts deployment to Flux nodes with static IP addresses. Increases deployment cost based on resources. Useful for apps requiring consistent external IP.

Deploy only on nodes with static IP addresses

Enterprise ApplicationDeploy to ArcaneOS enterprise nodes with OS-level encrypted volumes where node operators cannot access your data. Enables private Docker images and encrypted environment secrets. Increases deployment cost based on resources.

Enhanced security: encrypted volumes, private images, protected secrets

Component 1: app

Component NameA unique name for this component within your app. Used for internal DNS (e.g., flux{componentname}_{appname}).

DescriptionA brief description of what this component does in your application.

Docker ImageThe Docker image repository and tag. Format: username/image:tag. Public images work on all nodes. Private images from GHCR, GitLab, or private registries require enterprise mode (ArcaneOS nodes).

CPU (cores)Number of CPU cores allocated to this component. Increments by 0.1. Priced at $0.15 per 0.1 core per month.

RAM (MB)Memory allocated in megabytes. Increments by 100 MB. Priced at $0.05 per 100 MB per month.

Storage (GB)Persistent storage in gigabytes. Increments by 1 GB. Priced at $0.02 per GB per month.

Ports & DomainsMap external ports to container ports for public access. Valid port range: 0-65535. Domains allow you to route custom hostnames via CloudFlare CNAME records to your app's ports.

External (0-65535)The port exposed on the Flux network that users connect to. Must be between 0 and 65535.

Container (0-65535)The port your application listens on inside the container. Must be between 0 and 65535.

Domain (leave empty for Flux default)Optional custom domain. Point your DNS A record to your app's IP to use. Leave empty to use the Flux-provided domain.

Data VolumePath inside the container where persistent data is stored. Data survives container restarts. Example: /appdata, /data, /var/lib/postgresql/data

Environment VariablesKey-value pairs passed to your container. Format: KEY=value. Common uses: NODE_ENV=production, DATABASE_URL=postgres://...

CommandsOptional startup commands to run when the container starts. Each command runs in sequence. Example: npm install, npm start

Cost Estimate

Total CPU:2 cores

Total RAM:4000 MB

Total Storage:10 GB

Components (ports):1

Instance Count:Number of redundant copies of your app. Base price covers 3 instances. Additional instances cost ~$0.50 each for small apps or basePrice/3 for larger apps.3

3 (base)100 (max)

Total Cost:26.35 FLUX/month

Approximately:$4.16/month

Generated Spec

{
  "version": 8,
  "name": "myapp",
  "description": "My Flux Application",
  "owner": "YOUR_ZELID_HERE",
  "instances": 3,
  "staticip": false,
  "enterprise": "",
  "compose": [
    {
      "name": "app",
      "description": "Main application",
      "repotag": "username/my-app:latest",
      "ports": [
        3000
      ],
      "containerPorts": [
        3000
      ],
      "domains": [
        ""
      ],
      "environmentParameters": [
        "NODE_ENV=production"
      ],
      "commands": [],
      "containerData": "/appdata",
      "cpu": 2,
      "ram": 4000,
      "hdd": 10,
      "tiered": false
    }
  ]
}

Easy Copy-Paste Deployment

Once you've built your specification above, simply copy the generated JSON and paste it into the "Import Application Specifications" dialog on the Flux deployment page. No manual typing or file uploads required!

1Click "Copy" on the generated spec

2Go to Register New App

3Click "Import" and paste

Deploy Now

Interactive Playground

Quick Tips

Application Details

Advanced Options

Component 1: app

Cost Estimate

Generated Spec

Easy Copy-Paste Deployment

Need Help?

Basic Tutorial →

Multi-Component →

Spec Reference →