# Episode archive and backup

HarborFM can upload an episode **project zip** to a remote archive destination (separate from Podcast Delivery). Use this to free local disk with **Archive**, keep remote copies with **Backup**, and bring project files back with **Restore**.

Credentials are encrypted at rest with `HARBORFM_SECRETS_KEY`, same as Podcast Delivery.

## Archive Settings

Configure **one** archive destination per show (S3, FTP, SFTP, WebDAV, IPFS, or SMB). Open the **show** page and use **Archive Settings** in the show header (near Submit to Directories). Modes and fields match Podcast Delivery, without a public base URL.

On AWS S3 (no custom endpoint), archive uploads use Infrequent Access storage. Glacier or Deep Archive objects that have not been restored in AWS cannot be downloaded until you restore them there first.

You need archive settings before **Archive** or **Backup** will work on an episode.

## Archive

After you **Build Final Episode**, open the Final Episode action tiles and choose **Archive**.

HarborFM will:

1. Zip the episode project (same kind of zip as Download Project).
2. Upload it to the archive destination and verify size/checksum.
3. Remove local project files (segment uploads and related rows) to free disk.
4. Keep feed-serving files (final audio under `processed/`, artwork, episode metadata) so listeners are unaffected.

The episode is marked archived in the editor. **Build Final Episode**, **Download Project**, and **Backup** stay unavailable until you restore. Use **Restore** on the archived project card to download the zip and bring segments back. Episode title, description, and publish settings are not overwritten by restore.

## Backup

When archive settings exist and the episode is not archived, use **Backup** on the Final Episode tiles. A dialog (same style as Manage Segment) offers:

- **Backup** - Upload a project zip. Replaces the existing undated backup for that episode.
- **Dated Backup** - Upload a new zip with date and time in the filename so each run keeps a separate copy.
- **Restore a backup** - Pick a backup from the dropdown and confirm. HarborFM downloads that zip and replaces local project files. Episode metadata stays as it is.

Backup does **not** delete local files and does **not** mark the episode archived.

## Restore

| Situation | Action |
|-----------|--------|
| Episode was **Archived** | Use **Restore** on the archived project card. |
| You want an earlier **Backup** | Open **Backup**, choose a listed backup, confirm **Restore**. |

Restore rebuilds segments and recordings from the zip. Library assets are reused when the original id still exists on this server; otherwise a new library entry is created (including waveform generation when needed).

## See also

- [Making the final episode](Segments.md#making-the-final-episode)
- [Export and delivery](Export-and-delivery.md) - Podcast Delivery for RSS and audio
- [Episodes](Episodes.md#episode-editor-overview)
- Main [README](../blob/main/README.md) - Features and usage overview