Skip to content

RDoc-3839 - Document local temp-file behavior during remote-source restore#2462

Open
reebhub wants to merge 1 commit into
ravendb:mainfrom
reebhub:RDoc-3839_inconsistentTempPath
Open

RDoc-3839 - Document local temp-file behavior during remote-source restore#2462
reebhub wants to merge 1 commit into
ravendb:mainfrom
reebhub:RDoc-3839_inconsistentTempPath

Conversation

@reebhub

@reebhub reebhub commented May 23, 2026

Copy link
Copy Markdown
Contributor

Issue link

RDoc-3839

Additional description

added notes to /backup/restore and /backup/configuration to explain how temp path is used and disk-space is checked when restoring.

Type of change

  • Content - docs
  • Content - cloud
  • Content - guides
  • Content - start pages/other
  • New docs feature (consider updating /templates or readme)
  • Bug fix
  • Optimization
  • Other

Changes in docs URLs

  • No changes in docs URLs
  • Articles are restructured, URLs will change, mapping is required (update /scripts/redirects.json file, set Documents Moved PR label)

Changes in UX/UI

  • No changes in UX/UI
  • Changes in UX/UI (include screenshots and description)

@reebhub reebhub requested a review from grisha-kotler May 23, 2026 18:47
- If a backup task is configured to store backups in a local folder, `Backup.TempPath` will be ignored and temporary files will be stored alongside the backups.
- `Backup.TempPath` is also used when restoring a database from a remote destination
(Amazon S3, Azure Blob Storage, or Google Cloud Storage): the backup file is first
downloaded to `Backup.TempPath` and then read from there.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Only true for snapshot restores — backups stream directly

Comment thread docs/backup/restore.mdx
When restoring from a remote destination (Amazon S3, Azure Blob Storage, or Google Cloud
Storage), RavenDB downloads the backup file to local disk before reading the file.
The first defined path in this list is used for the download:

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is only correct for snapshot restores. Regular backups are streamed directly from the cloud and aren't downloaded to a temp path — no free-space check or DiskFullException

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants