Cloider CLI command reference, every command
This page lists every command of the cloider CLI, grouped by product, with a one line description and a link to its full reference with flags, examples and output. The CLI has 196 commands and subcommands; cloider <command> --help shows the same information in the terminal.
How to read the reference
Every command page uses the same conventions:
| Notation | Meaning |
|---|---|
cloider cluster create <name> | <name> is a required argument |
cloider cluster services [cluster] | [cluster] is optional |
<path>... or --trusted-source (repeatable) | The argument or flag can be given several times |
on|off, public|private | Pick one of the values |
[--] | A -- may separate cloider's flags from a remote command's own arguments (exec commands) |
<cluster>, <database>, <app> | A resource's name, label or id, see how commands find a resource |
Commands that change a resource take --wait (-w) and --timeout; deletes ask for confirmation unless you pass --yes. Every command also takes the global flags:
| Global flag | Description |
|---|---|
--profile <name> | Profile to use (env CLOIDER_PROFILE) |
--api-url <url> | API to talk to (env CLOIDER_API_URL, default https://cloider.com/api) |
--token-file <path> | Read the API token from this file (env CLOIDER_TOKEN_FILE) |
-o, --output <format> | table, wide (adds ids), json or yaml |
-q, --quiet | Print only ids or names |
--no-headers | Print tables without the header row |
--no-color | Disable colors (env NO_COLOR) |
-y, --yes | Don't ask for confirmation |
--debug | Log API requests to stderr |
-h, --help | Help for any command |
Command pages
cluster
Reference for cloider cluster, to create, list, pause, resume and delete Kubernetes clusters, get kubeconfigs, list services, open a shell and run kubectl with exec.
db
Reference for cloider db, to create and manage PostgreSQL, MySQL, MongoDB and Redis databases, connect, run queries, back up, restore, resize and control access.
bucket
Reference for cloider bucket, to manage S3 compatible buckets, files, versions, static websites, policies, lifecycle and CORS rules and access keys from the terminal.
registry
Reference for cloider registry, to manage container registry projects, log docker in, list and delete images, create pull and push tokens, and set retention and immutability.
app
Reference for cloider app, to create, inspect, pause, update and delete apps, stream logs, manage environment variables, build args and builds, and run commands inside an app.
deploy
Reference for cloider deploy, which uploads a directory as an app, creates the app on the first deploy, links the directory, builds new versions and redeploys git apps.
git
Reference for cloider git, to connect GitHub, GitLab and Bitbucket accounts, list connected installations, repositories and branches, and disconnect an account.
domain
Reference for cloider domain, to claim free cloider.app subdomains, add custom domains, check availability, see a domain's routes and delete domains.
dns
Reference for cloider dns, to list, show, create, update and delete the DNS records of a custom domain, with every record type, TTLs and multiple values.
target
Reference for cloider target, to route a domain's paths to apps, Kubernetes services or bucket websites, list routes, change a route and delete it.
support
Reference for cloider support, to open Cloider support requests from the terminal, read replies, reply with attachments and download attachments.
account
Reference for the cloider account commands: usage and forecast, monthly bills, current prices, members, API tokens and whoami, and which account actions are dashboard only.
auth and profiles
Reference for cloider login, cloider logout and cloider profile, with every flag, the browser and token login flows, and how profiles switch between accounts.
tooling
Reference for the commands that manage the cloider CLI itself, cloider version, cloider update with status, enable and disable, and cloider completion.
mcp
Reference for cloider mcp, the MCP server that offers the Cloider CLI to AI agents, with --read-only, --toolsets, profiles, tool safety hints and how tools run.
Kubernetes clusters
cloider cluster manages serverless Kubernetes clusters. Alias: clusters.
| Command | Description |
|---|---|
cloider cluster | Manage Kubernetes clusters |
cloider cluster create | Create a cluster |
cloider cluster delete | Delete a cluster and everything in it |
cloider cluster exec | Run a command in the cluster's terminal (kubectl, helm), for scripts and AI agents |
cloider cluster get | Show a cluster |
cloider cluster kubeconfig | Print a cluster's kubeconfig, write it to a file, or merge it into yours |
cloider cluster list | List clusters |
cloider cluster pause | Pause a cluster, stopping its compute until it is resumed |
cloider cluster resume | Resume a paused cluster |
cloider cluster services | List the services clusters expose, which domain targets can route to |
cloider cluster shell | Open a shell with kubectl inside a cluster |
cloider cluster status | Print a cluster's status |
Databases
cloider db manages PostgreSQL, MySQL, MongoDB and Redis databases. Aliases: database, databases, dbs.
| Command | Description |
|---|---|
cloider db | Manage PostgreSQL, MySQL, Redis and MongoDB databases |
cloider db backups | List a database's backups, newest first |
cloider db cert | Print the CA certificate that signs a database's TLS certificate |
cloider db connect | Connect with the engine's own client (psql, mysql, redis-cli, mongosh) |
cloider db create | Create a database |
cloider db delete | Delete a database and its data |
cloider db exec | Run a query or script with the database's client, for scripts and AI agents |
cloider db get | Show a database and how to reach it |
cloider db insights | Show a database's resource usage today (-o json for the month) |
cloider db list | List databases |
cloider db password | Print a database user's password |
cloider db pause | Pause a database, keeping its data at a lower price until it is resumed |
cloider db rename | Change the name a database is shown and found by |
cloider db resize | Move a database to a larger plan (restarts it) |
cloider db restore | Restore a backup into a new database, leaving this one as it is |
cloider db resume | Resume a paused database |
cloider db shell | Open the engine's client inside the platform, already logged in |
cloider db ssl | Require TLS on a database, or stop requiring it (restarts it) |
cloider db status | Print a database's status |
cloider db trusted-sources | List or change who may connect to a database |
Object storage
cloider bucket manages S3 compatible buckets, their files and access keys. Alias: buckets; bucket key also answers to bucket keys.
| Command | Description |
|---|---|
cloider bucket | Manage object storage buckets, their files and access keys |
cloider bucket cors | Show or replace a bucket's CORS rules |
cloider bucket cors clear | Remove every CORS rule of a bucket, so any website can use it again |
cloider bucket cors get | List a bucket's CORS rules |
cloider bucket cors set | Replace every CORS rule of a bucket (-f - reads stdin) |
cloider bucket create | Create a bucket |
cloider bucket delete | Delete a bucket and every file in it |
cloider bucket deleted | List deleted files a versioned bucket can still restore |
cloider bucket download | Download files from a bucket |
cloider bucket get | Show a bucket, its endpoint and url |
cloider bucket key | Manage S3 access keys for buckets |
cloider bucket key create | Create an access key, its secret is shown once |
cloider bucket key delete | Delete an access key, anything using it loses access |
cloider bucket key list | List access keys |
cloider bucket key update | Change an access key's label, buckets or permission |
cloider bucket lifecycle | Show or replace a bucket's lifecycle rules |
cloider bucket lifecycle clear | Remove every lifecycle rule of a bucket |
cloider bucket lifecycle get | List a bucket's lifecycle rules |
cloider bucket lifecycle set | Replace every lifecycle rule of a bucket (-f - reads stdin) |
cloider bucket list | List buckets |
cloider bucket ls | List a bucket's files and folders |
cloider bucket mkdir | Create an empty folder |
cloider bucket policy | Show, set or remove a bucket's S3 policy |
cloider bucket policy delete | Remove a bucket's policy |
cloider bucket policy get | Print a bucket's policy |
cloider bucket policy set | Replace a bucket's policy (-f - reads stdin) |
cloider bucket regions | List the regions a bucket can be created in |
cloider bucket restore | Make a previous version of a file the current one, or undelete it |
cloider bucket rm | Delete files, or whole folders with --prefix |
cloider bucket rm-versions | Permanently delete versions of a file |
cloider bucket status | Print a bucket's status |
cloider bucket upload | Upload files to a bucket |
cloider bucket usage | Show a bucket's storage use and cost this month |
cloider bucket versioning | Show or change whether a bucket keeps previous versions of its files |
cloider bucket versions | List the versions a file has, newest first |
cloider bucket visibility | Show or change whether anyone can read a bucket's files |
cloider bucket website | Show or change a bucket's static website |
Container registry
cloider registry manages registry projects, images, tokens and policies. Alias: registries; registry token also answers to registry tokens.
| Command | Description |
|---|---|
cloider registry | Manage container registry projects, their images and tokens |
cloider registry create | Create a project |
cloider registry delete | Delete a project and every image in it |
cloider registry get | Show a project, its address and storage |
cloider registry images | List the images in a repository and their tags, newest first |
cloider registry immutability | Protect tags from being deleted or pushed over |
cloider registry immutability add | Add an immutability rule |
cloider registry immutability delete | Delete an immutability rule |
cloider registry immutability list | List a project's immutability rules |
cloider registry immutability update | Change an immutability rule, keeping what isn't given |
cloider registry list | List projects |
cloider registry login | Log docker in to every project of the account |
cloider registry repos | List a project's repositories, most recently pushed first |
cloider registry retention | Delete old images automatically, with rules for what to keep |
cloider registry retention get | Show a project's retention rules and schedule |
cloider registry retention run | Run a project's retention now, or see what it would delete with --dry-run |
cloider registry retention runs | List retention runs, what a run did per repository, or per image |
cloider registry retention schedule | Change when a project's retention runs, in UTC |
cloider registry retention set | Replace every retention rule of a project (-f - reads stdin) |
cloider registry rm | Delete an image, and every tag on it |
cloider registry rm-repo | Delete a repository and every image in it |
cloider registry set | Change who can pull from a project, how much it may store, or whether its tags are immutable |
cloider registry status | Print a project's status |
cloider registry token | Manage the tokens docker logs in to projects with |
cloider registry token create | Create a registry token, its secret is shown once |
cloider registry token delete | Delete a registry token, anything logged in with it loses access |
cloider registry token list | List registry tokens |
cloider registry token update | Change a registry token's label, projects or permission |
cloider registry untag | Take a tag off an image, the image stays |
cloider registry usage | Show a project's storage use and cost this month |
Apps and deploys
cloider app and cloider deploy manage apps; cloider git connects the git providers apps deploy from. Alias: apps.
| Command | Description |
|---|---|
cloider app | Manage apps: deploy, logs, environment, builds |
cloider app build | Read a build's logs or retry it |
cloider app build logs | Print a build's output, following it while it runs (default: the latest build) |
cloider app build retry | Run a failed build again |
cloider app build-args | Read and change the build args the app's Dockerfile is built with |
cloider app build-args get | Print one variable's value, secrets included |
cloider app build-args import | Set variables from a .env file (- for stdin) |
cloider app build-args list | List the app's variables |
cloider app build-args set | Set variables, keeping the others |
cloider app build-args unset | Remove variables |
cloider app build-env | Read and change the variables a buildpack build runs with |
cloider app build-env get | Print one variable's value, secrets included |
cloider app build-env import | Set variables from a .env file (- for stdin) |
cloider app build-env list | List the app's variables |
cloider app build-env set | Set variables, keeping the others |
cloider app build-env unset | Remove variables |
cloider app builds | List the app's builds, newest first |
cloider app create | Create an app from a git repository (use cloider deploy for a directory) |
cloider app delete | Delete an app |
cloider app deploy | Deploy a directory as an app, creating the app the first time |
cloider app env | Read and change the app's environment variables |
cloider app env get | Print one variable's value, secrets included |
cloider app env import | Set variables from a .env file (- for stdin) |
cloider app env list | List the app's variables |
cloider app env set | Set variables, keeping the others |
cloider app env unset | Remove variables |
cloider app exec | Run a command in the app's container, for scripts and AI agents |
cloider app get | Show an app |
cloider app git | Change the branch a git app deploys from, or its auto deploy |
cloider app link | Link a directory to an app, so cloider deploy there deploys to it |
cloider app list | List apps |
cloider app logs | Print the app's logs, -f to follow them |
cloider app open | Open the app's URL in the browser |
cloider app pause | Stop the app serving, keeping its environment and image |
cloider app resume | Start a paused app again |
cloider app shell | Open a shell inside the app's container |
cloider app status | Print the app's status |
cloider app update | Change the app's port or start command |
cloider app usage | Show the app's usage and cost this month |
cloider deploy | Deploy a directory as an app, creating the app the first time |
cloider git | Connect GitHub, GitLab or Bitbucket, and browse what apps can deploy from |
cloider git branches | List a repository's branches |
cloider git connect | Connect a git account, in the browser |
cloider git disconnect | Disconnect a git account |
cloider git installations | List the connected accounts of a git provider |
cloider git repos | List the repositories a connected account gives access to |
Domains, DNS and routing
cloider domain, cloider dns and cloider target manage domains, their DNS records and their routes. Aliases: domains, targets.
| Command | Description |
|---|---|
cloider domain | Manage free subdomains and custom domains |
cloider domain check | Check whether a free subdomain can be claimed |
cloider domain create | Claim a free subdomain, or add a domain you own |
cloider domain delete | Delete a domain, with its DNS records and targets |
cloider domain get | Show a domain and its targets |
cloider domain list | List domains, whatever their status |
cloider dns | Manage the DNS records of custom domains |
cloider dns create | Add a DNS record |
cloider dns delete | Delete a DNS record |
cloider dns get | Show a DNS record |
cloider dns list | List a domain's DNS records |
cloider dns update | Change a DNS record, keeping what isn't given |
cloider target | Route a domain's paths to apps, bucket websites or cluster services |
cloider target create | Route a path of a domain to an app, a bucket website or a cluster service |
cloider target delete | Delete a target |
cloider target list | List a domain's targets |
cloider target update | Change a target, keeping what isn't given |
Support
cloider support opens and follows support requests.
| Command | Description |
|---|---|
cloider support | Open and follow support requests |
cloider support attachment | Download an attachment of a support request |
cloider support create | Open a support request |
cloider support get | Show a support request and its replies |
cloider support list | List your support requests |
cloider support reply | Reply to a support request |
Account
Usage, bills, prices, members, API tokens and the current identity. Aliases: members, tokens.
| Command | Description |
|---|---|
cloider usage | Show this month's cost so far, and the forecast, per resource |
cloider billing | List the account's monthly bills |
cloider billing show | Show a bill's items |
cloider pricing | Show current prices |
cloider member | See who has access to the account |
cloider member add | Add a member (in the dashboard) |
cloider member list | List the account's owner and members |
cloider member remove | Remove a member (in the dashboard) |
cloider member role | Change a member's role (in the dashboard) |
cloider token | See the account's API tokens |
cloider token create | Generate an API token (in the dashboard) |
cloider token list | List API tokens |
cloider token revoke | Revoke an API token (in the dashboard, or cloider logout for the CLI's own) |
cloider whoami | Show who the CLI acts as, and in which account |
Authentication and profiles
Logging in and out, and switching between accounts. Alias: profiles.
| Command | Description |
|---|---|
cloider login | Log in through the browser, or with an API token |
cloider logout | Revoke the CLI's token and forget it |
cloider profile | Switch between accounts and apis |
cloider profile add | Add or change a profile, e.g. one whose token is kept in a file of your own |
cloider profile list | List profiles |
cloider profile remove | Forget a profile, without revoking its token (see logout) |
cloider profile use | Make a profile the one in use |
The CLI itself
Version, updates, shell completion and the MCP server.
| Command | Description |
|---|---|
cloider version | Print the CLI's version |
cloider update | Update the CLI to the latest version |
cloider update disable | Stop updating automatically |
cloider update enable | Update automatically again |
cloider update status | Show the version, the latest one and whether auto-update is on |
cloider completion | Generate the autocompletion script for the specified shell |
cloider completion bash | Generate the autocompletion script for bash |
cloider completion fish | Generate the autocompletion script for fish |
cloider completion powershell | Generate the autocompletion script for powershell |
cloider completion zsh | Generate the autocompletion script for zsh |
cloider mcp | Serve Cloider to AI agents as an MCP server |
Command aliases
Most command groups also answer to a plural or a short form, and list and delete have short aliases:
| Alias | Same as |
|---|---|
cloider clusters, cloider dbs, cloider database, cloider databases, cloider buckets, cloider registries, cloider apps, cloider domains, cloider targets, cloider members, cloider tokens, cloider profiles | The singular group |
ls | list, in every group except registry, registry token, bucket key and profile. bucket ls lists files, not buckets |
rm | delete (clusters, databases, apps, domains, DNS records, targets, bucket keys, bucket policies, registry tokens, immutability rules, profiles remove) |
show | get (clusters, databases, apps) |
cloider db firewall | cloider db trusted-sources |
cloider registry repositories | cloider registry repos |
cloider registry tags | cloider registry images |
cloider registry rm-image | cloider registry rm |
cloider app deploy | cloider deploy |
Commands that work without logging in
cloider pricing, cloider version, cloider update (and its subcommands), cloider completion, cloider profile and cloider login itself work without an API token. Everything else needs one; see Authentication.
Next steps
- CLI overview for a guided first session.
- Output and scripting for JSON, exit codes and CI.
- MCP tools for the same commands as AI agent tools.
Frequently asked questions
How many commands does the Cloider CLI have?
The cloider CLI has 196 commands and subcommands, grouped into cluster, db, bucket, registry, app, deploy, git, domain, dns, target, support, the account commands (usage, billing, pricing, member, token, whoami), login, logout, profile, version, update, completion and mcp.
How do I see the help for a command in the terminal?
Add --help to any command, for example cloider db create --help, or run cloider help db create. Both show the arguments, flags and examples.
Which global flags does every command take?
--profile, --api-url, --token-file, -o/--output, -q/--quiet, --no-headers, --no-color, -y/--yes, --debug and -h/--help.