AgentSkillsCN

casaos-docker

在 CasaOS 系统上管理 Docker 容器。适用于在 CasaOS 环境中操作 Docker 容器时使用，尤其可用于定位 /DATA/AppData/ 中的持久化数据、管理 CasaOS 安装的应用程序，或深入了解 CasaOS 特有的 Docker 卷规范。CasaOS 将应用配置存储于 /var/lib/casaos/apps/，并将用户数据存储于 /DATA/AppData/。

SKILL.md
--- frontmatter
name: casaos-docker
description: Manage Docker containers on CasaOS systems. Use when working with Docker containers in a CasaOS environment, especially for locating persistent data at /DATA/AppData/, managing CasaOS-installed apps, or understanding CasaOS-specific Docker volume conventions. CasaOS stores app configs at /var/lib/casaos/apps/ and user data at /DATA/AppData/.

CasaOS Docker Management

CasaOS is a home server management platform that wraps Docker with a web UI and specific conventions for storage and configuration.

Key Differences from Standard Docker

AspectStandard DockerCasaOS
Compose filesUsually in project directories/var/lib/casaos/apps/<app-name>/docker-compose.yml
Persistent dataVarious locationsAlways /DATA/AppData/<app-name>/
Managementdocker CLI + composeWeb UI + CasaOS backend
App installsManual or composeOne-click from AppStore

Critical Paths

code
/DATA/AppData/           # All persistent container data
/var/lib/casaos/apps/    # Docker compose files managed by CasaOS
/var/lib/casaos/         # CasaOS system data
/etc/casaos/             # CasaOS configuration

Common Tasks

Backup Before Editing Compose Files

⚠️ Always backup before modifying CasaOS compose files:

bash
cp /var/lib/casaos/apps/<app-name>/docker-compose.yml \
   /var/lib/casaos/apps/<app-name>/docker-compose.yml.bak.$(date +%Y%m%d-%H%M%S)

CasaOS manages these files and can overwrite manual changes.

Find App Data Location

Always look in /DATA/AppData/<app-name>/ first:

bash
ls /DATA/AppData/<app-name>/

Backup a CasaOS App

Back up the persistent data directory:

bash
# Example: backup n8n
tar -czf n8n-backup-$(date +%Y%m%d).tar.gz /DATA/AppData/big-bear-n8n/

Locate Compose Files

bash
find /var/lib/casaos/apps -name "docker-compose.yml"

Restart App via CasaOS

bash
# CasaOS manages containers through its API
# Use docker restart only if needed:
docker restart <container-name>

App Data Organization

CasaOS apps follow consistent patterns in /DATA/AppData/:

  • •Config files → typically in app root
  • •Databases → db/, pgdata/, or similar subdirectory
  • •Uploads/data → data/, uploads/, or app-specific

Example:

code
/DATA/AppData/big-bear-n8n/
├── db/                    # SQLite or config DB
└── pgdata/                # PostgreSQL data (if using Postgres)

/DATA/AppData/librechat/
├── mongodb_data/          # MongoDB
└── meilisearch/           # Search index

References