# wsrv.nl

Self-hostable image cache and resize service that processes images from URL parameters, built on nginx and libvips.


Source: https://findsoftware.frbit.cloud/weserv-images/
Last reviewed: 2026-11-03
Listed since: 2026-11-03

## Record

### Links

- home: https://wsrv.nl
- repository: https://github.com/weserv/images
- docs: https://wsrv.nl/docs/

### Identity

- status: active
- maintainer: Andries Louw Wolthuizen and Kleis Auke Wolthuizen
- maintainerType: individual
- parent: unknown
- firstRelease: 2007
- hqCountry: unknown

### Kind

- category: media
- hosting: unknown
- language: cpp
- runtime: unknown
- runtimeMin: unknown
- basedOn: unknown

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: not applicable

### Rendering and deploy

- runsAs: always-on
- renderingModes: not applicable
- installMethod: docker image ghcr.io/weserv/images

### License

- licenseModel: open-source
- license: BSD-3-Clause

### Releases

- currentMajor: 5
- latestReleaseDate: 2026-11-01

### Adoption

- githubStargazers: 2855
- packagistDownloads: not applicable
- npmWeeklyDownloads: not applicable
- contributors: 5
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: unknown
- dependentPackages: unknown

### Sources

- urls: https://wsrv.nl/ (read 2026-11-03)
- urls: https://api.github.com/repos/weserv/images (read 2026-11-03)
- urls: https://wsrv.nl/docs/ (read 2026-11-03)
- maintainer: https://raw.githubusercontent.com/weserv/images/5.x/LICENSE (read 2026-11-03)
- maintainerType: https://raw.githubusercontent.com/weserv/images/5.x/LICENSE (read 2026-11-03)
- language: https://api.github.com/repos/weserv/images (read 2026-11-03)
- category: https://github.com/weserv/images/blob/5.x/README.md (read 2026-11-03)
- runsAs: https://github.com/weserv/images/blob/5.x/README.md (read 2026-11-03)
- installMethod: https://github.com/weserv/images/blob/5.x/docker/README.md (read 2026-11-03)
- installMethod: https://github.com/weserv/images/blob/5.x/docker/README.md (read 2026-11-03)
- license: https://api.github.com/repos/weserv/images (read 2026-11-03)
- licenseModel: https://raw.githubusercontent.com/weserv/images/5.x/LICENSE (read 2026-11-03)
- currentMajor: https://api.github.com/repos/weserv/images/git/refs/tags/v5.1.2 (read 2026-11-03)
- latestReleaseDate: https://api.github.com/repos/weserv/images/commits/v5.1.2 (read 2026-11-03)
- firstRelease: https://raw.githubusercontent.com/weserv/images/5.x/CHANGELOG.md (read 2026-11-03)
- githubStargazers: https://api.github.com/repos/weserv/images (read 2026-11-03)
- contributors: https://api.github.com/repos/weserv/images/contributors?per_page=1 (read 2026-11-03)

## Notes

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](https://github.com/weserv/images/blob/5.x/docker/README.md) 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](https://wsrv.nl/docs/) 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.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0