> For the complete documentation index, see [llms.txt](https://docs.revault.onepub.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.revault.onepub.dev/identity.md).

# Identity

In reVault an identity is essentially a named master key used to secure your lockboxes.&#x20;

When you initialise a vault an 'default' identity is created.

If you requirements are simple then the default identity is all you need.&#x20;

So why might you want to create additional identities?

Separate different parts of you life:

You have work and private lockboxes on your PC.

If you uses separate identities for work and personal lock boxes then if you change jobs you can just delete the personal identity from the vault and no one will have access to any of your personal lock boxes even if you leave some of them on the PC.

If you are a consultant then you might also create separate identities for each of the organisations you work for. &#x20;

Having separate identities requires an extra level of care when creating lock boxes, you need to use the --for switch to ensure that you have used the correct identity on a lockbox.

```
lbx create --for personal mygames.lbox
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.revault.onepub.dev/identity.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
