> ## Documentation Index
> Fetch the complete documentation index at: https://docs.screenpipe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# cloud archive - free disk space automatically

> Free disk space by encrypting old screenpipe screen recordings and uploading them to the cloud with zero-knowledge encryption — searchable on demand.

{/* https://screenpi.pe */}

cloud archive encrypts your old screenpipe data and uploads it to the cloud, then deletes the local copy to free disk space. data is encrypted on your device with zero-knowledge encryption (argon2id key derivation + chacha20-poly1305) — we cannot read your data.

## how it works

<Steps>
  <Step title="set a retention period">
    choose how many days of data to keep locally (7, 14, 30, 60, or 90 days). data older than this will be archived.
  </Step>

  <Step title="data is encrypted on your device">
    your token is used to derive an encryption key locally using argon2id. data is encrypted with chacha20-poly1305 before upload — the same encryption used by cloud sync.
  </Step>

  <Step title="encrypted data is uploaded in chunks">
    screenpipe uploads data in small batches (up to 500 records at a time) every 5 minutes. this includes screen captures, accessibility text, OCR fallback text, audio transcriptions, and ui events.
  </Step>

  <Step title="local data is cleaned up">
    after each chunk is confirmed uploaded, the corresponding local data and media files are deleted to free disk space.
  </Step>
</Steps>

## what gets archived

<CardGroup cols={2}>
  <Card title="screen captures" icon="display">
    frame metadata, app names, window titles, browser urls
  </Card>

  <Card title="screen text" icon="text">
    accessibility text and OCR fallback text from screen recordings
  </Card>

  <Card title="audio transcriptions" icon="microphone">
    transcribed speech with speaker and device info
  </Card>

  <Card title="accessibility data" icon="universal-access">
    ui text captured via accessibility apis
  </Card>

  <Card title="ui events" icon="mouse-pointer">
    keyboard and mouse activity metadata
  </Card>

  <Card title="media files" icon="film">
    orphaned video/audio files are cleaned up after upload
  </Card>
</CardGroup>

## enabling cloud archive

1. open **settings → cloud archive**
2. select your retention period (how many days to keep locally)
3. toggle **enable cloud archive**

you can also trigger an immediate archive run by clicking **archive now** in the status card.

## encryption details

cloud archive reuses the same `SyncManager` and encryption pipeline as cloud sync:

* **key derivation**: argon2id with a password derived from your auth token
* **cipher**: chacha20-poly1305 (authenticated encryption)
* **zero-knowledge**: the encryption key never leaves your device

if you already have cloud sync enabled, archive uses the exact same encryption key to avoid any conflicts.

<Card title="view archive source code" icon="github" href="https://github.com/screenpipe/screenpipe/blob/main/crates/screenpipe-engine/src/archive.rs">
  review the rust implementation of cloud archive
</Card>

## watermark-based tracking

instead of marking individual records as uploaded, cloud archive uses a single **watermark timestamp**. all data before the watermark has been securely uploaded and can be safely deleted locally.

this is simpler and more efficient than per-record tracking — one timestamp tells the system exactly where it left off, even if the app restarts.

## storage & limits

your cloud storage usage is shown in the archive status card. storage limits depend on your screenpipe pro plan.

## get your data back

archived data is never stranded in the cloud. you can pull your entire archive back to disk in one click — every encrypted blob is downloaded and decrypted locally:

1. go to **settings → cloud archive**
2. click **download my archive** (may take several minutes depending on archive size)
3. monitor progress in the download status card
4. once complete, click **open folder** to view the files in finder

the archive is organized into two folders:

* **media/**: video clips (.mp4) and screenshots (.jpg)
* **metadata/**: json files containing transcriptions, accessibility text, and event logs

all data is decrypted locally during download — the same encryption key used for upload is applied in reverse.

<Info>
  download works even if cloud archiving is currently disabled, allowing you to retrieve previously archived data.
</Info>

## important notes

<Info>
  cloud archive requires a screenpipe pro subscription. the archive process runs automatically in the background every 5 minutes when enabled.
</Info>

## next steps

<CardGroup cols={2}>
  <Card title="privacy & data flow" icon="shield" href="/privacy-data-flow">
    see exactly what leaves your device, and when
  </Card>

  <Card title="search your screen history" icon="magnifying-glass" href="/search-screen-history">
    find anything you've seen, said, or heard
  </Card>
</CardGroup>

questions? [join our discord](https://discord.gg/screenpipe).