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>] [--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.