Paquetier is configured entirely through environment variables, all prefixed with PAQUETIER_.
Server
| Variable |
Default |
Description |
PAQUETIER_SERVER_ADDR |
:8080 |
Address and port the server listens on |
PAQUETIER_PUBLIC_URL |
http://localhost:8080 |
The public-facing URL of the instance |
PAQUETIER_ROOT_PATH |
— |
Root path for reverse proxy sub-path deployments |
PAQUETIER_LOG_LEVEL |
info |
Log level: trace, debug, info, warn, error |
PAQUETIER_ENABLE_SWAGGER |
true |
Enable the Scalar-powered API documentation at /api/v1/docs |
Database
| Variable |
Default |
Description |
PAQUETIER_DATABASE_DSN |
— |
Database connection string. Use postgresql://... for production. If unset, falls back to SQLite. |
Storage (S3)
| Variable |
Default |
Description |
PAQUETIER_S3_ENDPOINT |
— |
S3-compatible endpoint |
PAQUETIER_S3_BUCKET |
— |
Default bucket name |
PAQUETIER_S3_ACCESS_KEY |
— |
S3 access key |
PAQUETIER_S3_SECRET_KEY |
— |
S3 secret key |
PAQUETIER_S3_SSL |
true |
Use HTTPS for S3 connections |
PAQUETIER_S3_REGION |
— |
S3 region |
PAQUETIER_S3_FORCE_PROXY |
false |
Stream downloads through the server instead of S3 presigned redirects |
CDN
Package downloads can redirect to a CDN pull zone in front of the bucket instead of an S3 presigned URL.
Presigned URLs differ on every request, so a CDN cannot cache them; CDN URLs are stable per file and signed with the CDN’s token authentication.
PAQUETIER_S3_FORCE_PROXY takes precedence over the CDN, which takes precedence over presigned S3 redirects.
PACKAGES indexes are always served by Paquetier, so new uploads show up immediately.
| Variable |
Default |
Description |
PAQUETIER_CDN_BASE_URL |
— |
Base URL of the pull zone, e.g. https://pkgs.example.b-cdn.net. Downloads redirect to <base>/<storage key>. |
PAQUETIER_CDN_TOKEN_KEY |
— |
Token authentication key of the pull zone (bunny.net). When set, redirects carry a signed token and expires and the edge refuses unsigned or expired requests. |
PAQUETIER_CDN_TOKEN_EXPIRY |
15m |
Lifetime of a signed CDN URL |
The setting is global and applies to every repository, so the pull zone must front the bucket all repositories use.
Keep the bucket private and let the pull zone read it with its own S3 credentials (bunny.net’s S3-authenticated origin), configured on the CDN side.
Always set PAQUETIER_CDN_TOKEN_KEY and enable token authentication on the pull zone when any repository is private; without it, anyone with a file’s URL can download it from the CDN.
A deleted version’s tarball can stay cached at the edge until its cache TTL expires, but Paquetier no longer lists or signs it.
Authentication
| Variable |
Default |
Description |
PAQUETIER_JWT_SECRET |
— |
Required. Secret key for signing JWT tokens. Must be stable across restarts. |
PAQUETIER_SESSION_EXPIRES |
72h |
JWT session token duration |
PAQUETIER_LOCAL_AUTH |
true |
Enable username/password authentication |
PAQUETIER_REGISTRATION_OPEN |
true |
Allow new user registration |
OAuth2
| Variable |
Default |
Description |
PAQUETIER_OAUTH2_CLIENT_ID |
— |
OAuth2 client ID |
PAQUETIER_OAUTH2_CLIENT_SECRET |
— |
OAuth2 client secret |
PAQUETIER_OAUTH2_AUTH_URL |
— |
OAuth2 authorization endpoint |
PAQUETIER_OAUTH2_TOKEN_URL |
— |
OAuth2 token endpoint |
PAQUETIER_OAUTH2_REDIRECT_URL |
— |
OAuth2 redirect URL |
Build System
| Variable |
Default |
Description |
PAQUETIER_R_PATH |
R |
Path to the R binary |
PAQUETIER_BUILD_LOG_DIR |
build-logs |
Directory for storing build logs |
Admin
| Variable |
Default |
Description |
PAQUETIER_LOCAL_STORAGE_POLICY |
all |
Who can create local filesystem storage connections: all or admin_only |
Scans
These tune the durable-scan and HA-coordination behaviour described in Scanning Existing Repos.
Defaults are sane for single-instance and small HA setups; touch them only if you have a specific reason.
| Variable |
Default |
Description |
PAQUETIER_SCAN_LEASE_TTL |
60s |
How long a scan lease is valid without a heartbeat extension. After expiry, peers may take over. |
PAQUETIER_SCAN_HEARTBEAT_INTERVAL |
15s |
How often the scan owner extends its lease and persists progress. Must be less than half of LEASE_TTL. |
PAQUETIER_SCAN_RECONCILE_INTERVAL |
30s |
How often this instance scans for abandoned scans to take over. |
PAQUETIER_SCAN_MAX_CONCURRENT |
4 |
Maximum scans this instance will run simultaneously. Prevents one peer from greedy-grabbing every abandoned scan. |
PAQUETIER_SCAN_STREAM_POLL_INTERVAL |
1s |
Polling cadence for the cross-instance stream fallback (when a client connects to an instance that does not own the scan). |