> For the complete documentation index, see [llms.txt](https://docs.cloudback.it/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudback.it/data-restoration/download-backups.md). # Download Backups Learn how to download your backups from Cloudback to your local machine, including handling password-protected archives. Cloudback allows you to download backups of your repositories to your local machine. This page will guide you through the process of downloading backups of your repositories. ## Downloading a Backup To download a backup of your repository: 1. Open Cloudback Dashboard and navigate to the repository details page for the repository you want to download a backup for. 2. Open the `Backups` tab. 3. Locate the backup you want to download and click the `Download` icon to start the download. ![Download backup from backups list](https://2781059148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQEI7SjBF2CddqNXZpCoE%2Fuploads%2Fgit-blob-972ffd4e5dd41fe65da260aa821e175aaaeafcce%2Frepository-details-backups-tab.png?alt=media) ### Backup Download Dialog After clicking the `Download` icon, Cloudback verifies the backup archive is available. If the archive is accessible, a download dialog appears. The dialog behavior depends on the storage type and encryption configuration: **Instant download (Cloudback-managed and compatible storages):** Click `Download now` to start the download directly from the dialog. If the backup is [password-protected](/security-and-compliance/password-protected-archives.md), you will receive an email with the password after clicking `Download now`. ![Backup download dialog](https://2781059148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQEI7SjBF2CddqNXZpCoE%2Fuploads%2Fgit-blob-58b3af954452cf5e0b9c148f269afdf00ede69d7%2Fbackup-download-dialog.png?alt=media) **Custom encryption with RSA Lockbox:** If the backup is protected by an [RSA Lockbox](/encryption-management/rsa-lockbox.md) encryption key, the download dialog prompts you to paste your RSA private key (PEM format). Cloudback decrypts the archive password in memory and discards your private key immediately - it is never stored. Enter your private key and click `Download now`. **Customer-managed storages without instant download:** Some customer-managed storage providers do not support instant downloads. In this case, the dialog shows a `Send Password` button - click it to receive the archive password via email, then download the archive directly from your own storage solution. ![Email with backup archive password](https://2781059148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQEI7SjBF2CddqNXZpCoE%2Fuploads%2Fgit-blob-02038433a3aac4c74683ad4e3e43d54d1dbe3f39%2Fbackup-password-email.png?alt=media) ## What if the backup archive file is deleted? There are a few situations where a backup archive cannot be downloaded: * The archive file has been removed from the storage * The archive file has been moved to another location * The storage is not available or is not accessible In any of these cases, you will see an error: `Backup archive not found. Possible reasons: file moved/deleted or storage inaccessible.` ## Learn More * [GitHub Backup Contents](/github/backup-contents.md) * [Password-Protected Archives](/security-and-compliance/password-protected-archives.md) * [Encryption Overview](/encryption-management/encryption-overview.md) * [Archive Name Pattern](/managing-backups/archive-name-pattern.md) * [Customer Managed Storages](/storage-configuration/customer-managed-storages.md) --- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.cloudback.it/data-restoration/download-backups.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.