Skip to content

Commit dd70549

Browse files
committed
Add SerenAI Cloud documentation to all READMEs
1 parent ccb2fef commit dd70549

5 files changed

Lines changed: 96 additions & 0 deletions

File tree

README-MongoDB.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,25 @@
22

33
This guide explains how to replicate MongoDB databases to PostgreSQL using database-replicator's JSONB storage approach.
44

5+
---
6+
7+
## SerenAI Cloud Replication
8+
9+
**New to SerenAI?** Sign up at [console.serendb.com](https://console.serendb.com) to get started with managed cloud replication.
10+
11+
When replicating to SerenDB targets, this tool runs your replication jobs on SerenAI's cloud infrastructure automatically:
12+
13+
```bash
14+
export SEREN_API_KEY="your-api-key" # Get from console.serendb.com
15+
database-replicator init \
16+
--source "mongodb://user:pass@mongo-host:27017/db" \
17+
--target "postgresql://user:pass@your-db.serendb.com:5432/db"
18+
```
19+
20+
For non-SerenDB targets, use the `--local` flag to run replication locally.
21+
22+
---
23+
524
## Overview
625

726
The tool automatically detects MongoDB connection strings and replicates collections to PostgreSQL using a JSONB storage model. All BSON types are preserved with full type fidelity, including ObjectIds, DateTimes, Binary data, and MongoDB-specific types.

README-MySQL.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,25 @@
22

33
This guide explains how to replicate MySQL and MariaDB databases to PostgreSQL using database-replicator's JSONB storage approach.
44

5+
---
6+
7+
## SerenAI Cloud Replication
8+
9+
**New to SerenAI?** Sign up at [console.serendb.com](https://console.serendb.com) to get started with managed cloud replication.
10+
11+
When replicating to SerenDB targets, this tool runs your replication jobs on SerenAI's cloud infrastructure automatically:
12+
13+
```bash
14+
export SEREN_API_KEY="your-api-key" # Get from console.serendb.com
15+
database-replicator init \
16+
--source "mysql://user:pass@mysql-host:3306/db" \
17+
--target "postgresql://user:pass@your-db.serendb.com:5432/db"
18+
```
19+
20+
For non-SerenDB targets, use the `--local` flag to run replication locally.
21+
22+
---
23+
524
## Overview
625

726
The tool automatically detects MySQL/MariaDB connection strings and replicates data to PostgreSQL using a JSONB storage model. All MySQL data is preserved with full type fidelity, including DECIMAL precision, DATETIME microseconds, and BLOB data.

README-PostgreSQL.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,23 @@ Zero-downtime database replication using PostgreSQL logical replication with con
44

55
---
66

7+
## SerenAI Cloud Replication
8+
9+
**New to SerenAI?** Sign up at [console.serendb.com](https://console.serendb.com) to get started with managed cloud replication.
10+
11+
When replicating to SerenDB targets, this tool runs your replication jobs on SerenAI's cloud infrastructure automatically. Just set your API key and run:
12+
13+
```bash
14+
export SEREN_API_KEY="your-api-key" # Get from console.serendb.com
15+
database-replicator init \
16+
--source "postgresql://user:pass@source:5432/db" \
17+
--target "postgresql://user:pass@your-db.serendb.com:5432/db"
18+
```
19+
20+
For non-SerenDB targets, use the `--local` flag to run replication locally.
21+
22+
---
23+
724
## Overview
825

926
This guide covers replicating PostgreSQL databases from any PostgreSQL provider (Neon, AWS RDS, Hetzner, self-hosted, etc.) to another PostgreSQL database (including Seren Cloud). The tool uses PostgreSQL's native logical replication for zero-downtime replication with continuous sync.

README-SQLite.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,23 @@
22

33
This guide explains how to replicate SQLite databases to PostgreSQL using database-replicator's JSONB storage approach.
44

5+
---
6+
7+
## SerenAI Cloud Replication
8+
9+
**New to SerenAI?** Sign up at [console.serendb.com](https://console.serendb.com) to get a managed PostgreSQL database optimized for AI workloads.
10+
11+
**Note:** SQLite replication requires local execution (the `--local` flag) since the source file must be accessible from your machine.
12+
13+
```bash
14+
database-replicator init \
15+
--source /path/to/database.db \
16+
--target "postgresql://user:pass@your-db.serendb.com:5432/db" \
17+
--local
18+
```
19+
20+
---
21+
522
## Overview
623

724
The tool automatically detects SQLite database files and replicates them to PostgreSQL using a JSONB storage model. All SQLite data is preserved with full type fidelity, including BLOBs, NULLs, and special float values.

README.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,30 @@ Replicate any database to PostgreSQL with zero downtime. Supports PostgreSQL, SQ
1212

1313
---
1414

15+
## SerenAI Cloud Replication
16+
17+
**New to SerenAI?** Sign up at [console.serendb.com](https://console.serendb.com) to get started with managed cloud replication.
18+
19+
SerenAI provides managed PostgreSQL databases optimized for AI workloads. When replicating to SerenDB targets, this tool can run your replication jobs on SerenAI's cloud infrastructure - no local resources required.
20+
21+
**Benefits of SerenAI Cloud Execution:**
22+
- No local compute resources needed
23+
- Automatic retry and error handling
24+
- Job monitoring and logging
25+
- Optimized for large database transfers
26+
27+
To replicate to SerenDB, simply run:
28+
```bash
29+
export SEREN_API_KEY="your-api-key" # Get from console.serendb.com
30+
database-replicator init \
31+
--source "postgresql://user:pass@source:5432/db" \
32+
--target "postgresql://user:pass@your-db.serendb.com:5432/db"
33+
```
34+
35+
For local execution (non-SerenDB targets), use the `--local` flag. See [Remote Execution](#remote-execution-serendb-only) for details.
36+
37+
---
38+
1539
## Overview
1640

1741
`database-replicator` is a command-line tool that replicates databases from multiple sources to PostgreSQL (including Seren Cloud). It automatically detects your source database type and handles the replication accordingly:

0 commit comments

Comments
 (0)