Looking Glass: 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
With a custom CSS and logo
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