Getting Started
Server Requirements
Runtime and deployment requirements for Repix.
Repix has minimal runtime requirements. Use this guide when deploying or sizing your infrastructure.
Node.js
- Node.js 22.0.0 or higher (required by
package.jsonengines) - Uses modern ES features and Sharp's native bindings
Memory
- Minimum: 256 MB RAM for light workloads
- Recommended: 512 MB–1 GB for production (concurrent image processing)
- Sharp processes images in memory; higher concurrency or larger images benefit from more RAM
Platform Support
Repix runs on:
- Linux (amd64, arm64) — primary target for Docker
- macOS (Intel, Apple Silicon) — development
- Alpine Linux — used in the official Docker image (
node:22-alpine3.19)
Docker
The official Dockerfile provides:
- Multi-stage build for minimal image size
- Prebuilt Sharp binaries (no compile step in production stage)
- Non-root user (
repix) - Health check on
/health(port 3210) - Multi-platform support:
linux/amd64,linux/arm64
Ports
- 3210 — default HTTP port (configurable via
PORT)
Dependencies
Sharp depends on libvips. The Docker image includes libc6-compat for compatibility. For custom builds (e.g., Cloudflare Sandbox), install vips-dev and build tools as needed.