Skip to main content
NekoHub is configured through environment variables. With Docker Compose, copy .env.example to .env and update the values.
Do not use placeholder values in production. Replace Auth__Jwt__Secret, Auth__BootstrapSuperAdmin__Password, and all API keys before first deployment.

​
Database

​
string
required
PostgreSQL connection string.
​
string
default:"postgresql"
Database provider. The current codebase supports postgresql.

​
JWT

​
string
required
JWT signing secret. Use at least 32 characters.
​
string
default:"NekoHub"
JWT issuer (iss) claim. Signed and validated by the backend.
​
string
default:"NekoHub.Admin"
JWT audience (aud) claim. Signed and validated by the backend.
​
number
default:"15"
Access token lifetime in minutes.
​
number
default:"30"
Refresh token lifetime in days.

​
Bootstrap super admin

​
string
required
Username for the initial SuperAdmin.
​
string
required
Password for the initial SuperAdmin.
Bootstrap only runs when the database has no SuperAdmin. Changing these values later does not overwrite an existing account.

​
API key

​
boolean
default:"false"
Enables API key authentication. When disabled, /mcp and Bearer API key requests are rejected.
​
string
The first API key. Add more keys as Keys__1, Keys__2, and so on.

​
Storage

​
string
required
Runtime provider selection. Supported values are local, s3, and github-repo.
​
string
required
Public URL prefix used for browser-reachable content links.
​
string
default:"/app/storage/assets"
Local filesystem path used by the local provider.

​
Frontend

​
string
required
Base URL the browser uses to reach the API. Leave empty for same-origin reverse proxies.
​
string
default:"true"
Allowed hosts for the Vite preview server.
​
number
default:"10485760"
Frontend upload size limit in bytes.
​
number
default:"5173"
Frontend container port.