Backup Plugin

Local backup helper for your nSelf PostgreSQL database. Schedules automatic dumps, compresses them, and stores them on local disk. For remote backup destinations (S3, Backblaze, SFTP), use the paid backup bundles.

Overview

• Scheduled Dumps — daily or custom cron interval via pg_dump
• Compression — gzip-compressed .sql.gz archives
• Retention — auto-prune backups older than the configured window
• Restore Helper — single command to restore any snapshot
• Health Check — last backup age reported in nself plugin status backup

Installation

nself plugin install backup

nself plugin status backup

Configuration

# Directory to store backups (default: ./data/backups)
BACKUP_DIR=./data/backups

# Cron schedule (default: daily at 2am)
BACKUP_SCHEDULE=0 2 * * *

# Number of backups to keep (default: 7)
BACKUP_RETENTION=7

# PostgreSQL connection (inherits DATABASE_URL by default)
DATABASE_URL=postgresql://user:pass@localhost:5432/nself

Usage

# Trigger a manual backup now
nself plugin run backup now

# List available backups
nself plugin run backup list

# Restore from a specific backup
nself plugin run backup restore --file ./data/backups/nself-2026-05-07.sql.gz