From 82a32146dd49c4eb566c4f5a95078fc9f56ec20c Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Wed, 25 Feb 2026 12:57:23 +0200 Subject: [PATCH 1/6] PG-2209 - Update Quickstart Guide This PR updates the quick start guide. --- docs/index.md | 6 ++--- docs/installing.md | 59 ++++++++++++++++++++++++++++++++++++++++++---- 2 files changed, 57 insertions(+), 8 deletions(-) diff --git a/docs/index.md b/docs/index.md index def083f10..aa530c222 100644 --- a/docs/index.md +++ b/docs/index.md @@ -20,11 +20,11 @@ Part of the solution, Percona Operator for PostgreSQL, makes it easy to orchestr
-### :material-progress-download: Installation guides { .title } +### :material-progress-download: Quickstart guide { .title } -Get started quickly with the step-by-step installation instructions. +Get started quickly with these step-by-step installation instructions. -[Quickstart guides :material-arrow-right:](installing.md){ .md-button } +[Quickstart guide :material-arrow-right:](installing.md){ .md-button }
diff --git a/docs/installing.md b/docs/installing.md index 5342ee801..a04b0e6ab 100644 --- a/docs/installing.md +++ b/docs/installing.md @@ -1,13 +1,62 @@ # Quickstart guide -Percona Distribution for PostgreSQL is the Percona server for PostgreSQL with the collection of tools from PostgreSQL community that are tested to work together and serve to assist you in deploying and managing PostgreSQL. [Read more](index.md). - -This document aims to guide database application developers and DevOps engineers in getting started with Percona Distribution for PostgreSQL. Upon completion of this guide, you’ll have Percona Distribution for PostgreSQL installed and operational, and you’ll be able to: +In this guide you will learn to install Percona Distribution for PostgreSQL with tested open source extensions and tooling designed to work together reliably on Debian and RHEL. This guide quickly gets you up and running with: +* Install Percona Distribution for PostgreSQL using a Package Manager * Connect to PostgreSQL using the `psql` interactive terminal -* Interact with PostgreSQL with basic psql commands +* Interact with PostgreSQL with basic commands * Manipulate data in PostgreSQL -* Understand the next steps you can take as a database application developer or administrator to expand your knowledge of Percona Distribution for PostgreSQL + +## Preconditions + +Install `curl` for [Telemetry](telemetry.md), this is optional. + + ```{.bash data-prompt="$"} + $ sudo apt install curl + ``` + +## Install on Debian / Ubuntu (APT) {.power-number} + +1. Fetch the `percona-release` package: + + ```{.bash data-prompt="$"} + wget https://repo.percona.com/apt/percona-release_latest.$(lsb_release -sc)_all.deb + sudo dpkg -i percona-release_latest.$(lsb_release -sc)_all.deb + ``` + +2. Enable the repository and install the package: + + ```{.bash data-prompt="$"} + sudo percona-release setup ppg-18 + sudo apt install percona-postgresql-18 + ``` + + The installation process automatically initializes and starts the default database. + +3. Switch to a postgres user and open the psql interactive terminal: + + ```{.bash data-prompt="$"} + sudo su postgres + psql + ``` + +4. Create a database and make a table in the database: + + ```{.bash data-prompt="$"} + CREATE DATABASE test; + CREATE TABLE customers (first_name VARCHAR(50), last_name VARCHAR(50), email VARCHAR(100)); + ``` + +5. Insert data in the customers table and query the data insertion: + + ```{.bash data-prompt="$"} + INSERT INTO customers (first_name, last_name, email) VALUES ('John', 'Doe', 'john.doe@example.com'); + SELECT * FROM customers; + ``` + +Congratulations! You have installed Percona Distribution for PostgreSQL and created your first database. For detailed installation steps and further instructions, see the [Install Percona Distribution for PostgreSQL on Debian and Ubuntu](apt.md). + +## Install on RHEL / Rocky / Alma (YUM) ## Install Percona Distribution for PostgreSQL From d2c4d669adb50a630d61df4c4a1b57bcc5d3c75c Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Tue, 3 Mar 2026 12:28:30 +0200 Subject: [PATCH 2/6] Update installing.md --- docs/installing.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/installing.md b/docs/installing.md index a04b0e6ab..8272ec442 100644 --- a/docs/installing.md +++ b/docs/installing.md @@ -54,9 +54,11 @@ Install `curl` for [Telemetry](telemetry.md), this is optional. SELECT * FROM customers; ``` -Congratulations! You have installed Percona Distribution for PostgreSQL and created your first database. For detailed installation steps and further instructions, see the [Install Percona Distribution for PostgreSQL on Debian and Ubuntu](apt.md). +Congratulations! You have installed Percona Distribution for PostgreSQL and created your first database. -## Install on RHEL / Rocky / Alma (YUM) +For detailed installation steps and further instructions on Debian and Ubuntu, see the [Install Percona Distribution for PostgreSQL on Debian and Ubuntu](apt.md). + +For detailed installation steps and further instructions on Red Hat Enterprise Linux and derivatives, see the [Install Percona Distribution for PostgreSQL on Red Hat Enterprise Linux and derivatives](yum.md). ## Install Percona Distribution for PostgreSQL From 8abb72d780f99613bd5b2fa61f7c6033d67c8f2d Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Thu, 5 Mar 2026 14:47:22 +0200 Subject: [PATCH 3/6] redesign the What's new - remove preconditions - add 4 cards to lead user from simple to advanced topics - add fast track --- docs/installing.md | 124 +++++++++++++++++++++++++-------------------- 1 file changed, 68 insertions(+), 56 deletions(-) diff --git a/docs/installing.md b/docs/installing.md index 8272ec442..bfd2c8aec 100644 --- a/docs/installing.md +++ b/docs/installing.md @@ -1,103 +1,115 @@ # Quickstart guide -In this guide you will learn to install Percona Distribution for PostgreSQL with tested open source extensions and tooling designed to work together reliably on Debian and RHEL. This guide quickly gets you up and running with: +This guide shows how to install and start Percona Distribution for PostgreSQL on Debian- and RHEL-based Linux systems. After completing this guide, you will have: -* Install Percona Distribution for PostgreSQL using a Package Manager -* Connect to PostgreSQL using the `psql` interactive terminal -* Interact with PostgreSQL with basic commands -* Manipulate data in PostgreSQL +- PostgreSQL running locally +- A database named `test` +- A table named `customers` +- One inserted row you can query -## Preconditions - -Install `curl` for [Telemetry](telemetry.md), this is optional. +## Fast path (2-minute install) ```{.bash data-prompt="$"} - $ sudo apt install curl + wget https://repo.percona.com/apt/percona-release_latest.$(lsb_release -sc)_all.deb + sudo dpkg -i percona-release_latest.$(lsb_release -sc)_all.deb + sudo percona-release setup ppg-18 + sudo apt install percona-postgresql-18 + sudo -i -u postgres psql + ``` +After psql starts, run the following SQL commands: + + ```sql + CREATE DATABASE test; + \c test + CREATE TABLE customers (first_name VARCHAR(50), last_name VARCHAR(50), email VARCHAR(100)); + INSERT INTO customers VALUES ('John','Doe','john.doe@example.com'); + SELECT * FROM customers; + \q ``` +For a step-by-step explanation, continue below. + ## Install on Debian / Ubuntu (APT) {.power-number} 1. Fetch the `percona-release` package: - ```{.bash data-prompt="$"} - wget https://repo.percona.com/apt/percona-release_latest.$(lsb_release -sc)_all.deb - sudo dpkg -i percona-release_latest.$(lsb_release -sc)_all.deb - ``` + ```{.bash data-prompt="$"} + wget https://repo.percona.com/apt/percona-release_latest.$(lsb_release -sc)_all.deb + sudo dpkg -i percona-release_latest.$(lsb_release -sc)_all.deb + ``` 2. Enable the repository and install the package: - ```{.bash data-prompt="$"} - sudo percona-release setup ppg-18 - sudo apt install percona-postgresql-18 - ``` + ```{.bash data-prompt="$"} + sudo percona-release setup ppg-18 + sudo apt install percona-postgresql-18 + ``` The installation process automatically initializes and starts the default database. -3. Switch to a postgres user and open the psql interactive terminal: +3. Switch to the `postgres` user and open the psql interactive terminal: - ```{.bash data-prompt="$"} - sudo su postgres - psql - ``` + ```{.bash data-prompt="$"} + sudo -i -u postgres + psql + ``` 4. Create a database and make a table in the database: - ```{.bash data-prompt="$"} - CREATE DATABASE test; - CREATE TABLE customers (first_name VARCHAR(50), last_name VARCHAR(50), email VARCHAR(100)); - ``` + ```sql + CREATE DATABASE test; + \c test + CREATE TABLE customers (first_name VARCHAR(50), last_name VARCHAR(50), email VARCHAR(100)); + ``` -5. Insert data in the customers table and query the data insertion: +5. Insert data in the customers table and query the data insertion: - ```{.bash data-prompt="$"} - INSERT INTO customers (first_name, last_name, email) VALUES ('John', 'Doe', 'john.doe@example.com'); - SELECT * FROM customers; - ``` + ```sql + INSERT INTO customers (first_name, last_name, email) VALUES ('John', 'Doe', 'john.doe@example.com'); + SELECT * FROM customers; + \q + ``` -Congratulations! You have installed Percona Distribution for PostgreSQL and created your first database. +Congratulations! Percona Distribution for PostgreSQL is now running and you have created your first database. For detailed installation steps and further instructions on Debian and Ubuntu, see the [Install Percona Distribution for PostgreSQL on Debian and Ubuntu](apt.md). For detailed installation steps and further instructions on Red Hat Enterprise Linux and derivatives, see the [Install Percona Distribution for PostgreSQL on Red Hat Enterprise Linux and derivatives](yum.md). -## Install Percona Distribution for PostgreSQL +## What's next -You can select from multiple easy-to-follow installation options, however **we strongly recommend using a Package Manager** for a convenient and quick way to try the software first. +Now that your PostgreSQL server is running, you can explore additional capabilities of Percona Distribution for PostgreSQL. -=== ":octicons-terminal-16: Package manager" +
- Percona provides installation packages in `DEB` and `RPM` format for 64-bit Linux distributions. Find the full list of supported platforms and versions on the [Percona Software and Platform Lifecycle page :octicons-link-external-16:](https://www.percona.com/services/policies/percona-software-support-lifecycle#pgsql). +### Learn PostgreSQL basics { .title } - If you are on Debian or Ubuntu, use `apt` for installation. +Connect with `psql` and run SQL commands, manage users, roles, and configure authentication. - If you are on Red Hat Enterprise Linux or compatible derivatives, use `yum`. +[Manipulate data in PostgreSQL :material-arrow-right:](crud.md){ .md-button } - [Install via apt :material-arrow-right:](apt.md){.md-button} - [Install via yum :material-arrow-right:](yum.md){.md-button} +
-=== ":simple-docker: Docker" +### Enable extensions { .title } - Get our image from Docker Hub and spin up a cluster on a Docker container for quick evaluation. +Percona Distribution for PostgreSQL includes tested open source extensions, such as `pg_stat_monitor` for query performance monitoring, `pg_tde` for protecting data at rest and more. - Check below to get access to a detailed step-by-step guide. - - [Run in Docker :material-arrow-right:](docker.md){.md-button} +[See Extensions :material-arrow-right:](extensions.md){ .md-button } -=== ":simple-kubernetes: Kubernetes" +
- **Percona Operator for Kubernetes** is a controller introduced to simplify complex deployments that require meticulous and secure database expertise. +### Configure backups { .title } - Check below to get access to a detailed step-by-step guide. +For production deployments we recommend configuring backups. - [Get started with Percona Operator :octicons-link-external-16:](https://docs.percona.com/percona-operator-for-postgresql/2.0/quickstart.html){.md-button} +[See Backup and disaster recovery in Percona :material-arrow-right:](solutions/backup-recovery.md){.md-button} +
-=== ":octicons-download-16: Tar download (not recommended)" +### Configure high availability with Patroni { .title } - If installing the package (the **recommended** method for a safe, secure, and reliable setup) is not an option, refer to the link below for step-by-step instructions on installing from tarballs using the provided download links. +Deploy a highly available PostgreSQL cluster using Patroni to prevent service interruptions. - In this scenario, you must ensure that all dependencies are met. Failure to do so may result in errors or crashes. - - !!! note +[See High Availability in PostgreSQL :material-arrow-right:](solutions/high-availability.md){.md-button} - This method is **not recommended** for mission-critical environments. - [Install from tarballs :material-arrow-right:](tarball.md){.md-button} +
+
From 1c0089dfa28e9cea37947929f7ecc6af9d6f3f24 Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Thu, 5 Mar 2026 14:54:53 +0200 Subject: [PATCH 4/6] Update installing.md small indent fix --- docs/installing.md | 29 ++++++++++++++--------------- 1 file changed, 14 insertions(+), 15 deletions(-) diff --git a/docs/installing.md b/docs/installing.md index bfd2c8aec..45d5b9bdc 100644 --- a/docs/installing.md +++ b/docs/installing.md @@ -9,23 +9,22 @@ This guide shows how to install and start Percona Distribution for PostgreSQL on ## Fast path (2-minute install) - ```{.bash data-prompt="$"} - wget https://repo.percona.com/apt/percona-release_latest.$(lsb_release -sc)_all.deb - sudo dpkg -i percona-release_latest.$(lsb_release -sc)_all.deb - sudo percona-release setup ppg-18 - sudo apt install percona-postgresql-18 - sudo -i -u postgres psql - ``` +```{.bash data-prompt="$"} +wget https://repo.percona.com/apt/percona-release_latest.$(lsb_release -sc)_all.deb +sudo dpkg -i percona-release_latest.$(lsb_release -sc)_all.deb +sudo percona-release setup ppg-18 sudo apt install percona-postgresql-18sudo -i -u postgres psql +``` + After psql starts, run the following SQL commands: - ```sql - CREATE DATABASE test; - \c test - CREATE TABLE customers (first_name VARCHAR(50), last_name VARCHAR(50), email VARCHAR(100)); - INSERT INTO customers VALUES ('John','Doe','john.doe@example.com'); - SELECT * FROM customers; - \q - ``` +```sql +CREATE DATABASE test; +\c test +CREATE TABLE customers (first_name VARCHAR(50), last_name VARCHAR(50), email VARCHAR(100)); +INSERT INTO customers VALUES ('John','Doe','john.doe@example.com'); +SELECT * FROM customers; +\q +``` For a step-by-step explanation, continue below. From cc22d8165552238f790f8020f9d597eb1a6f3611 Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Thu, 5 Mar 2026 15:39:51 +0200 Subject: [PATCH 5/6] Small updates -fix render issue - update TOC to get Quickstart out of Get Started part --- docs/installing.md | 4 +++- mkdocs.yml | 2 +- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/installing.md b/docs/installing.md index 45d5b9bdc..170ade7c2 100644 --- a/docs/installing.md +++ b/docs/installing.md @@ -12,7 +12,9 @@ This guide shows how to install and start Percona Distribution for PostgreSQL on ```{.bash data-prompt="$"} wget https://repo.percona.com/apt/percona-release_latest.$(lsb_release -sc)_all.deb sudo dpkg -i percona-release_latest.$(lsb_release -sc)_all.deb -sudo percona-release setup ppg-18 sudo apt install percona-postgresql-18sudo -i -u postgres psql +sudo percona-release setup ppg-18 +sudo apt install percona-postgresql-18 +sudo -i -u postgres psql ``` After psql starts, run the following SQL commands: diff --git a/mkdocs.yml b/mkdocs.yml index d183ea8d7..99434f661 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -17,8 +17,8 @@ nav: - 'Home': 'index.md' - 'Percona Server for PostgreSQL': postgresql-server.md - get-help.md + - Quickstart guide: installing.md - Get started: - - Quickstart guide: installing.md - 1. Install: - Via apt: apt.md - Via yum: yum.md From 29a1e836391eb29e6ab4f748e978449130ffa660 Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Thu, 5 Mar 2026 16:29:45 +0200 Subject: [PATCH 6/6] Add installation overview - add new installation overview to tie in installation options for user - update references to installation and update quick start links - add new quick start file - update toc --- docs/index.md | 2 +- docs/installing.md | 125 +++++++++----------------------------- docs/postgresql-server.md | 2 +- docs/quick-start.md | 116 +++++++++++++++++++++++++++++++++++ mkdocs.yml | 5 +- 5 files changed, 151 insertions(+), 99 deletions(-) create mode 100644 docs/quick-start.md diff --git a/docs/index.md b/docs/index.md index aa530c222..16a6f8db4 100644 --- a/docs/index.md +++ b/docs/index.md @@ -24,7 +24,7 @@ Part of the solution, Percona Operator for PostgreSQL, makes it easy to orchestr Get started quickly with these step-by-step installation instructions. -[Quickstart guide :material-arrow-right:](installing.md){ .md-button } +[Quickstart guide :material-arrow-right:](quick-start.md){ .md-button }
diff --git a/docs/installing.md b/docs/installing.md index 170ade7c2..c1e0060df 100644 --- a/docs/installing.md +++ b/docs/installing.md @@ -1,116 +1,51 @@ -# Quickstart guide +# Installation overview -This guide shows how to install and start Percona Distribution for PostgreSQL on Debian- and RHEL-based Linux systems. After completing this guide, you will have: +Percona Distribution for PostgreSQL packages PostgreSQL together with a curated set of open source extensions and tools that are tested to work together reliably. -- PostgreSQL running locally -- A database named `test` -- A table named `customers` -- One inserted row you can query +This section explains how to install Percona Distribution for PostgreSQL on supported platforms. -## Fast path (2-minute install) +Choose the installation method that best fits your environment: -```{.bash data-prompt="$"} -wget https://repo.percona.com/apt/percona-release_latest.$(lsb_release -sc)_all.deb -sudo dpkg -i percona-release_latest.$(lsb_release -sc)_all.deb -sudo percona-release setup ppg-18 -sudo apt install percona-postgresql-18 -sudo -i -u postgres psql -``` +- Package manager, **recommended** for most Linux systems +- Docker, for quick evaluations or development +- Kubernetes, for production Kubernetes environments +- Tarballs, manual installation for custom environments (**not recommended** for mission-critical environments) -After psql starts, run the following SQL commands: +=== ":octicons-terminal-16: Package manager" -```sql -CREATE DATABASE test; -\c test -CREATE TABLE customers (first_name VARCHAR(50), last_name VARCHAR(50), email VARCHAR(100)); -INSERT INTO customers VALUES ('John','Doe','john.doe@example.com'); -SELECT * FROM customers; -\q -``` + Percona provides installation packages in `DEB` and `RPM` format for 64-bit Linux distributions. See the [Percona Software and Platform Lifecycle page :octicons-link-external-16:](https://www.percona.com/services/policies/percona-software-support-lifecycle#pgsql) for the full list of supported platforms and versions. -For a step-by-step explanation, continue below. + If you are on Debian or Ubuntu, use `apt` for installation. -## Install on Debian / Ubuntu (APT) {.power-number} + If you are on Red Hat Enterprise Linux or compatible derivatives, use `yum`. -1. Fetch the `percona-release` package: + [Install via apt :material-arrow-right:](apt.md){.md-button} + [Install via yum :material-arrow-right:](yum.md){.md-button} - ```{.bash data-prompt="$"} - wget https://repo.percona.com/apt/percona-release_latest.$(lsb_release -sc)_all.deb - sudo dpkg -i percona-release_latest.$(lsb_release -sc)_all.deb - ``` +=== ":simple-docker: Docker" -2. Enable the repository and install the package: + Run Percona Distribution for PostgreSQL in a Docker container for quick evaluation or development. - ```{.bash data-prompt="$"} - sudo percona-release setup ppg-18 - sudo apt install percona-postgresql-18 - ``` + Check below to get access to a detailed step-by-step guide. + + [Run in Docker :material-arrow-right:](docker.md){.md-button} - The installation process automatically initializes and starts the default database. +=== ":simple-kubernetes: Kubernetes" -3. Switch to the `postgres` user and open the psql interactive terminal: + Use the Percona Operator for Kubernetes to deploy and manage PostgreSQL clusters on Kubernetes. - ```{.bash data-prompt="$"} - sudo -i -u postgres - psql - ``` + Check below to get access to a detailed step-by-step guide. -4. Create a database and make a table in the database: + [Get started with Percona Operator :octicons-link-external-16:](https://docs.percona.com/percona-operator-for-postgresql/2.0/quickstart.html){.md-button} - ```sql - CREATE DATABASE test; - \c test - CREATE TABLE customers (first_name VARCHAR(50), last_name VARCHAR(50), email VARCHAR(100)); - ``` +=== ":octicons-download-16: Tar download (not recommended)" -5. Insert data in the customers table and query the data insertion: + If installing the package (the **recommended** method for a safe, secure, and reliable setup) is not an option, refer to the link below for step-by-step instructions on installing from tarballs using the provided download links. - ```sql - INSERT INTO customers (first_name, last_name, email) VALUES ('John', 'Doe', 'john.doe@example.com'); - SELECT * FROM customers; - \q - ``` + In this scenario, you must ensure that all dependencies are met. Failure to do so may result in errors or crashes. + + !!! note -Congratulations! Percona Distribution for PostgreSQL is now running and you have created your first database. + This method is **not recommended** for mission-critical environments. -For detailed installation steps and further instructions on Debian and Ubuntu, see the [Install Percona Distribution for PostgreSQL on Debian and Ubuntu](apt.md). - -For detailed installation steps and further instructions on Red Hat Enterprise Linux and derivatives, see the [Install Percona Distribution for PostgreSQL on Red Hat Enterprise Linux and derivatives](yum.md). - -## What's next - -Now that your PostgreSQL server is running, you can explore additional capabilities of Percona Distribution for PostgreSQL. - -
- -### Learn PostgreSQL basics { .title } - -Connect with `psql` and run SQL commands, manage users, roles, and configure authentication. - -[Manipulate data in PostgreSQL :material-arrow-right:](crud.md){ .md-button } - -
- -### Enable extensions { .title } - -Percona Distribution for PostgreSQL includes tested open source extensions, such as `pg_stat_monitor` for query performance monitoring, `pg_tde` for protecting data at rest and more. - -[See Extensions :material-arrow-right:](extensions.md){ .md-button } - -
- -### Configure backups { .title } - -For production deployments we recommend configuring backups. - -[See Backup and disaster recovery in Percona :material-arrow-right:](solutions/backup-recovery.md){.md-button} -
- -### Configure high availability with Patroni { .title } - -Deploy a highly available PostgreSQL cluster using Patroni to prevent service interruptions. - -[See High Availability in PostgreSQL :material-arrow-right:](solutions/high-availability.md){.md-button} - -
-
+ [Install from tarballs :material-arrow-right:](tarball.md){.md-button} diff --git a/docs/postgresql-server.md b/docs/postgresql-server.md index 3d9c346cf..447f5930a 100644 --- a/docs/postgresql-server.md +++ b/docs/postgresql-server.md @@ -13,4 +13,4 @@ These enhancements serve as the foundation for Percona-authored extensions, such For details about available extensions, see the [Percona-authored extensions topic](percona-ext.md). -For a broader overview of integrated tooling and deployment guidance, start with the [Percona Distribution for PostgreSQL Quickstart guide](installing.md). +For a broader overview of integrated tooling and deployment guidance, start with the [Percona Distribution for PostgreSQL Quickstart guide](quick-start.md). diff --git a/docs/quick-start.md b/docs/quick-start.md new file mode 100644 index 000000000..170ade7c2 --- /dev/null +++ b/docs/quick-start.md @@ -0,0 +1,116 @@ +# Quickstart guide + +This guide shows how to install and start Percona Distribution for PostgreSQL on Debian- and RHEL-based Linux systems. After completing this guide, you will have: + +- PostgreSQL running locally +- A database named `test` +- A table named `customers` +- One inserted row you can query + +## Fast path (2-minute install) + +```{.bash data-prompt="$"} +wget https://repo.percona.com/apt/percona-release_latest.$(lsb_release -sc)_all.deb +sudo dpkg -i percona-release_latest.$(lsb_release -sc)_all.deb +sudo percona-release setup ppg-18 +sudo apt install percona-postgresql-18 +sudo -i -u postgres psql +``` + +After psql starts, run the following SQL commands: + +```sql +CREATE DATABASE test; +\c test +CREATE TABLE customers (first_name VARCHAR(50), last_name VARCHAR(50), email VARCHAR(100)); +INSERT INTO customers VALUES ('John','Doe','john.doe@example.com'); +SELECT * FROM customers; +\q +``` + +For a step-by-step explanation, continue below. + +## Install on Debian / Ubuntu (APT) {.power-number} + +1. Fetch the `percona-release` package: + + ```{.bash data-prompt="$"} + wget https://repo.percona.com/apt/percona-release_latest.$(lsb_release -sc)_all.deb + sudo dpkg -i percona-release_latest.$(lsb_release -sc)_all.deb + ``` + +2. Enable the repository and install the package: + + ```{.bash data-prompt="$"} + sudo percona-release setup ppg-18 + sudo apt install percona-postgresql-18 + ``` + + The installation process automatically initializes and starts the default database. + +3. Switch to the `postgres` user and open the psql interactive terminal: + + ```{.bash data-prompt="$"} + sudo -i -u postgres + psql + ``` + +4. Create a database and make a table in the database: + + ```sql + CREATE DATABASE test; + \c test + CREATE TABLE customers (first_name VARCHAR(50), last_name VARCHAR(50), email VARCHAR(100)); + ``` + +5. Insert data in the customers table and query the data insertion: + + ```sql + INSERT INTO customers (first_name, last_name, email) VALUES ('John', 'Doe', 'john.doe@example.com'); + SELECT * FROM customers; + \q + ``` + +Congratulations! Percona Distribution for PostgreSQL is now running and you have created your first database. + +For detailed installation steps and further instructions on Debian and Ubuntu, see the [Install Percona Distribution for PostgreSQL on Debian and Ubuntu](apt.md). + +For detailed installation steps and further instructions on Red Hat Enterprise Linux and derivatives, see the [Install Percona Distribution for PostgreSQL on Red Hat Enterprise Linux and derivatives](yum.md). + +## What's next + +Now that your PostgreSQL server is running, you can explore additional capabilities of Percona Distribution for PostgreSQL. + +
+ +### Learn PostgreSQL basics { .title } + +Connect with `psql` and run SQL commands, manage users, roles, and configure authentication. + +[Manipulate data in PostgreSQL :material-arrow-right:](crud.md){ .md-button } + +
+ +### Enable extensions { .title } + +Percona Distribution for PostgreSQL includes tested open source extensions, such as `pg_stat_monitor` for query performance monitoring, `pg_tde` for protecting data at rest and more. + +[See Extensions :material-arrow-right:](extensions.md){ .md-button } + +
+ +### Configure backups { .title } + +For production deployments we recommend configuring backups. + +[See Backup and disaster recovery in Percona :material-arrow-right:](solutions/backup-recovery.md){.md-button} +
+ +### Configure high availability with Patroni { .title } + +Deploy a highly available PostgreSQL cluster using Patroni to prevent service interruptions. + +[See High Availability in PostgreSQL :material-arrow-right:](solutions/high-availability.md){.md-button} + +
+
diff --git a/mkdocs.yml b/mkdocs.yml index 99434f661..e4ad2cea7 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -17,9 +17,10 @@ nav: - 'Home': 'index.md' - 'Percona Server for PostgreSQL': postgresql-server.md - get-help.md - - Quickstart guide: installing.md + - Quickstart guide: quick-start.md - Get started: - - 1. Install: + - 1. Install: + - Overview: installing.md - Via apt: apt.md - Via yum: yum.md - From tarballs: tarball.md