Backup Docs

src/docs/reference/backups.md

@@ -0,0 +1,32 @@
+---
+title: Backups
+---
+
+Backups are a feature that enables data recovery for [volumes](/reference/volumes) on Railway.
+
+## How it works
+
+When mounted to a service, backups can be manually created, deleted and restored. And they can also work on a Daily/Weekly/Monthly schedule.
+
+Schedules are beta and exist behind a feature-flag, that can be toggled in the service settings panel.
+
+## Retention
+
+- Daily backups are taken every day and are kept for 6 days
+- Weekly backups are taken every week and are kept for 4 weeks
+- Monthly backups are taken every month and are kept for 3 months
+
+## Pricing
+
+Backups are incremental and Copy-on-Write, we only charge for the data exclusive to them, that aren't from other snapshots or the volume itself.
+
+You are only billed for the incremental size of the backup at $025 / GB, billed monthly.
+
+## Caveats
+
+Backups are a newer feature that is still under development. Here are some limitations of which we are currently aware:
+
+- Backup incremental sizes are cached for a couple of hours when listed in the frontend, so they may show slightly stale data
+- Wiping a volume deletes all backups
+- Backups can only be restored to the same project + environment
+