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. In knot-docker directory, create Docker image with docker build -t knot:latest --build-arg TAG=master --build-arg UID=$(id -u www-data) --build-arg GID=$(id -u www-data) .
2. In this directory, create bind mount directories with mkdir keys repositories server
3. Ensure repositories and server are owned by www-data with chown www-data:www-data repositories server
4. Edit docker-compose.yml with appropriate KNOT_SERVER_HOSTNAME and KNOT_SERVER_OWNER
5. Create Docker container with docker-compose up -d
6. 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!)

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.