> For the complete documentation index, see [llms.txt](https://dvault.onepub.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dvault.onepub.dev/file-format.md). # File format ## Vault file format A DVault vault is a zip file. You can use any zip tool to unzip the vault and inspect the contents. Each file added to the vault is individually encrypted, so if need be, you can extract a single file from a vault. If you encrypt a single file called 'important.txt' to a vault the structure of the vault file is: ```bash dvault lock important.txt > Stored and locked in imporant.txt.vault ``` Contents of important.txt.vault ``` /.dvault /encrypted/important.txt ``` The .dvault file contains the keys used to encrypt/decrypt the contents of the vault and are protected by your passphrase. If you add an entire directory to a vault the contents would be: ```bash dvault unlocked /home > Unlocked to home.vault ``` Contents of home.vault ``` /.dvault /encrypted/home/fileone.txt /encrypted/home/filetwo.txt ... ``` If the vault was created with the `--share` option then the contents of the file changes: ```bash dvault encrypt --share important.txt > Unlocked to imporant.txt.vault ``` Contents of important.txt.vault ``` /.dvault /.shared /encrypted/important.txt ``` The presense of the `.shared` file tells DVault that this file has been shared between two parties and uses a single use passphrase. The decryption process is essentially the same however the messages displayed to the user change to provide some additional guidance to the reciever of the vault. ### .dvault format The .dvault file is stored in your home directory and copied into each vault that you create. The .dvault file contains the RSA Keys and a salted copy of your passphrase. The RSA Private key is encrypted using your passphrase using AES as described in the [Technical Details](https://app.gitbook.com/s/-MJ63zuM9PMrKarwtVH0/technical-details) section. ``` version:1 salt: passphrase_hash: iv: ---- BEGIN DVAULT PRIVATE KEY ---- ---- END DVAULT PRIVATE KEY ---- ---- BEGIN DVAULT PUBLIC KEY ---- ---- END DVAULT PUBLIC KEY ---- ``` ##