Skip to content
Paquetier

Configuration

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

Mirrors

These apply to upstream mirrors. A mirror sync is a scan job, so it also counts against PAQUETIER_SCAN_MAX_CONCURRENT and follows the other scan settings above.

Variable Default Description
PAQUETIER_MIRROR_ALLOW_PRIVATE_UPSTREAMS false Let a mirror’s repository URL resolve to a private, loopback, link-local or carrier-grade NAT address. Off by default, since the server fetches whatever URL a repository owner enters. The check runs on the address actually dialed, after DNS and on every redirect.