# Glossary

> Rowsafe's words in plain language, A to Z.

Source: https://rowsafe.sh/docs/glossary

Each term links to its full page.

## Agent

The small open-source program on your server that backs up, runs Proof and reports health. Outbound connections only. [Hosts and agents](https://rowsafe.sh/docs/concepts/hosts-and-agents).

## AI agent change

A production change an AI agent makes right away as its person, with their rights, or that Rowsafe refuses with a reason. Nothing waits for approval. [How AI agents act](https://rowsafe.sh/docs/guides/agent-autonomy).

## API key

A key (`rsk_...`) for the CLI, scripts, CI or AI assistants; read-only or read-write. **Settings** → **API keys**. [API keys](https://rowsafe.sh/docs/guides/teams#api-keys).

## Apply fix

The button on a Pulse finding that fixes it for you, after you confirm. [Apply fix](https://rowsafe.sh/docs/guides/monitoring#apply-fix).

## Ask Rowsafe

Ask about your databases in plain words; get an answer and, when there is one, a fix button. [Ask Rowsafe](https://rowsafe.sh/docs/guides/ask).

## Backup

A copy of the whole database: **full** (Sundays) or **differential** (only changes since the last full, other nights). [Backup types](https://rowsafe.sh/docs/concepts/backups-and-recovery#backup-types).

## Bring back rows

Put lost rows back into production from a restored [copy](#copy), leaving everything else as is. [Bring back rows](https://rowsafe.sh/docs/guides/restore#bring-back-rows).

## Bucket

Your own S3-compatible storage where backups live (R2, B2, S3, Wasabi, Spaces...). Rowsafe never has its keys. [Set up backup storage](https://rowsafe.sh/docs/guides/storage).

## Change log (WAL)

The database's running record of every change, copied to your bucket within about a minute so you can restore to any second. Called WAL (PostgreSQL), binary log (MySQL, MariaDB), oplog (MongoDB). [How PostgreSQL backups work](https://rowsafe.sh/docs/concepts/postgresql#wal-archiving).

## Connection pooling

A pooler (PgBouncer, ProxySQL) lets many app connections share a few database connections. [Connection pooling](https://rowsafe.sh/docs/guides/connection-pooling).

## Control plane

See [Rowsafe service](#rowsafe-service).

## Copy

A **Rewind copy**: your database at a moment you pick, on your server, private, read-only, deleted after 24 hours unless kept. [Restore a copy](https://rowsafe.sh/docs/guides/restore#restore-a-copy).

## Database

One database server instance (one host and port, every database inside it), backed up and restored together. [Create databases and users](https://rowsafe.sh/docs/guides/databases-and-users).

## Drill

The internal name for a [Proof](#proof) run, seen in tasks and logs.

## Encryption passphrase

The secret that encrypts backups on your server. Only you have it; **without it, nothing can be restored**. [The encryption passphrase](https://rowsafe.sh/docs/guides/storage#the-encryption-passphrase).

## Enrollment token

A one-time code (`rse_...`) in the install command that joins a server to your organization. Valid one hour by default. [Enrollment](https://rowsafe.sh/docs/concepts/hosts-and-agents#enrollment).

## Failover

Switching to the [standby](#standby) when the main server dies: **Promote** by hand, or automatic (off by default). [Automatic failover](https://rowsafe.sh/docs/guides/standby#automatic-failover).

## Find the moment

Finds the exact second rows were deleted or changed, or a table emptied or dropped. [Find the moment](https://rowsafe.sh/docs/guides/find-the-moment).

## Finding

One problem Pulse found, in plain words, usually with [Apply fix](#apply-fix). [Pulse](https://rowsafe.sh/docs/guides/monitoring#health-score).

## Guard

The safety net for AI coding agents: MCP tools, plugins, the `rowsafe guard` hook, migration previews, the GitHub Action. [Guard](https://rowsafe.sh/docs/guides/ai-agents).

## Health score

0 to 100 per database. A critical problem caps it at 59, a warning at 89. [Health score](https://rowsafe.sh/docs/guides/monitoring#health-score).

## Host

A server (or the agent's Docker container) running the [agent](#agent). Called **Servers** in the dashboard. [Hosts and agents](https://rowsafe.sh/docs/concepts/hosts-and-agents).

## Logs

The database's own log in the dashboard, with values removed on your server first. [Logs](https://rowsafe.sh/docs/guides/logs).

## Major upgrade

A new major version (for example PostgreSQL 16 to 18), checked and rehearsed on a copy first, with undo. Debian or Ubuntu packages only. [Major upgrades](https://rowsafe.sh/docs/guides/updates#major-upgrades).

## Mark

A named restore point, such as `before-migration-42`, you can rewind to exactly. [Marks](https://rowsafe.sh/docs/concepts/restore-points).

## MCP

The standard way AI assistants use outside tools. Rowsafe's MCP server gives them your databases, as their person. [MCP server](https://rowsafe.sh/docs/reference/mcp).

## Migration preview

Runs a migration on a fresh copy and reports locks, rewrites and time. Production is never touched. [Preview a migration](https://rowsafe.sh/docs/guides/preview-migrations).

## Minor update

A bug and security release of your version (for example 16.9 to 16.10): one click, a few seconds' restart. Debian or Ubuntu packages only. [Minor updates](https://rowsafe.sh/docs/guides/updates#minor-updates).

## Move in

Copies a database from a managed provider onto your server while apps keep running. [Move in](https://rowsafe.sh/docs/guides/move-in).

## Point-in-time recovery

Restoring to any second, not just the last backup. Also called **restore to any second**. [Backups and recovery](https://rowsafe.sh/docs/concepts/backups-and-recovery).

## Promote

Making a [standby](#standby) the main server. See [Failover](#failover).

## Proof

The weekly automatic restore test: restore the latest backup, check it, delete it. [Proof](https://rowsafe.sh/docs/concepts/restore-drills).

## Protected

Yes or no: could this database be restored right now? [Protection status](https://rowsafe.sh/docs/concepts/protection-status).

## Pulse

Monitoring: health score, findings with fixes, alerts, slow queries, logs, tuning, recommendations, the Monday email. [Pulse](https://rowsafe.sh/docs/guides/monitoring).

## Recommendations

Not problems yet, but soon, or ways to be faster or cheaper (a missing index, an id running out). [Recommendations](https://rowsafe.sh/docs/guides/recommendations).

## Recovery window

How far back you can go: about two weeks by default. [The recovery window](https://rowsafe.sh/docs/concepts/backups-and-recovery#the-recovery-window).

## Replica

See [Standby](#standby).

## Retention

How many full backups are kept (2 by default). More means a longer [recovery window](#recovery-window). [The recovery window](https://rowsafe.sh/docs/concepts/backups-and-recovery#the-recovery-window).

## Rewind

Every change saved; restore to any second or [Mark](#mark) in one click. [Restore a database](https://rowsafe.sh/docs/guides/restore).

## Rewind in place

Rewind the whole live database, for the worst case. Undo for 7 days. [Rewind the whole database](https://rowsafe.sh/docs/guides/restore#rewind-the-whole-database).

## Rowsafe service

The hosted part (control plane): dashboard, API, schedules, alerts. Never sees your data or secrets. [How Rowsafe works](https://rowsafe.sh/docs/concepts/how-it-works).

## Rowsafe Storage

A bucket run by Rowsafe, so you don't need your own. Still encrypted on your server. [Rowsafe Storage](https://rowsafe.sh/docs/guides/rowsafe-storage).

## Safe copy

A copy with personal data replaced by realistic fakes, for developers and AI agents. Deletes itself after a day. [Safe copies](https://rowsafe.sh/docs/guides/safe-copies).

## Second copy

Your backups in a second bucket too, ideally at another provider. [Keep a second copy](https://rowsafe.sh/docs/guides/second-copy).

## Server

See [Host](#host).

## Standby

A second server kept in sync (a replica), readable and promotable. One per database. [Standby servers and failover](https://rowsafe.sh/docs/guides/standby).

## Tuning

The settings that matter, with values for your server, changed on click, with undo. [Tuning](https://rowsafe.sh/docs/guides/tuning).

## WAL

See [Change log (WAL)](#change-log-wal).
