···

       
1
       
1
       
+
       
KNOT_SERVER_HOSTNAME=<your hostname>

     

       
2
       
2
       
+
       
KNOT_SERVER_SECRET=<secret string from the tangled.sh ui>

     

···

       
1
       
1
       
 
       
Quick instructions:

     

       
2
       
2
       
 
       
- run `gen-key.sh` to generate an ssh host key

     

       
3
       
3
       
-
       
- set the server name in both `conf/Caddyfile` and in `knot.env.template`

     

       
4
       
4
       
-
       
- register a knot on tangled.sh and put the secret key in `knot.env.template`

     

       
3
       
3
       
+
       
- copy `.env.template` to `.env`

     

       
4
       
4
       
+
       
- set the server name  in `.env` to your fully-qualified domain name

     

       
5
       
5
       
+
       
- register a knot on tangled.sh and put the secret key in `.env`

     

       
5
       
6
       
 
       
- spin up the container and test that it works

     

       
6
       
7
       
 
       


     

       
7
       
8
       
 
       
The default service runs the ssh daemon on port 2222, so I use something

     

···

       
1
       
1
       
 
       
services:

     

       
2
       
2
       
 
       
  frontend:

     

       
3
       
3
       
 
       
    image: caddy:2-alpine

     

       
4
       
4
       
+
       
    command: >

     

       
5
       
5
       
+
       
      caddy

     

       
6
       
6
       
+
       
      reverse-proxy

     

       
7
       
7
       
+
       
      --from ${KNOT_SERVER_HOSTNAME}

     

       
8
       
8
       
+
       
      --to knotserver:5555

     

       
4
       
9
       
 
       
    depends_on:

     

       
5
       
10
       
 
       
      - knotserver

     

       
6
       
11
       
 
       
    ports:

     
···

       
9
       
14
       
 
       
      - "80:80"

     

       
10
       
15
       
 
       
    volumes:

     

       
11
       
16
       
 
       
      - caddy_data:/data

     

       
12
       
12
       
-
       
      - ./conf:/etc/caddy

     

       
17
       
17
       
+
       
    restart: always

     

       
13
       
18
       
 
       
  knotserver:

     

       
14
       
19
       
 
       
    environment:

     

       
15
       
20
       
 
       
     - KNOT_REPO_SCAN_PATH=/home/git

     
···

       
18
       
23
       
 
       
     - APPVIEW_ENDPOINT=https://tangled.sh

     

       
19
       
24
       
 
       
     - KNOT_SERVER_INTERNAL_LISTEN_ADDR=0.0.0.0:5444

     

       
20
       
25
       
 
       
     - KNOT_SERVER_LISTEN_ADDR=0.0.0.0:5555

     

       
21
       
21
       
-
       
    env_file: knot.env

     

       
26
       
26
       
+
       
     - KNOT_SERVER_HOSTNAME=${KNOT_SERVER_HOSTNAME}

     

       
27
       
27
       
+
       
     - KNOT_SERVER_SECRET=${KNOT_SERVER_SECRET}

     

       
22
       
28
       
 
       
    build:

     

       
23
       
29
       
 
       
      dockerfile: Dockerfile

     

       
24
       
30
       
 
       
    volumes:

     

       
25
       
31
       
 
       
     - knot_data:/home/git

     

       
26
       
32
       
 
       
    ports:

     

       
27
       
33
       
 
       
      - "2222:22"

     

       
34
       
34
       
+
       
    restart: always

     

       
28
       
35
       
 
       
volumes:

     

       
29
       
36
       
 
       
  caddy_data:

     

       
30
       
37
       
 
       
  knot_data:

     

···

       
1
       
1
       
-
       
KNOT_SERVER_HOSTNAME=<your hostname>

     

       
2
       
2
       
-
       
KNOT_SERVER_SECRET=<secret string from the tangled.sh ui>