imgforge 0.17.0

Fast and secure image proxy and transformation server
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

# 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.