Notploy

Command reference

Every group and command the Notploy CLI exposes — 63 groups, 718 commands.

This reference is generated from the CLI source (packages/cli), so it lists exactly what notploy 1.0.2 registers with its command parser — no more, no less.

63 groups · 718 commands.

Each group below is a page of this section, and every page lists the commands of that group with their flags, required inputs and allowed values.

Every command accepts --json to print the raw API response, and notploy auth — the one command that is not part of the generated groups — is covered in Authentication.

Groups

Overview

GroupCommandCommandsDescription
Operational eventsnotploy operational-event2Timeline of instance-level events used by alerts, audits and the activity feed.
Overviewnotploy overview3Aggregated counters for the dashboard: services, backups and domains.
Traffic analyticsnotploy traffic11Traffic sources and properties, HTTP reports and the audience overview built from access logs.

Projects

GroupCommandCommandsDescription
Deploymentsnotploy deployment11Inspect deployment history and queues, read deployment logs and kill a running build.
Environmentsnotploy environment7Applications and databases live inside an environment, and environments belong to a project.
Projectsnotploy project11Create, update, search and remove projects, and read the onboarding state of an instance.
Rollbacksnotploy rollback2Roll a deployment back to a previously built image.
Tagsnotploy tag8Label projects and filter the dashboard by tag.

Applications

GroupCommandCommandsDescription
Applicationsnotploy application32Create applications, connect a source, configure the build and drive the whole lifecycle.
Composenotploy compose31Docker Compose projects: templates, imports, isolated deployments and previews.
Mountsnotploy mounts6Bind mounts and named volumes attached to applications and Compose services.
Patchesnotploy patch12Versioned file overrides applied to an application at deploy time.
Preview deploymentsnotploy preview-deployment4Per-branch deployments created when preview deployments are enabled.
Schedulesnotploy schedule6Cron jobs that run a shell command inside a deployed service.
Securitynotploy security4Per-application HTTP basic auth and response security headers.
Vault providersnotploy vault-provider13External secret managers connected to the platform to resolve secrets at deploy time.

Databases

GroupCommandCommandsDescription
libSQLnotploy libsql14Provision and operate libSQL (SQLite-compatible) databases.
MariaDBnotploy mariadb16Provision and operate MariaDB databases, including backups and external ports.
MongoDBnotploy mongo16Provision and operate MongoDB databases, including backups and external ports.
MySQLnotploy mysql16Provision and operate MySQL databases, including backups and external ports.
PostgreSQLnotploy postgres16Provision and operate PostgreSQL databases, including backups and external ports.
Redisnotploy redis16Provision and operate Redis instances, including backups and external ports.

Backups

GroupCommandCommandsDescription
Backupsnotploy backup12Scheduled and manual backups for databases, Compose services and the web server.
Destinationsnotploy destination7S3-compatible storage destinations that backups are uploaded to.
Object storagenotploy object-storage15S3-compatible providers and buckets used as backup destinations, including usage and health.
Volume backupsnotploy volume-backups6Back up Docker volumes on a schedule and download the resulting archives.

Domains & networking

GroupCommandCommandsDescription
Certificatesnotploy certificates8Custom TLS certificates loaded by Traefik alongside automatic Let's Encrypt ones.
DNS providersnotploy dns-provider15Zones and records for connected DNS providers such as Cloudflare and Route 53.
Domainsnotploy domain11Attach domains to applications and Compose stacks, and generate or validate them.
Forward authnotploy forward-auth10Deploy an authentication proxy in front of applications and manage its domains.
Networksnotploy network10Docker networks: create, import, inspect and resynchronise them across servers.
Onion servicesnotploy onion9Tor onion services attached to a Compose stack: create, start, stop and inspect their status.
Portsnotploy port4Publish container ports directly, without routing them through a domain.
Redirectsnotploy redirects4HTTP redirects served by Traefik for an application's domains.

Git providers

GroupCommandCommandsDescription
Bitbucketnotploy bitbucket7Bitbucket connections, plus branch and repository lookups.
Git providersnotploy git-provider4List, share and remove every Git provider connected to an organization.
Giteanotploy gitea8Gitea connections, plus branch and repository lookups.
GitHubnotploy github6GitHub app connections, plus branch and repository lookups.
GitLabnotploy gitlab7GitLab connections, plus branch and repository lookups.

Servers & infrastructure

GroupCommandCommandsDescription
Clusternotploy cluster4Add and remove Swarm workers and managers.
Dockernotploy docker20Containers, the Docker daemon configuration, events and container files.
Docker disk usagenotploy docker-disk-usage3Disk usage per Docker object type, and build cache pruning.
Docker imagesnotploy docker-image3List, inspect and remove images stored on a server.
Docker volumesnotploy docker-volume8Inspect volumes, their size and the files inside them.
Network providersnotploy network-provider9External network providers (overlay networks and peers) plus their health checks.
Registriesnotploy registry17Container registries used to pull private images.
Serversnotploy server21Add remote servers over SSH, validate them and read their metrics and services.
SSH keysnotploy ssh-key7SSH keys used to reach servers and clone private repositories.
Swarmnotploy swarm5Inspect Docker Swarm nodes, node workloads and container statistics.

Notifications

GroupCommandCommandsDescription
Notificationsnotploy notification41Notification channels — Slack, Discord, Telegram, email and others — plus test deliveries.

Team & access

GroupCommandCommandsDescription
Audit lognotploy audit-log1Every recorded action performed in the organization.
Custom rolesnotploy custom-role6Organization roles built from a set of permission statements.
Organizationsnotploy organization11Organizations, members, invitations and the active organization.
SCIMnotploy scim3SCIM provisioning providers and tokens used for directory sync.
SSOnotploy sso16Single sign-on providers, enforcement and trusted origins.
Usersnotploy user26Accounts, API keys, sessions, permissions and per-user metrics.

Platform

GroupCommandCommandsDescription
Adminnotploy admin1Administrative operations that apply to the whole instance.
Communitynotploy community14Community sources, repositories, releases and the health report of the instance's community presence.
Settingsnotploy settings57Instance-wide settings: Traefik, Docker cleanup, monitoring, GPUs, updates and SSH.
Status pagenotploy status12Publish incidents and maintenance windows to the public status page.
Stripenotploy stripe15Billing for Notploy Cloud: plans, invoices, checkout and the customer portal.
Whitelabelingnotploy whitelabeling4Rebrand the instance: application name, logos, favicon and links.

Automation

GroupCommandCommandsDescription
AInotploy ai14AI providers and models, plus log analysis and configuration suggestions.

Naming

Groups are the first argument and commands the second: notploy <group> <command>. Both are lowercase and hyphenated, matching the API namespace they call (docker-disk-usage → dockerDiskUsage.*).

Flags are the input fields of that operation, in camelCase: --environmentId is passed through as environmentId. A flag marked Yes in the Required column aborts the command when it is missing, so it always has to be provided; the others are omitted from the request when you leave them out, which lets the server apply its defaults.

Flag names, required flags and allowed values are read from the CLI itself, so this page cannot drift from what notploy --help reports.

On this page