Skip to main content

Manage your Radicle identity

Your Radicle identity is your ticket to hosting and collaborating on code in the Radicle network, but it's not a fixed entity. You can manage multiple identities, creating/delete them at will, and even edit them to a degree.

Many of the actions below require your personal URN, which you can find using rad self.

View your active identity

Run rad self to see details on how you're identified on the Radicle network, including your:

  • Active display name
  • Personal URN
  • Peer ID
  • Hashed and full encryption keys
  • File locations of your Git monorepo and encryption keys

Create a new identity

Add new identities at any time. For example, use different identities for the personal projects you host on Radicle versus your professional work for a company or DAO.

rad auth --init

Switch between identities

If you have multiple identities, switch between them with rad auth.

Choose the identity you want active, enter your passphrase, and hit Enter.

Edit your display name

Change your display name, which is how you're identified on the Radicle web app (not the same as your Peer ID or personal URN!):

rad edit <YOUR-PERSONAL-URN>

Change the "name" value to your new display name in the file that appears.

{
"https://radicle.xyz/link/identities/person/v1": {
"name": "your-display-name"
}
}

Re-run rad self to see that your Name changed, but your personal URN and Peer ID stayed the same.

Remove an identity

If you forgot your identity's passphrase or don't need a certain profile any longer, you can delete the folders that contain Radicle identities you no longer want to use.

To find where rad stores your identities, run rad self and look at the last two lines.

├── Storage (git)  <your-git-storage-folder>
└── Storage (keys) <your-key-storage-folder>

You can now navigate to these locations and delete any folders with personal URNs that match the identities you want to remove.