commit e866ac152cbe2ec0d0926f7413bbda1a75094e75 · julien.rbrt.fr/tangled-core

+8 -8
docs/hacking.md
···

       32
       32
        
       nix run .#watch-tailwind

     

       33
       33
        
       ```

     

       34
       34
        
       

     

       35
       35
       -
       ## running a knotserver

     

       35
       35
       +
       ## running a knot

     

       36
       36
        
       

     

       37
       37
       -
       An end-to-end knotserver setup requires setting up a machine

     

       38
       38
       -
       with `sshd`, `repoguard`, `keyfetch`, a git user, which is

     

       39
       39
       -
       quite cumbersome and so the nix flake provides a

     

       37
       37
       +
       An end-to-end knot setup requires setting up a machine with

     

       38
       38
       +
       `sshd`, `AuthorizedKeysCommand`, and git user, which is

     

       39
       39
       +
       quite cumbersome. So the nix flake provides a

     

       40
       40
        
       `nixosConfiguration` to do so.

     

       41
       41
        
       

     

       42
       42
        
       To begin, head to `http://localhost:3000` in the browser and

     

       43
       43
       -
       generate a knotserver secret. Replace the existing secret in

     

       43
       43
       +
       generate a knot secret. Replace the existing secret in

     

       44
       44
        
       `flake.nix` with the newly generated secret.

     

       45
       45
        
       

     

       46
       46
        
       You can now start a lightweight NixOS VM using

     
···

       52
       52
        
       # hit Ctrl-a + c + q to exit the VM

     

       53
       53
        
       ```

     

       54
       54
        
       

     

       55
       55
       -
       This starts a knotserver on port 6000 with `ssh` exposed on

     

       56
       56
       -
       port 2222. You can push repositories to this VM with this

     

       57
       57
       -
       ssh config block on your main machine:

     

       55
       55
       +
       This starts a knot on port 6000 with `ssh` exposed on port

     

       56
       56
       +
       2222. You can push repositories to this VM with this ssh

     

       57
       57
       +
       config block on your main machine:

     

       58
       58
        
       

     

       59
       59
        
       ```bash

     

       60
       60
        
       Host nixos-shell