~lanlyd Docs
Search…
Claim Process
Claim your Urbit identity

Moving to Mars

First, we need to transfer ownership of this new identity from ~lanlyd to you.
Click on the link or copy past it into the browser to get started. You should see a page that looks like this, except with a different identity sigil (that black unique image used as a profile image) and name with the tilde symbol in front of it.
Click the claim button to start the transfer process.
Next, you will see this screen. Please read the information about what your new Master Ticket is. Make sure to do this step in a private area.
Click Reveal to back up your Master Ticket. Remember, there is no tech support and if you lose access to your Master Ticket, no one else can help you.
Click the Download Backup button and keep the downloaded passport file in a safe location.
Keep is secret. Keep is safe.
You should now have a folder on your computer that has three files inside it.
A .key file
A Management Proxy Document
And you're all important Master Ticket Document
Your master Ticket document will look something like this. At the top, you will find your Master Ticket information. Also, this document is an image file, so malware cant steal it from your computer as if it were a text document.
Type the 4-word master ticket from your document back into the web browser dialog box to confirm that you have backed up your Master Ticket safely.
Once you have successful backed up your master ticket and verified the Master Ticket in the browser, you will see the Congratulations screen as shown below.
Now we need to install Port. Follow this link to grab the latest version of Port from GitHub.
Download the correct program for your operating system and run the installer. In this example, it is the Windows .exe file.
Windows seems to think that the file is dangerous. We know that it is not. Click on "More info" and run the installer anyway.
Once the installation completes, run the Port software. You will see an interface that looks like this.
If you are booting a new Planet ID for the first time, select "Boot a fresh ID". If you don't have a Planet ID you can start with a Comet. Comets are disposable and are missing some of the features that a Planet ID enjoys on the Urbit network.
For Planets, on this next screen, you will need to enter your ship details.
The "Name" field can be whatever you would like.
The "Shipname" field needs to be the exact name of your ship. You can find this information in the Master Ticket file you downloaded previously.
The "Key File" field is asking you to locate the .key file that was included in your passport download that also included your Master Ticket.
Note: Your ships .key file will only be used to verify your identity once on this initial boot and launch or your ship. You will not need this file again, and Port will defeat it automatically for you.
If the information was entered correctly, then you will see this screen while your ship boots up for the first time. This can take a few minutes. Something like 10 min.
Once your initial boot is completed can now launch your ship into the Urbit network and start using your new Urbit Identity.
It may take another minute to load the interface. You can see on the lower left a button to "Copy Access Key". This is like a password to access the interface of your ship if you are using it remotely. However, that is beyond the scope of this tutorial.
This is the Landscape interface. It is the main interface of your Urbit Ship. At the top, you will see a blue dot that displays your notifications.
Click on it to open the notification dropdown.
You should see one new notification from the System to Enable Link Handler.
Click on "Enable Link Handler"
This will take you to the System settings.
Toggle on the link handler to enable Port to automatically open Urbit links.
Lastly, you will notice that the .key file should be gone.
And that's it! Welcome to Urbit and I look forward to chatting with you on the network. If you need any assistance or would like to learn more about using Urbit join ~lanlyd/terminal.
Here is a link to a tutorial for how to join our Terminal group if you would like.
Thanks!
~lanlyd
Copy link