Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Build Status


Sipi is a high-performance media server developed by the Digital Humanities Lab at the University of Basel. It is designed to be used by archives, libraries, and other institutions that need to preserve high-quality images while making them available online.

Sipi implements the International Image Interoperability Framework (IIIF), and efficiently converts between image formats, preserving metadata contained in image files. In particular, if images are stored in JPEG 2000 format, Sipi can convert them on the fly to formats that are commonly used on the Internet. Sipi offers a flexible framework for specifying authentication and authorization logic in Lua scripts, and supports restricted access to images, either by reducing image dimensions or by adding watermarks. It can easily be integrated with Knora.

Sipi is free software, released under the GNU Affero General Public License.

It is written in C++ and runs on Linux (including Debian, Ubuntu, and CentOS) and Mac OS X.

Freely distributable binary releases will be available soon.


The documentation is online at

To build it locally, you will need MkDocs. In the root the source tree, type:

make docs-build

You will then find the manual under site/index.html.

Building from source

All should be run from inside the root of the repository.

Build and run inside Docker - recommended

$ make compile
$ make test
$ make run

Build under macOS - not recommended. You are on your own. We warned you ;-)

$ (mkdir -p ./build-mac && cd build-mac && cmake .. && make && ctest --verbose)


Releases are published on Dockerhub:

Contact Information

Lukas Rosenthaler <>

You can’t perform that action at this time.