---
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`.