Tangled.sh Knot #

These are the config files for the Tangled knot hosted at knot.ionchy.ca, built using knot-docker. Detailed instructions on hosting a knot can be found at knot-hosting.

Docker installation #

These instructions assume a user www-data on the host for Docker to use.

1. Create the Docker image: uid=$(id -u www-data) gid=$(id -g www-data) docker compose build
2. Create the bind mount directories: mkdir keys repositories server
3. [Optional] Create a custom motd: touch motd
4. Ensure repositories and server are owned by www-data: chown www-data:www-data repositories server
5. Edit docker-compose.yml with appropriate KNOT_SERVER_HOSTNAME and KNOT_SERVER_OWNER
6. Create Docker container: docker-compose up -d
7. Knot is now ready for reverse proxy from KNOT_SERVER_HOSTNAME:443 to local port 5555 (knot verification will not work over HTTP port 80!)
8. [Optional] Remove Docker build image with docker image prune and untag parent image with docker rmi alpine:latest

Repository troubleshooting #

• SSH keys must be added to Tangled after the knot is created for it to pick them up. Run docker exec knot knot keys to verify the keys.
• Git remote URLs must be of the form ssh://git@KNOT_SERVER_HOSTNAME:2222/KNOT_SERVER_OWNER/REPO since the container exposes port 2222 for Git. Remember to allow the port through your firewall.