VisualSFM on MacOS with Docker

It is hard to get VisualSFM running on a current MacOS. But this short article shows how to use VisualSFM on MacOS by running a Docker container. I am running it on a MacBook Pro 2018, without Nvidia chipset. That is the reason why the following instructions show how to use VisualSFM with CPU (SIFT) support. Don’t worry it will run with an acceptable speed for photogrammetry.

Installing Docker

First you need to install Docker on your system. Go to the following address, download and install docker. It is free but it might be that you need to register before you are able to download.

https://store.docker.com/editions/community/docker-ce-desktop-mac

After docker is installed and started, the small whale icon in the top left corner will indicate that, you can install the needed VisualSFM image and container. There is a ready to use image available, but we need to do a few changes to it. Create a file called Dockerfile in an empty folder with the following content:

From ryanfb/visualsfm
RUN apt-get update
RUN apt-get install -y libglu1-mesa

This will create a custom image based on the ryanfb/visalsfm image but with additional packages installed. Afterwards you can build the container with the command

 docker build -t visualsfm .

Call the command within your created folder where the Dockerfile is located. The build process will take a while.

Installing XQuartz

During the build you can install XQuartz. This is needed to use the UI of VisualSFM. Take the latest version from

https://www.xquartz.org

After it is installed launch a Terminal and call

open -a XQuartz

to enter the XQuartz preferences. You need to change the permissions of XQuartz. Go to the Security tab and check the boxes like the image below shows.

Since XQuartz does not support indirect GLX no longer by default. You need to open a terminal and activate indirect GLX support by executing:

defaults write org.macosforge.xquartz.X11 enable_iglx -bool true

The close all opened terminals and try to run the docker container, when the build process is done.

Running the Installation

Open a new terminal. First we need to allow X-Forwarding. This can be done by typing in the terminal.

xhost +

Docker is now allowed to use the XQuartz on the host system to forward UI output to it. Afterwards you can start the VisualSFM docker image with

docker run -it --privileged -e DISPLAY=docker.for.mac.localhost:0 -v /tmp/.X11-unix:/tmp/.X11-unix ryanfb/visualsfm /root/vsfm/bin/VisualSFM

When it woks you can close the window and rerun it with some image folders mounted to the docker container.

docker run -it --privileged -e DISPLAY=docker.for.mac.localhost:0 -v pathtoyourimages:/mnt -v /tmp/.X11-unix:/tmp/.X11-unix ryanfb/visualsfm /root/vsfm/bin/VisualSFM

You will find your images to process in the /mnt folder. You can also mount the images to /media.

I hope this will help you a little bit to get started on MacOS with VisualSFM. Maybe I missed some details. If you will have problems feel free to leave a comment.