README.md

metadata

title: CPA-Manager-Plus
emoji: 📊
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 18317
pinned: false

CPA-Manager-Plus on Hugging Face Spaces

This Space runs seakee/cpa-manager-plus:latest in Docker mode.

Open

• Panel URL: /management.html
• Health check: /health
• Runtime status: /status

First setup

CPA-Manager-Plus does not bundle CPA itself. CPA must already be running somewhere else.

On first startup, if CPA_MANAGER_ADMIN_KEY is not configured, the Manager Server generates an admin key and prints it to the Space logs once. Open /management.html, enter that admin key, then configure:

• CPA URL
• CPA Management Key
• request monitoring settings

After setup, use the Manager Server admin key to log in.

Optional Space Variables / Secrets

Variables:

• CPA_UPSTREAM_URL
• USAGE_COLLECTOR_MODE (optional, default auto)
• USAGE_POLL_INTERVAL_MS (optional, default 500)
• USAGE_CORS_ORIGINS (optional, default *)

Secrets:

• CPA_MANAGER_ADMIN_KEY
• CPA_MANAGEMENT_KEY
• CPA_MANAGER_DATA_KEY

Data persistence

CPA-Manager-Plus stores configuration, encrypted credentials, and usage analytics under /data.

• SQLite database: /data/usage.sqlite
• encryption key file: /data/data.key
• Attach Hugging Face persistent storage if you want data to survive rebuilds and restarts.
• Without persistent storage, setup data and analytics may be lost after the container is rebuilt.

Notes

• Recommended CPA version: >= 7.1.39.
• Minimum CPA version for HTTP usage queue: >= 6.10.8.