Skip to content

📱 asc app ​

Manage apps: your own; run under sudo to manage everyone's.

Usage ​

asc app <action> [args]

list ​

List apps. Root sees all users' apps, grouped by owner.

info ​

asc app info <id>

Show one app's details.

disk ​

asc app disk [id]

Show disk usage: a quota bar (if a quota is set) and a breakdown by image, repository, data and custom volumes. Without an id: total space occupied by all apps, then each app's usage, largest first. Shorthand for the whole-fleet view: asc disk.

ports ​

asc app ports [id]

Show published ports (host==container) with their transport. Without an id: every app and its ports as a table. Shorthand for the whole-fleet view: asc ports.

clone ​

asc app clone <id> [--name <name>]

Clone an app instance (data, env, settings) into a new one.

  • --name <name> — custom name for the clone (skips the interactive prompt).

install ​

asc app install <spec> [--source <name>] [--name <name>] [--branch <branch> | --tag <tag>] [--path <subdir>] [--app <stack app>] [--force] [--image | --build]

Install an app from a registry or a git repository URL — same as top-level asc install, see its page for all flags.

attach ​

asc app attach <id>

Attach to the app's console — same as top-level asc attach.

upgrade ​

asc app upgrade <spec>

Upgrade the app to a new version — same as top-level asc upgrade.

start ​

asc app start <id> [-d|--detach]

Start the app and attach to its console (Docker apps, interactive terminal).

  • -d, --detach — start in the background without attaching.

stop ​

asc app stop <id>

restart ​

asc app restart <id>

logs ​

asc app logs <id> [-n|--tail <n>]

Show app logs.

  • -n, --tail <n> — number of trailing lines. Default: 100.

settings ​

asc app settings <id>

Interactively edit app settings defined in asc.settings.yaml.

remove ​

asc app remove <id> [-y|--yes]

Remove an app and all its data.

  • -y, --yes — confirm removal without prompting.

See also ​

Released under the MIT License.