HarborFM

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