git.iko.soy/urbit.org
on roller-tutorial help sign in
urbit.org/content/reset.md
109 lines 5.5 kB history raw
1+++
2title = "~2020.12 Network Reset"
3template = "page_indiced.html"
4+++
6## TL;DR
8*Last updated ~2021.1.14*
10A network reset happened on ~2020.12.8 — you may need to take action.
12Unlike past resets, this one comes with a tool to export and reimport all of your data so that you don't lose anything; we call it `flagday`. Details on its usage can be found below.
14*If you are self-hosting your ship, following these instructions is mandatory in order to communicate with the rest of the network.*
16## When was the last network reset?
18On Tuesday, ~2020.12.8.
20## How do I get updates about what's going on throughout the process?
22We'll be adding new information to this document as soon as there's anything to share. Updates will be broadcasted via Twitter [here](https://twitter.com/zodisok/) as well.
24## What is a "network reset"?
26A network reset occurs when we need to change the Ames networking protocol number in order to reset the network’s state. When we change the protocol number, it will essentially create a new network. This change in continuity is why we refer to it as a "reset". In the past, this has required users to take some action in order to get on the new network, but this time we've provided tooling to make it seamless.
28## Why does the network need to reset?
30A network reset occurs when:
31- A change must be made to all ships on the network simultaneously
32- A change must be made to the Ames networking protocol
33- Substantial changes must be made to Arvo and Vere simultaneously
35In this reset, we are including changes that will allow us to make these changes in the future without resetting the network.
37## Do I need to perform a personal breach?
39No. A network reset subsumes all personal breaches, so please don’t also perform a personal breach.
41## What can I expect?
43If you are using a self-hosted ship, you need to affirmatively perform the reset using the instructions below. If you are using hosting, your ship will process the reset automatically.
45## Do I need to do anything with Bridge/Ethereum?
47There are no Ethereum transactions necessary for this reset.
49## I’m self-hosted—what do I need to do?
51You are still in the old era. First you need to ensure that you are on the
52correct base hash - run `+trouble` in dojo and check that the following line
53is displayed.
54```
55[%base-hash [0v1f.lbtqc.5o909.qqja6.17dgp.m8gde.bmiqc.fa97p.8jer8.msu43.5rf36]]
56```
57If `%base-hash` is different, you need to download the correct OTA from `~fet`,
58a galaxy that Tlon has left running in the old era specifically for this
59purpose. Enter `|ota ~fet %kids` into dojo and wait until the OTA update is
60complete. Now you are ready to proceed.
62**Simply use the `flagday` tool that we have provided**. It will perform all the
63relevant actions on your behalf, as well as exporting and reimporting your data.
65To use `flagday`, run the following:
67```sh
68curl https://bootstrap.urbit.org/flagday.sh > flagday.sh; chmod 755 ./flagday.sh; ./flagday.sh PIER_DIRECTORY
69```
71Alternatively, you can perform the migration manually (see below).
73## Can I perform the migration manually?
75Yes, by following these steps (note that these steps **will not** back up your data as is the case with `flagday`):
771. Download your [keyfile from Bridge](https://urbit.org/getting-started/#keyfile).
782. Shut down your ship.
793. [Archive and move your old pier](/using/os/getting-started#moving-your-pier) (this is the directory that contains your urbit event log).
804. [Download the latest version](/getting-started/) of the urbit binary.
815. [Boot your ship with the new keyfile](/getting-started/).
83## I’m hosted by Tlon, or someone else—what do I need to do?
85Users hosted by Tlon will not need to take any action. We’re handling everything on our end. If you’re hosted by another provider, you should contact that provider for instructions.
87## What happens to my data?
89We’ve written a tool called `flagday` that will allow you to easily export your ship’s Landscape data. This includes your subscriptions and any content such as Collections, Notebooks and Chats that are on your ship. This data can then be seamlessly imported into a new ship.
91## What is unique about this reset?
93This reset will include Arvo/Vere Version Negotiation. This will allow us to ship updates to Vere and Arvo separately without worrying about an incompatibility on ships. For example, if you are running Vere 1.0 and an OTA of Arvo goes out that requires Vere 2.0, your ship will simply drop the update and notify you that you need to update your binary in order to receive the next update. When you update your binary is up to you.
95## Will there be more network resets?
97We are optimistic that this will be our last reset, as all future updates to the network can be distributed as OTA (over-the-air) updates, possibly accompanied by a notification to update a binary version.
99## What happens if I don’t follow these instructions?
101Your Urbit will fall out of communication with the rest of the Urbit network which has performed the reset. This means that updates (OTAs) will no longer process and you won’t be able to communicate with anyone else on the network.
103## How do I get help if I need it?
105If you're in a tight spot or confused, reach out to us at support@urbit.org.
107## What's a 'breach'?
109We often call events like this a 'breach' since we "breach" the continuity of Urbit's network protocol. This language has no relationship to security. If anything, it's more like a "hard fork" of the network.