Developer tools

The terminal is afirst-class client.

Anything you can do in the web dashboard, you can do directly from the Hubfly space CLI. Deploy applications, create managed databases, realtime servers and buckets, open SSH shells and tunnels, and stream live logs without leaving your terminal.

Project workflow01 / 03
01
SourceGo CLI with Bubble Tea TUI
02
ControlCompose Stack Orchestrator
03
ReleaseManaged databases, realtime and storage
Hubfly space projectNetwork · volumes · domains · team access
One project model

Command line binary

A single binary for your entire workflow.

The CLI is a fast, self-contained Go binary featuring an interactive terminal interface alongside headless subcommands for CI automation and developer tooling.

01

Bubble Tea Terminal UI

Browse projects, track live container metrics, launch remote SSH shells, and toggle encrypted local tunnels with an interactive terminal interface.

Built with Charm Bubble Tea

02

Deploy Without Committing

Package and ship code directly from your working directory. Iterate rapidly locally without needing to push preliminary git commits.

03

Explainable Build Detection

`hubfly build explain` breaks down detected frameworks, base images, and build flags before running remote steps.

04

Daemon Service Mode

Run `hubfly service` as a background daemon with CORS-ready REST API endpoints for editor extensions and local tools.

hubfly-cli

$ hubfly login --token hf_pat_••••••••
Authenticated as ada@analytical.dev
$ hubfly deploy --project edge-api --region eu-west-1 --yes
Detected runtime: Go (go.mod)
Local container build succeeded
Uploading image archive to regional builder...
Deployment succeeded · bound container cont_api_987 updated
$ hubfly logs api -f
[stdout] Server listening on port 8080 · private IP 10.30.1.4

CLI Command Quick Reference

hubfly login

Flags and subcommands
--token <TOKEN>
Description
Authenticate your terminal session interactively or via personal access token

hubfly logout

Flags and subcommands
-
Description
End your current local CLI authentication session

hubfly whoami

Flags and subcommands
-
Description
Check active session credentials and verify logged-in identity

hubfly projects

Flags and subcommands
--org <ID|SLUG>
Description
Interactive terminal UI for projects, container stats, and local tunnels

hubfly deploy

Flags and subcommands
--project --region --yes --detach
Description
Build working directory locally and ship directly to your project

hubfly stack

Flags and subcommands
plan · up · status · logs · exec · down
Description
Local-first Compose stack deployment and dependency orchestration

hubfly build

Flags and subcommands
init · validate · edit · explain
Description
Manage hubfly.build.json and preview auto-detection steps

hubfly tunnel

Flags and subcommands
<container> <local> <target>
Description
Forward local ports securely over encrypted WebSocket to private containers

hubfly ssh

Flags and subcommands
<container> [-- <cmd>]
Description
Open an interactive terminal shell or execute one-off remote commands

hubfly exec

Flags and subcommands
<container> -- <cmd>
Description
Run one-shot commands inside a container namespace

hubfly logs

Flags and subcommands
<container> [-f]
Description
Stream stdout and stderr logs live to your terminal

hubfly db

Flags and subcommands
create · bind · url · query · users · export · import
Description
Create and operate managed PostgreSQL, MySQL and SQLite (libSQL) databases

hubfly realtime

Flags and subcommands
create · apps · keys · bind · publish · tail
Description
Run Pusher-compatible realtime servers; rt is a short alias

hubfly stream

Flags and subcommands
create · inputs · channels · destinations · live · push
Description
Run live video servers and restream; live is a short alias

hubfly storage

Flags and subcommands
buckets · ls · put · get · keys · publish · encode
Description
Manage S3-compatible buckets, objects, access keys, assets and video

hubfly service

Flags and subcommands
--port <port>
Description
Run a local background daemon with REST endpoints for local tools

hubfly update

Flags and subcommands
--check
Description
Check for CLI updates and upgrade your local binary to the latest version

Managed services

Databases, realtime, streams and storage from the same binary.

The db, realtime, stream and storage command groups cover the whole lifecycle of each product. Create commands ask for confirmation unless you pass --yes, and secrets are printed only with --reveal or once, when they are created.

Managed Databases

hubfly db

Create an instance, bind it to an app, query it and take an export, without opening Dashboard.

hubfly-cli

$ hubfly db create app-db --engine postgresql
$ hubfly db bind app-db --to web
$ hubfly db url app-db --reveal
$ hubfly db query app-db "select now()"
$ hubfly db export app-db --format sql
hubfly db reference

Realtime

hubfly realtime

Create a server, write its keys into a project, send a test event and watch traffic as it happens.

hubfly-cli

$ hubfly realtime create chat --size nano
$ hubfly realtime bind chat --to web
$ hubfly rt publish chat --channel news --event hi
$ hubfly rt tail chat
hubfly realtime reference

Live Streams

hubfly stream

Create a server, point OBS at it, restream to YouTube and watch the health of every input live.

hubfly-cli

$ hubfly stream create acme-tv --speed 100
$ hubfly stream channels create acme-tv Main --source input:sin_cam1abcd
$ hubfly stream live acme-tv
$ hubfly stream push acme-tv show.mp4 --loop
hubfly stream reference

Object Storage

hubfly storage

Create buckets, upload a directory, give an app a scoped S3 key and publish an asset.

hubfly-cli

$ hubfly storage buckets create uploads
$ hubfly storage put ./dist uploads --recursive
$ hubfly storage keys create web --to web
$ hubfly storage publish uploads/logo.png
hubfly storage reference

Build engine

From source code to optimized containers.

Our build engine packages code into optimized container images using BuildKit and regional layer caching for high performance.

01

Runtime Auto-Detection

Node, Bun, Go, Python, Java, PHP, and static web apps identified instantly from manifest files.

02

Allowlisted Command Execution

Build steps and setup scripts strictly verified against platform security allowlists.

03

Layer Caching Engine

Intermediate build layers cached on regional builders for rapid redeploys.

04

Security & Vuln Scanning

Built-in Trivy security scanning highlights package vulnerabilities before promotion.

Automation

Drive platform state from code.

Manage infrastructure programmatically using typed TypeScript and native Go SDKs built for automated deployments, domain configuration, and private tunnels.

TypeScript SDK

import { Hubfly space } from '@hubfly/sdk';

const hubfly = new Hubfly space({ token: process.env.HUBFLY_TOKEN });

await hubfly.deployments.create({
  project: 'edge-api',
  image:   'registry.hubfly.space/edge-api/web:v1.7.1',
  region:  'eu-west-1',
});
@hubfly/sdk

TypeScript

Node and Bun, fully typed

hubfly-sdk/go

Go

Native package for Go backends

Comprehensive CLI Documentation Hub

Detailed guides, argument specs, environment variables, storage paths, and Compose translation engine references are available in our updated docs suite.

Developer tools

Install the CLI and deploy in seconds.

Authenticate with your token, run `hubfly deploy` in your project root, and watch live build streams directly in your terminal.