A lightweight, high-performance Nx cache server.
10K+
A lightweight, self-hosted Nx remote cache server with S3-compatible storage backend.
Create a config.yaml file:
port: 3000
buckets:
- name: minio-bucket
bucketName: nx-cache
accessKeyId: minioadmin
secretAccessKey: minioadmin
region: us-east-1
endpointUrl: http://localhost:9000
forcePathStyle: true
serviceAccessTokens:
- name: local-dev
bucket: minio-bucket
prefix: /local
accessToken: your-secure-bearer-token
Run with Docker:
docker run -d \
-p 3000:3000 \
-v $(pwd)/config.yaml:/nx-cache-server/config.yaml:ro \
philiplehmann/nx-cache-server:2.2.2
Or use Docker Compose:
version: '3.8'
services:
nx-cache-server:
image: philiplehmann/nx-cache-server:2.2.2
ports:
- "3000:3000"
volumes:
- ./config.yaml:/nx-cache-server/config.yaml:ro
restart: unless-stopped
Set environment variables:
export NX_SELF_HOSTED_REMOTE_CACHE_SERVER=http://localhost:3000
export NX_SELF_HOSTED_REMOTE_CACHE_ACCESS_TOKEN=your-bearer-token
See Nx Self-Hosted Caching Documentation for details.
For complete examples including MinIO, AWS S3, multiple buckets, and more, see:
| Field | Required | Description |
|---|---|---|
name | Yes | Unique identifier |
bucketName | Yes | S3 bucket name |
region | No | AWS region (auto-discovered if omitted) |
accessKeyId | No | AWS access key (or use accessKeyIdEnv) |
secretAccessKey | No | AWS secret key (or use secretAccessKeyEnv) |
endpointUrl | No | Custom S3 endpoint (for MinIO, etc.) |
forcePathStyle | No | Required for MinIO (default: false) |
timeout | No | S3 timeout in seconds (default: 30) |
| Field | Required | Description |
|---|---|---|
name | Yes | Token identifier |
bucket | Yes | References bucket name |
prefix | Yes | S3 key prefix (use "" for root) |
accessToken | Yes* | Bearer token (or use accessTokenEnv) |
*Either accessToken or accessTokenEnv required
Supports linux/amd64 and linux/arm64.
Content type
Image
Digest
sha256:1ed9924b4…
Size
35.4 MB
Last updated
5 days ago
docker pull philiplehmann/nx-cache-server