https://github.com/imgforger/imgforge

Fast, secure image proxy and transformation server written in Rust
https://github.com/imgforger/imgforge

axum cache crop-image docker image image-manipulation image-processing jpeg libvips png resize-images rust watermark

Last synced: 3 months ago
JSON representation

Fast, secure image proxy and transformation server written in Rust

• Host: GitHub
• URL: https://github.com/imgforger/imgforge
• Owner: ImgForger
• License: gpl-3.0
• Created: 2025-10-02T05:38:29.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2025-12-13T10:40:59.000Z (6 months ago)
• Last Synced: 2026-01-02T16:46:04.404Z (6 months ago)
• Topics: axum, cache, crop-image, docker, image, image-manipulation, image-processing, jpeg, libvips, png, resize-images, rust, watermark
• Language: Rust
• Homepage: https://imgforger.github.io
• Size: 756 KB
• Stars: 4
• Watchers: 1
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          
# imgforge

[![crates.io](https://img.shields.io/crates/v/imgforge.svg)](https://crates.io/crates/imgforge)

[![Build](https://github.com/ImgForger/imgforge/actions/workflows/build.yml/badge.svg)](https://github.com/ImgForger/imgforge/actions/workflows/build.yml)

[![Release](https://github.com/ImgForger/imgforge/actions/workflows/release.yml/badge.svg)](https://github.com/ImgForger/imgforge/actions/workflows/release.yml)

[![dependency status](https://deps.rs/repo/github/ImgForger/imgforge/status.svg)](https://deps.rs/repo/github/ImgForger/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:

```bash

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

## Documentation

The documentation is live on the [docs site](https://imgforger.github.io/).

## Community

Issues and pull requests are welcome. Please review the [contributing guide](CONTRIBUTING.md) 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.