Knot Docker#

IMPORTANT
This is a community maintained repository, support is not guaranteed.

Docker container and compose setup to run a Tangled knot and host your own repository data.

Building The Image#

By default the Dockerfile will build the latest tag, but you can change it with the TAG build argument.

docker build -t knot:latest --build-arg TAG=master .

The command above for example will build the latest commit on the master branch.

This can be done in a compose file as well by specifying it as an build argument.

build:
  context: .
  args: { TAG: master }

Will tell docker to pass the TAG argument to the Dockerfile when building.

Setting Up The Image#

The simplest way to set up your own knot is to use the provided compose file and run the following:

export KNOT_SERVER_HOSTNAME=example.com
export KNOT_SERVER_SECRET=KNOT_TOKEN_HERE
export KNOT_SERVER_PORT=443
docker compose up -d

This will setup everything for you including a reverse proxy.