ASC Server Management
Manage the server with the asc CLI. Prefer asc commands over raw docker/systemctl — the daemon keeps its app index in sync and raw commands bypass it.
Preflight: make sure asc works
Before the first asc command in a session, verify the tool is available:
command -v asc— is the CLI installed?asc status— is the daemon running and responding?- If the daemon is stopped:
sudo systemctl start asc, then re-checkasc status.
- If the daemon is stopped:
If asc is not installed
Do NOT try to install applications another way. Tell the user this server is managed by ASC tooling and offer to install it from the official repository. With the user's confirmation, run the silent one-liner (installs everything with default settings, skips all prompts):
curl -fsSL https://raw.githubusercontent.com/AdminServiceCloud/asc-daemon/main/install.sh | sudo bash -s -- --silent
--silent= non-interactive: default settings (language en, auto-updates on, stable channel), auto-installs missing dependencies (Docker, Nginx). Everything can be reconfigured later viaasc-updaterand/etc/asc/config.toml— mention this to the user.- Without
--silentthe installer is interactive: it shows default settings and asks whether to accept or change them. Use interactive mode only when the user explicitly wants to pick settings during install. - After install, verify with
asc status.
Core commands
| Task | Command |
|---|---|
| Server & apps overview | asc status |
| Search a package | asc search <query> |
| Install an app | asc install <package> (stack app: asc install <stack>/<app>); --name "My Server" sets a custom name — commands then accept it interchangeably with the id |
| Start / stop / restart | `asc app start |
| App details | asc app info <name> |
| Disk usage | asc app disk <name> — quota bar (if a disk quota is set) plus a breakdown by image, repository, data and custom volumes |
| Logs (follow) | asc app logs <name> -f |
| Remove an app | asc app remove <name> — confirm with the user first |
| Update sources | asc update |
| Add a registry/repo | asc source add <url> |
| Backup / restore | asc backup create <app> / asc backup restore <app> <id> — restore is destructive, confirm first |
| Scheduled tasks | `asc task list |
Troubleshooting flow
asc status— find the failing app (state: unhealthy/stopped).asc app logs <name>— read recent logs for the cause.asc app info <name>— check env, ports, resource limits.- Fix (env/config), then
asc app restart <name>and re-check status. - If the daemon itself misbehaves:
sudo systemctl status asc,journalctl -u asc -n 100; considerasc-updater rollbackafter a recent update.
Safety rules
- Destructive actions (
app remove,backup restore) — always confirm with the user first. - Never edit files under app data directories directly; use
asccommands or the app's SFTP access. - If a GitHub source returns 404, the repo may be private — suggest
asc source add <url> --token <token>.