CLI reference

Every nebula command. Run nebula <command> --help for full flags.

Auth

CommandWhat it does
nebula loginBrowser device-flow login; saves a token to ~/.config/nebula/.
nebula login --token <t>Log in with a dashboard-generated token (CI / headless).
nebula logoutDiscard the saved token.
nebula whoamiShow the current user, plan, and pool usage.

Deploying

CommandWhat it does
nebula deploy <repo>Create a new single-project nebula from a GitHub URL and launch it.
nebula deploy <repo> --nebula <name>Add another project to an existing nebula.
nebula deploy --nebula <name>Redeploy the latest commit to an existing project.
nebula env set KEY=valueSet an environment variable (applied on next deploy).
nebula env listList a nebula's environment variables.

Managing nebulae

CommandWhat it does
nebula listList your nebulae and their status.
nebula logs <name>Stream a nebula's logs (-f to follow).
nebula ssh <name>Open an SSH session to the nebula.
nebula open <name>Open the nebula's URL in your browser.
nebula start <name>Start a stopped nebula.
nebula stop <name>Stop a running nebula.
nebula rm <name>Delete a nebula and its data.

Domains

CommandWhat it does
nebula domain add <fqdn>Proxy a custom domain or subdomain to a nebula.
nebula domain secure <fqdn>Issue an SSL certificate via Certbot.
nebula domain rm <fqdn>Remove a domain's vhost (keeps the certificate).