> 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/the-vault.md). # The Vault When install reVault the first action you need to under take is to create a Vault. A vault is used to store all the keys to your lockboxes, so keeping a vault secure is critical. You will only have a single vault per device, you can share a vault between devices but we don't normally recommend this as it can be hard to sync the vaults and you risk over writing lockbox keys ( and losing access to those lockboxes) if you screw up the sync process. reVault does allow you to use external passwords and external keys to access lockboxes but the Vault is the default way to store your passwords and keys and provides significant ergonomics over managing a gaggle of passwords and keys. The Vault stores its own contents in a lockbox to ensure that its contents are secured. To access the Vault you must have the pass phrase originally entered or generated when creating the vault. It is CRITICAL that you back up the vault pass phrase. Losing the vault pass phrase means that you lose access to all of your lockboxes. ### Create the Vault To create the vault run: ``` lbx vault init ``` You will be prompted to enter or generate a pass phrase for the vault. It is CRITICAL that you backup the pass phrase. If you lose the pass phrase you will lose access to all of you lockboxes. ### Verify the Vault You can verify the vault is intact by running: ``` lbx vault verify ``` ### Overwrite the vault You can create a new vault by overwriting the existing vault. This EXTREMELY DANGEROUS. Overwriting the existing vault will cause you to lose access to all existing lockboxes. To overwrite the existing vault run: ``` lbx vault init --overwrite ``` The overwrite will backup the existing vault before overwriting the existing vault. You will be requested to enter a new password for the new vault. It is CRITICAL that you backup the password. If you lose the password you will lose access to all of you lockboxes. ### Contacts A vault is used to store the list of contacts that you can share lockboxes with. For more details on [contacts](/contacts.md). ## Technical Details You don't need to read the following to understand how to use your vault. TODO: describe the vault data including the contents of its lockbox. --- # 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/the-vault.md?ask= ``` 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.