# zimgx

> Fast, single-binary image proxy and transformation server. A self-hosted drop-in replacement for Cloudflare Images.

## Docs

- [Architecture](/architecture): zimgx is a single-threaded HTTP image proxy. It fetches images from a configurable origin, transforms them with libvips, and serves results through a multi-tier cache.
- [Configuration](/configuration): zimgx reads all configuration from environment variables prefixed with `ZIMGX_`. Every variable is optional and has a sensible default.
- [Deployment](/deployment): zimgx ships as a multi-arch Docker image (`linux/amd64`, `linux/arm64`) built on Alpine Linux.
- [Getting started](/getting-started): This produces a binary at **zig-out/bin/zimgx**.
- [Migrating from Cloudflare Images](/migrating-from-cloudflare): This page covers how to move from Cloudflare Images (imagedelivery.net) to zimgx. It maps Cloudflare's URL parameters to zimgx equivalents and outlines the differences between the two.
- [Transform parameters](/transforms): Specify transforms as the last path segment in the URL. zimgx treats a segment as a transform string when it contains `=`. Separate multiple parameters with commas.