Need help with darkroom?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

177 Stars 33 Forks MIT License 255 Commits 7 Opened issues

Services available


Need anything else?

Contributors list

Darkroom - Yet Another Image Proxy

build status Coverage Status Docs latest GoDoc Go Report Card GolangCI GitHub Release Mentioned in Awesome Go


Darkroom combines the storage backend and the image processor and acts as an

Image Proxy
on your image source.
You may implement your own
interfaces to gain custom functionality while still keeping other Darkroom Server functionality.
The native implementations focus on speed and resiliency.


Darkroom supports several image operations which are documented here.


go get -u

Other ways to run can be found here.

Metrics Support

Darkroom supports Prometheus and StatsD for tracking and monitoring metrics. You need to specify the metrics system by adding an environment variable,



The application exposes the metrics at "http:///metrics" endpoint. Since it's a pull based system, Prometheus server that is set up from docker-compose scrapes metrics from the application endpoint and its configuration can be changed in prometheus.yml.


In order to use StatsD as your metrics system, you also need to add the following env variables,

These are used to set up the StatsD client.


Darkroom currently supports grafana provisioning for Prometheus based metrics.

Grafana is preconfigured with dashboards and Prometheus as the default data source:

  • Name: Prometheus
  • Type: Prometheus
  • Url: http://prometheus:9090
  • Access: proxy

Visualization of Darkroom metrics(prometheus) on Grafana:

Contributing Guide

Read our contributing guide to learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes to Darkroom.


Darkroom is MIT licensed.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.