Skip to main content

Install TagSpaces Web with Docker

Here you will find information about using TagSpaces Lite Web and TagSpaces Pro Web as Docker containers. The containers are lightweight based on the alpine linux and using nginx as web server.

Get Docker​

Install Docker for your operating system: https://docs.docker.com/get-docker/

Get the TagSpaces Lite Web Image​

You can download the latest available TagSpaces Lite docker image from the hub.docker.com or by the following command:

docker pull tagspaces/tagspaces-lite-web

Alternatively: Build Your Own Image​

Download TagSpaces Lite Web​

For getting the free web version of TagSpaces, go to the download page and click on the package.zip.

Download TagSpaces Pro Web​

For the PRO web version, open the purchase confirmation email and download the web version from there.

Build the image​

Download the TagSpaces' Dockerfile from GitHub.

Place the download ZIP of TagSpaces Lite or Pro in the same folder where your TagSpaces' Dockerfile is located, rename it to tagspaces-web.zip and run:

docker build -t tagspaces-lite-web:5.4.4 .

The name tagspaces-lite-web after the -t switch can be changed to anything else, for example, if you are building a docker container for the PRO version you can choose tagspaces-pro-web. The version number at the end should correspond the version of TagSpaces in the ZIP file. It is optional but helps if you have many TagSpaces containers.

Run the Image​

Once the container is build you can run it with this command:

docker run -dp 127.0.0.1:5000:80 tagspaces-lite-web:5.4.4

Where 5000 is the port on your local machine which is forwarded to port 80 of the docker container.

Test app in your browser​

If everything went well, open your browser and enter localhost:5000 in the URL text field and you should see TagSpaces in your browser.

Add basic auth​

The easiest way to secure your TagSpaces installation is to add a basic auth in front of it.

sudo docker cp ./default.conf tagspaces-lite-web:/etc/nginx/conf.d/

Details on how to prepare the default.conf file can be found in the Nginx documentation

Add TagSpaces custom configuration​

TagSpaces can be partially configured with an external configuration file. It should be called extconfig.js and placed in the root folder of the application.

sudo docker cp ./extconfig.js tagspaces-lite-web:/usr/share/nginx/html/

The following example extconfig.js will allow location information to be saved in the browser's local storage in order to persist after an application reload.

// enables saving of location data in the browser's local storage, in order to persist after reload
window.ExtSaveLocationsInBrowser = true;

Installing self-signed SSL certificate​

TBD

Installing SSL certificate from Let's encrypt​

TBD

SSL certificates are needed for your TagSpaces installation and for the object storage service (e.g. Minio, Zenko)

A good tutorial for Ubuntu and Apache is this one: How to Set up Let's Encrypt on an Intranet Website

Renew the SSL certificate​

TBD