> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peerdb.io/llms.txt
> Use this file to discover all available pages before exploring further.
# RDS Postgres Source Setup Guide
## Supported Postgres versions
Anything on or after Postgres 12
## Enable Logical Replication
**You don't need** to follow the below steps if the settings `rds.logical_replication` is 1 and `wal_sender_timeout` is 0. These settings should mostly be pre-configured if you are migrating from another data replication tool.
1. Create a new parameter group for your Postgres version with `rds.logical_replication` set to 1; and `wal_sender_timeout` set to 0.
2. Modify the RDS Postgres database by adding the new parameter group.
3. Reboot your RDS Postgres database for the above parameters to kick in.
## Creating PeerDB User and Granting permissions
Connect to your RDS postgres through the admin user and run the below commands:
1. Create a dedicated user for PeerDB:
1. ```sql theme={null}
CREATE USER peerdb_user PASSWORD 'some-password';
```
2. Grant schema-level, read-only access to the user you created in the previous step. The following example shows permissions for the `public` schema. Repeat these commands for each schema containing tables you want to replicate:
1. ```sql theme={null}
GRANT USAGE ON SCHEMA "public" TO peerdb_user;
GRANT SELECT ON ALL TABLES IN SCHEMA "public" TO peerdb_user;
ALTER DEFAULT PRIVILEGES IN SCHEMA "public" GRANT SELECT ON TABLES TO peerdb_user;
```
3. Grant replication privileges to the user:
1. ```sql theme={null}
GRANT rds_replication TO peerdb_user;
```
4. Create a [publication](https://www.postgresql.org/docs/current/logical-replication-publication.html) with the tables you want to replicate. We strongly recommend only including the tables you need in the publication to avoid performance overhead.
Any table included in the publication must either have a **primary key** defined *or* have its **replica identity** configured to `FULL`.
1. To create a publication for specific tables:
```sql theme={null}
CREATE PUBLICATION peerdb_publication FOR TABLE table_to_replicate, table_to_replicate2;
```
2. To create a publication for all tables in a specific schema:
```sql theme={null}
CREATE PUBLICATION peerdb_publication FOR TABLES IN SCHEMA "public";
```
The `peerdb_publication` publication will contain the set of change events generated from the specified tables, and will later be used to create the MIRROR (replication).
The PeerDB user must not be restricted by RLS policies, as it can lead to missing data. You can disable RLS policies for the user by running the below command:
```sql theme={null}
ALTER USER peerdb_user BYPASSRLS;
```
## PeerDB SSH Tunneling Guide (Optional)
Sometimes to connect to your Postgres database you may need PeerDB to use an SSH tunnel.
This is typically used when your database is not publicly accessible and you need to connect to it a jump server in your VPC.
This is done by creating an SSH tunnel to your jump server and then connecting to the database through the tunnel. All
of this is handled by PeerDB natively.
Generate a key-pair using the following command:
```bash theme={null}
ssh-keygen -t rsa -b 4096 -C "peerdb-ssh-tunnel" -f peerdb_key.pem
```
This will generate a private key (`peerdb_key.pem`) and a public key (`peerdb_key.pub`).
Add the public key to your jump server. This can be done by adding the public key to the `~/.ssh/authorized_keys` file on the jump server.
```bash theme={null}
# On the jump server
cat peerdb_key.pub >> ~/.ssh/authorized_keys
```
When creating a Postgres peer you can specify the option to use an SSH tunnel. There you will be able to provide the private key you generated in the first step along with the jump server details.
## Safe list PeerDB Cloud IPs
If you are using PeerDB Cloud [safelist public IPs of your PeerDB Cloud instance](/peerdb-cloud/ip-table) by editing the `Inbound rules` of the `Security group` in which your
RDS Postgres (OR the Jump Server/Bastion if you are using SSH tunneling) is located.
## Create RDS Postgres Peer in PeerDB
Through the PeerDB UI, create the RDS Postgres Peer using the `peerdb_user` that you created in the previous step.
