imgforge

imgforge is a fast, secure image proxy and transformation server written in Rust. Built with Rust and libvips, it delivers imgproxy-compatible URL semantics with an async-first architecture and optional, pluggable caching backends.

Forge image with Imgforge

• Production-ready from day one – Health checks, structured logging, and Prometheus metrics make imgforge easy to drop into modern platforms.
• Container-native – Ship the provided multi-stage Docker image anywhere, or extend it with your own watermark assets and presets.
• High-fidelity transforms – Resize, crop, format-convert, blur, sharpen, watermark, and more—powered by libvips for incredible performance.
• Defense in depth – Signed URLs, bearer tokens, per-request safeguards, and global rate limiting protect your origins from abuse.

Get started in minutes

One-line deployment (Recommended)

Deploy imgforge on any Linux machine with a single command:

curl -fsSL https://raw.githubusercontent.com/ImgForger/imgforge/main/deployment/deploy.sh | bash

The interactive script will:

• Install Docker (if needed)
• Let you choose a caching strategy (Memory, Disk, Hybrid, or None)
• Optionally enable Prometheus + Grafana monitoring with pre-built dashboards
• Generate secure keys automatically
• Start imgforge on port 3000

See the deployment guide for more options.

Manual Docker setup

Generate development-only values with OpenSSL:

openssl rand -hex 32

docker pull ghcr.io/imgforger/imgforge:latest
docker run --rm -p 3000:3000 \
  -e IMGFORGE_KEY=<generated_key> \
  -e IMGFORGE_SALT=<generated_salt> \
  -e IMGFORGE_LOG_LEVEL=imgforge=info \
  ghcr.io/imgforger/imgforge:latest

Then follow the Quick Start guide to sign URLs and try your first transformation. Prefer bare-metal builds or CI integrations? See Installation for native toolchain instructions.

Documentation

The documentation is live on the docs site.

Community

Issues and pull requests are welcome. Please review the contributing guide before submitting significant changes. If you are upgrading from imgproxy, most existing URL builders will continue to work—consult the processing and URL references for the few imgforge-specific differences.