
wsrv.nl
Self-hostable image cache and resize service that processes images from URL parameters, built on nginx and libvips.
wsrv.nl is an image service. It takes an image URL and parameters in the query, fetches the image, resizes or converts it with libvips and serves the result through nginx with a cache. The repository holds the code of the public service at wsrv.nl and is meant for running on a server of one’s own. The Docker guide describes pulling the image from the GitHub Container Registry or building the container from the repository, after which the server answers on a local port.
Requests take parameters for size, fit, crop, mask, orientation, adjustment and output format, as the documentation lists them. Images are cached on the server and in a CDN, and the browser cache lifetime is a parameter as well.
Worth knowing
The public service is free and filters some origin domains, and it limits uncached requests per visitor address. The FAQ says the code can run on a server of one’s own without those limits. The server depends on libvips and nginx.
Identity
- Status
- Active
- Maintainer
- Andries Louw Wolthuizen and Kleis Auke Wolthuizen4
- Maintained by
- Individual4
- First release
- 20079
Rendering and deploy
Releases
Adoption
Sources
- 2026-11-03: links
wsrv.nl/ - 2026-11-03: links, Written in, License, GitHub stars
api.github.com/repos/weserv/images - 2026-11-03: links
wsrv.nl/docs/ - 2026-11-03: Maintainer, Maintained by, License model
raw.githubusercontent.com/weserv/images/5.x/LICENSE - 2026-11-03: Categories, Runs as
github.com/weserv/images/blob/5.x/README.md - 2026-11-03: Install with
github.com/weserv/images/blob/5.x/docker/README.md - 2026-11-03: Current major version
api.github.com/repos/weserv/images/git/refs/tags/v5.1.2 - 2026-11-03: Last release
api.github.com/repos/weserv/images/commits/v5.1.2 - 2026-11-03: First release
raw.githubusercontent.com/weserv/images/5.x/CHANGELOG.md - 2026-11-03: Contributors
api.github.com/repos/weserv/images/contributors?per_page=1