Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


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

Build Status

Dockerfiles to run the XtreemFS services in containers.

Before building the XtreemFS images, ensure that you have the current Ubuntu baseimage by running

docker pull ubuntu

The images for the DIR, MRC, and OSD services are derived from a common image named xtreemfs/xtreemfs-common. The containers are build from the XtreemFS Git repository at After cloning the repositoring by running

git clone
cd xtreemfs-docker

start with building the xtreemfs/xtreemfs-common through executing

docker build -t xtreemfs/xtreemfs-common xtreemfs-common/

to build the common image. Continue with the service specific images

docker build -t xtreemfs/xtreemfs-dir xtreemfs-dir/
docker build -t xtreemfs/xtreemfs-mrc xtreemfs-mrc/
docker build -t xtreemfs/xtreemfs-osd xtreemfs-osd/

Service configuration files are expected to be mapped into /xtreemfs_data. The config files have to be named,, and Example configuration files for each service are provided in the config-examples directory. A new service can be startet for instance by running

docker run -v /xtreemfs_data:/xtreemfs_data -p 32640:32640 -t -d xtreemfs/xtreemfs-osd:latest

while the config is stored in /xtreemfs_data/ on the host. Network ports have to be mapped adequately while executing docker run. Default ports are 32636 for the MRC, 32638 for the DIR, and 32640 for the OSD. You have to ensure that services register with the correct address at the DIR service, this can be achieved by setting the "hostname" parameter for the MRC and OSD service.

The provided client images contains the XtreemFS FUSE client and can be used to build customized images for own services or run it interactively. The client image is also based on the xtreemfs-common images and can be generated by executing

docker build -t xtreemfs/xtreemfs-client xtreemfs-client/

You can run the XtreemFS client in an interactive container by executing

docker run -t -i --privileged xtreemfs/xtreemfs-client /bin/bash

Note that FUSE requires to run the container in the privileged mode.

Please consider the XtreemFS user guide at and the quick start tutorial at for a general introduction to XtreemFS.


Dockerfiles to run XtreemFS services in containers






No releases published


No packages published

Contributors 4