Spaces:
Paused
Paused
| 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](https://hub.docker.com/r/seakee/cpa-manager-plus) 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`. | |