Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,11 +20,11 @@ Part of the solution, Percona Operator for PostgreSQL, makes it easy to orchestr

<div data-grid markdown><div data-banner markdown>

### :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 }

</div><div data-banner markdown>

Expand Down
59 changes: 54 additions & 5 deletions docs/installing.md
Original file line number Diff line number Diff line change
@@ -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

Expand Down