HubDocs

Guides

Quick start. Install the CLI, sign in and deploy an app.

You need Node.js 22.12 or newer.

Install the CLI

npm install --global @hubhq/cli@latest

Sign in

hub login

hub login opens your browser to sign in or create an account. Creating an account also creates your org. During early access, a new account needs an invite code: ask for one.

Deploy

cd my-app
hub deploy

hub deploy detects your project, shows build progress, and prints your app's URL when it's ready. Apps are accessible to your organization by default.

Deploy changes

Run hub deploy again from your project directory to deploy local changes. To deploy another folder, name it:

hub deploy ./my-app

Or connect a GitHub repository, and Hub deploys every push:

hub deploy --git owner/repository

Hub supports Node.js apps, frontends, static sites, and projects with a Dockerfile or Compose configuration. Deploy explains what it looks for.

Share access

Invite a teammate to your organization, or someone to just one app:

hub invite teammate@company.com
hub app my-app invite client@example.com

An app invitation lets someone use that app, not manage it or join your organization. Recipients sign in through their browser; they don't need the CLI. Hub sends no email: each command prints a link for you to send.

Choose who can open the app:

hub app my-app access private    # Owner and explicitly invited people
hub app my-app access org        # Organization and explicitly invited people
hub app my-app access public     # Anyone, without a Hub login

private and org require sign-in. Changing modes preserves app invitations. To turn off public access, choose org or private. Access and invitations has the details.

Check your apps

hub apps                        # List your apps
hub app my-app open             # Open the app in your browser
hub app my-app status           # Check its status
hub app my-app logs             # Follow build and runtime logs

Logs show recent output and follow new activity, including the transition from build to running app.

For help in your terminal:

hub --help
hub app my-app --help
hub app my-app logs --help

On this page