Skip to content

Using Docker

This looking glass can be run inside a Docker container as long as it meets the requirements listed in the README. You can use the shipped Dockerfile or create your own to match your need.

Pulling an existing image

Looking Glass is available on Docker Hub and can be pulled from there. All official releases of Looking Glass will be pushed on Docker Hub as soon as they are released. Just run docker pull gmazoyer/looking-glass and you'll get the latest. You can also grab any tagged release by using the tag you need.

Building your own image

If you need to build you own Docker container you'll only need to have a webserver that is comfortable with interpreting PHP files. PHP version must be at least 7.0.

Usage and options

It is not recommended to add any SSH keys, the configuration file or any additional files inside the Docker image. You can still mount them while running Docker. Below you'll find examples that expose the looking glass on the port 80 of the host.

With a configuration file

docker run -p 80:80 -v $(pwd)/config.php:/var/www/html/config.php gmazoyer/looking-glass:latest

docker run -p 80:80 -v $(pwd)/config.php:/var/www/html/config.php -v $(pwd)/mystyle.css:/var/www/html/css/mystyle.css gmazoyer/looking-glass:latest

Running this Docker

If you need to automatically run the Docker container at the host startup you can write a new service. With systemd it is pretty simple to do, here is an example supposing the container has already been created and is named "looking-glass": 

[Unit]
Description=Looking Glass container
Requires=docker.service
After=docker.service

[Service]
Restart=always
ExecStart=/usr/bin/docker start -a looking-glass
ExecStop=/usr/bin/docker stop -t 2 looking-glass

[Install]
WantedBy=default.target