···

       
30
       
30
       
 
       
    <div class="mx-6">

     

       
31
       
31
       
 
       
      These services may not be fully accessible until upgraded.

     

       
32
       
32
       
 
       
      <a class="underline text-red-800 dark:text-red-200"

     

       
33
       
33
       
-
       
        href="https://tangled.sh/@tangled.sh/core/tree/master/docs/migrations/">

     

       
33
       
33
       
+
       
        href="https://tangled.sh/@tangled.sh/core/tree/master/docs/migrations.md">

     

       
34
       
34
       
 
       
        Click to read the upgrade guide</a>.

     

       
35
       
35
       
 
       
    </div>

     

       
36
       
36
       
 
       
  </details>

     

···

       
1
       
1
       
-
       
# Upgrading from v1.7.0

     

       
1
       
1
       
+
       
# Migrations

     

       
2
       
2
       
+
       


     

       
3
       
3
       
+
       
This document is laid out in reverse-chronological order.

     

       
4
       
4
       
+
       
Newer migration guides are listed first, and older guides

     

       
5
       
5
       
+
       
are further down the page.

     

       
6
       
6
       
+
       


     

       
7
       
7
       
+
       
## Upgrading from v1.8.x

     

       
8
       
8
       
+
       


     

       
9
       
9
       
+
       
After v1.8.2, the HTTP API for knots has been deprecated and

     

       
10
       
10
       
+
       
replaced with XRPC. Repositories on outdated knots will not

     

       
11
       
11
       
+
       
be viewable from the appview. Upgrading is straightforward:

     

       
12
       
12
       
+
       


     

       
13
       
13
       
+
       
- Upgrade to latest tag (v1.9.0 or above)

     

       
14
       
14
       
+
       
- Head to the [knot dashboard](https://tangled.sh/knots) and

     

       
15
       
15
       
+
       
  hit the "retry" button to verify your knot

     

       
16
       
16
       
+
       


     

       
17
       
17
       
+
       
## Upgrading from v1.7.x

     

       
2
       
18
       
 
       


     

       
3
       
19
       
 
       
After v1.7.0, knot secrets have been deprecated. You no

     

       
4
       
20
       
 
       
longer need a secret from the appview to run a knot. All

     
···

       
19
       
35
       
 
       
  hit the "retry" button to verify your knot. This simply

     

       
20
       
36
       
 
       
  writes a `sh.tangled.knot` record to your PDS.

     

       
21
       
37
       
 
       


     

       
22
       
22
       
-
       
## Nix

     

       
23
       
23
       
-
       


     

       
24
       
38
       
 
       
If you use the nix module, simply bump the flake to the

     

       
25
       
39
       
 
       
latest revision, and change your config block like so:

     

       
26
       
40
       
 
       


     
···

       
33
       
47
       
 
       
   };

     

       
34
       
48
       
 
       
 };

     

       
35
       
49
       
 
       
```

     

       
50
       
50
       
+