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.

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/

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 very 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