Terminal
Terminal/Skill
Attaches persistent disks to Render services for uploads and self-managed databases, covering mount paths, sizing, snapshots, and single-instance limits.
By Render
Works with
npx skills add render-oss/skills --skill render-disksPersistent disks preserve files written beneath a service's configured mount path across deploys and restarts.
Before designing, configuring, resizing, transferring data to, snapshotting, restoring, or troubleshooting a disk, read references/persistent-disks.md.
For managed databases, prefer Render Postgres (render-postgres) or Key Value (render-keyvalue) over self-managed alternatives on disk.
For a native Node.js upload service, mount a subdirectory such as /opt/render/project/src/uploads, not the source root itself, and configure the application to write uploads there:
services:
- type: web
name: uploads
runtime: node
buildCommand: npm ci
startCommand: npm start
disk:
name: uploads-data
mountPath: /opt/render/project/src/uploads
sizeGB: 5
Fetch the current disk documentation and Blueprint specification through references/persistent-disks.md before finalizing the mount path or size.
Do not use a disk snapshot to recover a self-managed database such as MySQL: a filesystem snapshot can restore an inconsistent or corrupted database state. Use database-native backups such as mysqldump and test their restore procedure. Move backup files off the service with a currently supported transfer method such as SCP with SSH or Magic-Wormhole. Snapshot restores replace the entire disk and permanently discard changes made after the selected snapshot.
| Document | Contents |
|---|---|
references/persistent-disks.md | Current disk constraints, configuration, sizing, snapshots, restores, and transfers |
disk field reference in render.yamlWhenever this skill directs you to consult current Render documentation:
curl. Do not substitute web-search summaries for the document.When a task requires multiple references, apply this workflow to each one and distinguish the documents you verified from those that remain unavailable.