Overview

This is a note on my experiment with serving IIIF images using mdx.jp object storage and IIP Image (IIIF Image Server).

This is a continuation of the following article.

Docker Version of IIP Image

A Docker image for the IIPImage server is available at the following link, so I will use that.

https://hub.docker.com/r/iipsrv/iipsrv

Refer to the following article and others for installing Docker.

https://qiita.com/Marron-chan/items/570c7c7baaae3b4d6b11

Execution

Following the previous article, mount the mdx.jp object storage as follows.

s3fs satoru196 ~/s3mount   -o passwd_file=~/.passwd-s3fs   -o url=https://s3ds.mdx.jp   -o use_path_request_style -o allow_other

An important note: I added -o allow_other compared to the previous article. Without this option, the following error occurred when starting the container.

docker: Error response from daemon: error while creating mount source path '~/s3mount/iip/images': mkdir ~/s3mount: file exists

Run 'docker run --help' for more information

After adding the -o allow_other option, run the following command. It started successfully.

docker run -it -p 9000:9000 -p 8080:80 -v ~/s3mount/iip/images/:/images --rm iipsrv/iipsrv

<----------------------------------->
Thu Mar  6 22:35:43 2025

IIPImage Server. Version 1.2
*** Ruven Pillay <ruven@users.sourceforge.net> ***

Verbosity level set to 5
Running in standalone mode on socket: 0.0.0.0:9000 with backlog: 2048

Setting maximum image cache size to 10MB
Setting filesystem prefix to '/images/'
Setting filesystem suffix to ''
Setting default JPEG quality to 75
Setting default PNG compression level to 1
Setting default WebP compression level to 50
Setting maximum CVT size to 5000
Setting HTTP Cache-Control header to 'max-age=86400'
Setting 3D file sequence name pattern to '_pyr_'
Setting default IIIF Image API version to 3
Setting Allow Upscaling to true
Setting ICC profile embedding to true
Setting up JPEG2000 support via OpenJPEG
Setting image processing engine to CPU processor
OpenMP enabled for parallelized image processing with 2 threads
Setting URI mapping to iiif=>IIIF. Supported protocol: IIIF
Memcached support enabled. Connected to servers: 'localhost' with timeout 86400


Initialisation Complete.
<----------------------------------->

With this configuration, store tiled multi-resolution pyramid TIFF files in /satoru196/iip/images on the object storage, and verify access via a URL like the following:

http://:8080/iiif/image.tif/info.json

Summary

I was able to combine IIPImage Server with mdx.jp object storage. However, the response speed and other performance aspects have not yet been tested. I plan to continue experimenting.

I hope this is helpful as a reference.