Open sourceSelf-hosted service

PixelServe

PixelServe is an open-source image processing microservice by Climactic, built with Bun, ElysiaJS and Sharp. It transforms images on the fly and generates Open Graph images through URL parameters, and you host it yourself.

Install

docker pull ghcr.io/climactic/pixelserve:latest
docker run -p 3000:3000 ghcr.io/climactic/pixelserve:latest
Type
Self-hosted service
Requires
Docker, or the Bun runtime to run it from source
License
AGPL-3.0
Maintained by
Climactic

What it does

Transform by URL
Resize, crop, rotate, blur, sharpen, tint and watermark an image with query parameters.
Modern formats
Convert to WebP, AVIF, PNG, JPEG or GIF and set the quality.
Open Graph images
Generate share images from templates with no headless browser, in any Google Font.
Your own templates
Use the built-in templates, or define your own in JSON.
Caching
Disk, memory, Redis or hybrid caches, with headers that suit a CDN.
Safe to expose
SSRF protection, domain allowlists, and limits on image size and dimensions.

Example

Transform an image, and generate a share image.

GET /image?url=https://example.com/photo.jpg&w=800&h=600&format=webp

GET /og?title=Hello%20World&description=My%20awesome%20page&template=gradient
  • PixelServe is licensed under AGPL-3.0. If you host a modified copy, that license asks you to publish your changes.
Read the full documentation on GitHub

Questions about PixelServe

What is PixelServe?

PixelServe is an open-source image processing microservice by Climactic, built with Bun, ElysiaJS and Sharp. It transforms images on the fly and generates Open Graph images through URL parameters, and you host it yourself.

How do I install PixelServe?

Run "docker pull ghcr.io/climactic/pixelserve:latest". It needs Docker, or the Bun runtime to run it from source.

Is PixelServe free to use?

Yes. PixelServe is open source under the AGPL-3.0 license, and the source code is on GitHub at github.com/Climactic/PixelServe.

Is PixelServe used in production?

Yes. PixelServe runs in production in Markdown Anything and ColorBuk, products that Climactic builds and operates.

Who maintains PixelServe?

Climactic, a venture studio that builds and operates its own software products, maintains PixelServe.

More open source from Climactic