Skip to content

CLI Reference Overview ​

NextDeploy provides a developer-friendly command-line interface built with Cobra.

Every command includes built-in deep explanations accessible via:

bash
nextdeploy <command> explain

Global Flags ​

The following flags can be passed to any nextdeploy command:

FlagShorthandTypeDescription
--config-cstringPath to configuration file (default: ./nextdeploy.yml).
--verbose-vbooleanEnable verbose debug output.
--jsonbooleanOutput results in machine-readable JSON format.
--help-hbooleanDisplay help information for the command.

Command Summary ​

CommandAliasDescription
nextdeploy initInteractively initialize nextdeploy.yml in a project.
nextdeploy planDry-run preflight: detect drift and preview changes without modifying resources.
nextdeploy buildBuild the Next.js app and run NextCore route introspection.
nextdeploy shipdeployBuild, package, upload, health-check, and cutover with zero downtime.
nextdeploy rollbackInstantly revert to a previous deployment without rebuilding.
nextdeploy statusInspect deployment health, uptime, and server/container resource usage.
nextdeploy logsStream live server logs or query historical deployment logs.
nextdeploy secretsManage encrypted environment variables and secret stores.
nextdeploy prepareBootstrap server dependencies (Caddy, daemon, systemd, cgroups).
nextdeploy inspectIntrospect project routes, ISR tags, and build manifests.
nextdeploy generate-ciScaffold automated GitHub Actions deployment pipelines.
nextdeploy updateSelf-update the nextdeploy CLI binary to the latest release.
nextdeploy versionPrint current CLI version, commit hash, and build timestamp.

Released under the MIT License.