Categories
All posts
AI
Analytics
Announcements & Releases
Benchmarks & Comparisons
Data Visualization
Developer Q&A
Engineering
General
IoT
Open Source
PostgreSQL
PostgreSQL Performance
PostgreSQL Tips
State of PostgreSQL
Time Series Data
Tutorials
PostgreSQL for time series and events
Engineered for powerful price-performance and speed.
Learn more about Timescale
Category: All posts
Tutorials
Mar 25, 2025
Hi, we’re Timescale! We build a faster PostgreSQL for demanding workloads like time series, vector, events, and analytics data. Check us out.
Posted by
Ajay Kulkarni
Date updated
Mar 25, 2025
Posted by
Ajay Kulkarni
Share
Subscribe to the Timescale Newsletter
By submitting you acknowledge Timescale’s Privacy Policy.
Date updated
Mar 25, 2025
Posted by
Ajay Kulkarni
Share
Subscribe to the Timescale Newsletter
By submitting you acknowledge Timescale’s Privacy Policy.
less than 1 minute read
The installation process for the PostgreSQL client, psql, may vary depending on your operating system. Here are the general steps for some popular operating systems:
Linux (Ubuntu)
- Open the terminal and run the following command to update the package list:
- Install the PostgreSQL client by running the following command:
sudo apt-get install postgresql-client
macOS
- Install Homebrew by running the following command in Terminal:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- Once Homebrew is installed, run the following command to install PostgreSQL:
Alternatively, you could also use homebrew to install libpq that gives you psql, pg_dump and a whole bunch of other client utilities.
Unfortunately, since it provides some of the same utilities as are included in the full PostgreSQL package, brew installs it “keg-only” which means it isn’t in the PATH by default.
Windows
- Download the PostgreSQL installer for Windows from the official website.
- Run the downloaded installer and follow the prompts to install PostgreSQL.
After completing the installation process, you should be able to run psql in the terminal/command prompt to connect to your PostgreSQL database.
Установка PostgreSQL по шагам
1. Загружаем дистрибутив
Мы советуем скачивать актуальные версии на официальном сайте СУБД. Чтобы найти установщик PostgreSQL 15 для Windows нажимаем Download → Windows → Download the installer.
На сайте выбираем интересующую нас версию PostgreSQL и платформу Windows x86-64. Начинается загрузка установочного файла на компьютер.
2. Запускаем установочный файл
В ходе установки проводится проверка на наличие необходимых компонентов, например, Microsoft Visual C++. Если каких-то компонентов не хватает, они устанавливаются автоматически.
В открывшемся приветственном окне нажимаем Next.
3. Указываем каталог для установки
Выбираем путь, куда нужно установить PostgreSQL 15. По умолчанию предлагается C:\Program Files\PostgreSQL\15, его можно оставить.
4. Выбираем дополнительные компоненты
Вместе с СУБД можно установить следующие компоненты:
- PostgreSQL Server — это сам сервер баз данных PostgreSQL;
- pgAdmin 4 — приложение с графическим интерфейсом для администрирования СУБД;
- Stack Builder — утилита, которая поможет установить дополнительные библиотеки и инструменты в PostgreSQL;
- Command Line Tools — инструменты для работы с СУБД через командную строку.
5. Указываем каталог для файлов баз данных
Можно оставить путь по умолчанию C:\Program Files\PostgreSQL\15\data или выбрать свой. Здесь будет храниться вся информация, поэтому перед выбором каталога важно проверить, что на диске достаточно свободного места.
6. Устанавливаем пароль для системного пользователя
Рекомендуем выбирать пароль из 12 и более символов, со строчными и прописными буквами, цифрами и символами. Логин postgres устанавливается по умолчанию.
7. Выбираем порт и кодировку
Можно оставить порт по умолчанию 5432 или указать свой. Далее нажать Next.
В появившемся списке локалей выбираем подходящую для себя локализацию или оставляем значение по умолчанию [Default locale]. Нажимаем Next.
В будущем для новых баз данных на сервере можно будет указать конкретную кодировку.
8. Проверяем параметры и завершаем установку
В финальном окне выводится сводная информация об установке PostgreSQL 15: дополнительные компоненты, выбранные порт и каталог, логин. Если параметры указаны верно, нажимаем Next или возвращаемся для корректировок с помощью кнопки Back.
Все готово. Нажмите Next и дождитесь, когда необходимые компоненты установятся. Обычно процесс занимает не более 5 минут.
Одновременно с завершением процесса установки можно запустить компонент Stack Builder. Если запуск не требуется, снимаем флажок и нажимаем Finish.
Установка приложений с помощью Stack Builder
Запустить Stack Builder после окончания установки PostgreSQL можно с помощью команды:
C:\"Program Files"\PostgreSQL\15\bin\stackbuilder.exe
При этом путь будет зависеть от того, какие диск и каталог были выбраны во время установки СУБД.
В начальном окне Stack Builder выбираем СУБД, для которой будем устанавливать дополнения. Для дальнейшей загрузки необходимо подключение к Интернету.
Далее выбираем дополнительные приложения, которые нужны для работы с базой данных. При клике на любой из компонентов внизу окна появляется его краткое описание. Мы выбрали Migration Toolkit и PEM-HTTPD.
Следующим шагом указываем путь на локальной машине, куда нужно загрузить пакеты выбранных дополнений.
Дожидаемся загрузки файлов.
После этого скачанные приложения устанавливаются по очереди. Перезагружать компьютер следует только после того, как все дополнения из набора будут установлены.
Если устройство все-таки было перезапущено раньше, чем завершилась установка всех приложений, можно запустить инсталляцию с помощью .exe файла. Он находится в папке, которая была выбрана на предыдущем шаге. В нашем примере это папка C:\Program Files\PostgreSQL\additions.
После установки всех выбранных приложений Stack Builder сообщает об успешном завершении.
Запуск pgAdmin 4
pgAdmin 4 — это утилита с простым визуальным интерфейсом, которая помогает работать с PostgreSQL. Ее можно установить отдельно от СУБД, скачав дистрибутив на официальном сайте.
Запустить pgAdmin 4 на устройстве можно через поиск в панели Пуск.
Еще один способ запустить утилиту — ввести в командной строке:
C:\Users\Selectel>C:\"Program Files"\PostgreSQL\15\"pgAdmin 4"\bin\pgAdmin4
Сразу при запуске необходимо придумать мастер пароль. Он нужен для защиты сервера и последующей разблокировки сохраненных паролей.
Чтобы подключиться к серверу СУБД кликните на Servers в левой панели и в раскрывшемся списке выберите PostgreSQL 15. Нажмите на него правой кнопки мыши и выберите Connect Server.
Для подключения нужно ввести пароль пользователя postgres — его мы задавали на этапе установки PostgreSQL 15.
После аутентификации мы подключаемся к своему серверу PostgreSQL 15 и видим все объекты, которые на нем расположены.
Чтобы изменить язык в pgAdmin 4 нажмите в левом верхнем углу File → Preferences. Далее в открывшемся окне в разделе Miscellaneous выберите пункт User language и в выпадающем списке с доступными языками найдите Russian. Язык изменится после перезагрузки страницы.
Сетевой доступ к PostgreSQL
Чтобы сервер PostgreSQL был доступен другим устройствам по сети, необходимо добавить правила в файрволе Windows. Проще всего сделать это с помощью PowerShell или командной строки. При этом команды необходимо выполнять от имени администратора. Еще можно использовать графический интерфейс. Ниже рассмотрим каждый из способов.
PowerShell
New-NetFirewallRule -Name 'POSTGRESQL-PORT' -DisplayName 'Selectel Port PostgreSQL2' -Direction Inbound -Enabled True -Protocol TCP -LocalPort 5432
Командная строка
netsh advfirewall firewall add rule name="Selectel Port PostgreSQL" dir=in action=allow protocol=TCP localport=5432
Графический интерфейс
В меню Пуск ищем брандмауэр и выбираем Брандмауэр Защитника Windows.
В левом меню кликаем на Дополнительные параметры.
Заходим в Правила для входящих подключений и в правой части окна выбираем Создать правило.
Устанавливаем настройки так, как показано на скринах ниже:
На шаге Профиль вы сами решаете, для каких профилей использовать новое правило. Мы оставим все профили включенными.
Задаем имя для нового правила и его описание.
После того, как мы добавили правило в файрволе Windows любым из описанных способов, оно появится в брандмауэре.
Смена порта для подключения к СУБД
Чтобы изменить порт подключения к PostgreSQL находим файл postgresql.conf. Путь к нему — C:\Program Files\PostgreSQL\15\data.
В этом файле ищем строку с указанием port=5432 и меняем номер порта на нужный. Для поиска нужной строки поможет Ctrl+F.
После этого перезапускаем службу postgresql-x64-15 используя встроенное в Windows приложение Службы. Его можно найти в меню Пуск или с помощью команды Win+R на клавиатуре и далее services.msc.
Еще postgresql-x64-15 можно перезапустить с помощью PowerShell. Для этого в консоли PowerShell нужно ввести команду:
Restart-Service-Name postgresql-x64-15
Проверка открытого порта
Проверить открыт ли указанный порт для входящего трафика можно с помощью пробного подключения по протоколу Telnet. Дальше рассмотрим по шагам, как включить этот протокол на Windows 11 и 10.
Telnet на Windows 11
- Через меню Пуск находим и открываем приложение Параметры.
- В открывшемся окне слева выбираем Приложения.
3. В окне Приложения открываем пункт Дополнительные компоненты.
4. В поисковой строке вводим Другие компоненты и открываем указанный параметр.
5. В открывшемся окне находим Клиент Telnet и включаем этот компонент, нажав кнопку ОК.
Telnet на Windows 10
- Через меню Пуск находим и открываем приложение Панель управления.
2. В открывшемся окне находим Программы и компоненты.
3. Кликаем слева на Включение или отключение компонентов Windows.
4. В открывшемся окне находим Клиент Telnet и включаем этот компонент, нажав кнопку ОК.
Теперь протокол Telnet включен и можно проверить открыт ли порт, который прослушивает PostgreSQL. Для этого в командной строке введем:
telnet <IP-address> <Port>
Где IP-address это IP-адрес сервера или его имя, а Port — номер порта, по которому будет производится подключение. Например,
C:\Users\Selectel>telnet 10.0.10.55 5432
Если подключение произошло успешно и порт открыт, будет отображаться пустая командная строка, а имя окна изменится на Telnet <IP-address>.
Если порт закрыт и подключение произвести не удалось, мы увидим сообщение о сбое.
Управление PostgreSQL через командную строку
Чтобы управлять СУБД с помощью командной строки, необходимо открыть ее от имени администратора.
Далее перейти в каталог \bin, так как все основные инструменты PostgreSQL лежат именно в этой папке:
C:\Users\Selectel>cd C:\Program Files\PostgreSQL\15\bin
С помощью параметра -V можно проверить версию СУБД, которая была установлена:
C:\Program Files\PostgreSQL\15\bin>psql -V
Для корректного отображения русских символов в Windows 10 и 11 советуем сменить кодировку на Windows-1251:
C:\Program Files\PostgreSQL\15\bin>chcp 1251
Чтобы создать новую базу данных есть команда:
C:\Program Files\PostgreSQL\15\bin>createdb -U postgres SelectelDatabase
Где:
createdb — сама команда создания новой базы данных;
-U — параметр для указания имени пользователя;
postgres — имя пользователя;
SelecterDatabase — название новой базы данных.
Теперь проверим была ли создана новая база данных. Введем команду с параметром -l, который выводит список доступных баз данных:
C:\Program Files\PostgreSQL\15\bin>psql -U postgres -l
Получаем список:
Чтобы создать нового пользователя воспользуемся командой:
C:\Program Files\PostgreSQL\15\bin>createuser -U postgres TRex
Где:
postgres — пользователь с правами создавать других пользователей;
TRex — имя нового пользователя.
После этого необходимо ввести пароль пользователя postgres, который инициирует команду.
Чтобы сразу изменить пароль для новой роли, можно использовать команду:
postgres=# ALTER ROLE “TRex” WITH PASSWORD 'password';
В команде вместо ‘password’ указать новый пароль.
При вводе SQL запросов важно не забывать ставить ; в конце запроса. Enter без ; в конце строки просто сделает переход на новую строку. Поэтому, если вы забыли ввести ; и нажали Enter, не нужно снова печатать всю строку. Достаточно ввести ; и запрос отправится на сервер.
Чтобы изменить права для новой роли, используется команда ALTER ROLE. Параметр CREATEDB дает право на создание базы данных:
postgres=# ALTER ROLE "TRex" CREATEDB;
Для просмотра ролей и их описания используется команда:
postgres=# \du
Теперь пользователь TRex имеет права на создание базы данных:
Для выхода из postgres можно использовать команду \q или exit.
С помощью командной строки можно также создавать таблицы и заполнять их данными. Для этого сначала подключимся к базе данных SelectelDatabase:
C:\Program Files\PostgreSQL\15\bin>psql -U "postgres" "SelectelDatabase"
Создадим таблицу с цветами Colors, где первое поле idcolor будет автоматически заполняться порядковым номером, а второе поле namecolor содержит наименование цвета:
SelectelDatabase=# CREATE TABLE Colors SelectelDatabase-# (idcolor serial PRIMARY KEY, SelectelDatabase(# namecolor varchar(255) NOT NULL);
Теперь добавим в созданную таблицу данные:
Ввод: SelectelDatabase=# INSERT INTO Colors (namecolor) VALUES ('black'); Вывод: INSERT 0 1 Ввод: SelectelDatabase=# INSERT INTO Colors (namecolor) VALUES ('red'); Вывод: INSERT 0 1 Ввод: SelectelDatabase=# INSERT INTO Colors (namecolor) VALUES ('white'); Вывод: INSERT 0 1 Ввод: SelectelDatabase=# INSERT INTO Colors (namecolor) VALUES ('blue'); Вывод: INSERT 0 1
Выведем на экран содержимое таблицы Colors и увидим, что данные успешно записались:
SelectelDatabase=# SELECT * FROM Colors;
Таблица:
С помощью команды \dt можно посмотреть весь список существующих таблиц в базе данных:
SelectelDatabase=# \dt
Все таблицы:
Команда \d позволяет вывести информацию о конкретной таблице. Так, указав таблицу Colors, мы видим параметры с которыми создана данная таблица:
SelectelDatabase=# \d 'Colors'
Параметры таблицы:
Таблицу можно удалить с помощью функции DROP:
SelectelDatabase=# DROP TABLE Colors;
Query Tool — это редактор SQL запросов в pgAdmin 4 с удобным графическим интерфейсом. На русском редактор называется Запросник.
Открыть запросник можно, нажав на одну из указанных на скриншоте кнопок:
Появляется пустое стартовое окно запросника.
Покажем как работает запросник на примере. Для этого создадим таблицу из пяти полей, где будут указаны рейсы самолетов. Первое поле задается автоматически порядковым номером, второе — точка вылета, третье — точка прилета, четвертое — дата и время отправления, пятое — дата и время прибытия самолета.
Вводим запрос:
CREATE TABLE "flight" ( idflight SERIAL PRIMARY KEY, Apoint VARCHAR(255) NOT NULL, Bpoint VARCHAR(255) NOT NULL, Atime timestamp NOT NULL, Btime timestamp NOT NULL ); INSERT INTO "flight" (Apoint, Bpoint, Atime, Btime) VALUES ('Saint-Petersburg', 'Novosibirsk', '2022-11-24 10:05:00', '2022-11-24 14:15:00'), ('Saint-Petersburg', 'Samara', '2022-11-21 16:45:00', '2022-11-21 18:00:00'), ('Saint-Petersburg', 'Moscow', '2022-11-20 13:20:00', '2022-11-20 14:25:00'), ('Saint-Petersburg', 'Netherlands', '2022-11-23 02:30:00', '2022-11-23 05:15:00'), ('Saint-Petersburg', 'Tashkent', '2022-11-27 06:25:00', '2022-11-27 10:25:00');
Чтобы отобразить введенную информацию выполним команду:
SELECT * FROM "flight";
Получаем вот такую таблицу с рейсами:
С использованием SQL запроса можно отсортировать данные в таблице по определенным условиям. Например укажем, что дата вылета должна быть после полуночи 22 ноября 2022 года и точкой прилета не должен быть Ташкент.
SELECT * FROM "flight" WHERE "atime" > '2022-11-22 00:00:00' AND "bpoint" != 'Tashkent';
Выполнив запрос, получим два рейса, которые подходят под заданные условия:
Заключение
В этой инструкции мы рассмотрели, как установить PostgreSQL на устройство с десктопной версией ОС Windows 10 и 11, а также:
- установили дополнительные приложения с помощью утилиты Stack Builder;
- создали правила файрвола для доступа к PostgreSQL по сети;
- поработали с СУБД через командную строку Windows;
- установили и русифицировали pgAdmin 4;
- рассмотрели работу запросника Query Tool.
Install only the necessary tools for a lean, mean PostgreSQL client machine
Why install all of PostgreSQL when your database server is up in the cloud, managed as an IBM Cloud® Database for PostgreSQL?
Most instructions for installing the PostgreSQL tools assume you want the database installed too. It’s a reasonable assumption if you’re dealing with users who don’t have access to PostgreSQL in the cloud or on a remote server.
In this PostgreSQL Tip, we’ll look at how you can install just psql on Windows, Linux, and macOS, allowing you to quickly get up and running and connected to your IBM Cloud Databases (ICD) for PostgreSQL service. We’ll cover the following:
-
macOS with Homebrew
-
Ubuntu 16.04 and 18.04
-
Red Hat Enterprise Linux 7 (and others)
-
Fedora 27 and 28
-
Windows 10
Let’s dive in.
macOS with Homebrew
We recommend Homebrew (link resides outside ibm.com) as a package manager for macOS. With Homebrew in place, you’ll be able to install numerous applications, usually with the programs available in /usr/local/bin
. Homebrew’s package for the PostgreSQL client tools is the libpq
package. Brew makes it easy to install:
brew install libpq
There’s a small catch though—libpq won’t install itself in the /usr/local/bin
directory. To make that happen, you need to run:
brew link --force libpq
This will symlink all the tools (not just libpq) into the /usr/local/bin
directory. You’re now ready to run psql and start connecting.
Ubuntu 16.04 and 18.04
Linux systems (unlike macOS) have a package manager built in. For Ubuntu (and Debian-based distributions) thats’s the apt
command. The PostgreSQL client is distributed in the appositely named postgresql-client
, so all you need to do is run the following:
sudo apt-get install postgresql-client
This will install the PostgreSQL 10 client, which can easily connect to earlier versions of PostgreSQL.
Red Hat Enterprise Linux 7 (and others)
For Red Hat Enterprise Linux (RHEL), there’s a little more set up to do than with Ubuntu. For RHEL, the package manager is yum
. First, you need to point yum
at the PostgreSQL repository like this:
sudo yum install
https://download.postgresql.org/pub/repos/yum/10/redhat/rhel-7-x86_64/pgdg-redhat10-10-2.noarch.rpm
Yum goes to that URL and configures itself to use that package repository. With that done, you can add packages from it by name:
sudo yum install postgresql10
This installs just the client packages. If you are wondering where to find that repository URL, head to Linux Downloads (Red Hat Family) (link resides outside ibm.com). You’ll find a form which will let you select the PostgreSQL version, platform, and architecture, and it’ll give you the appropriate instructions for that Red Hat variant—that includes CentOS, Scientific Linux, and Oracle Enterprise Linux. It also includes Fedora.
Fedora 27 and 28
Fedora’s default repositories already have a PostgreSQL client available from them. So, for Fedora 27, 28, and later, install the PostgreSQL client from the terminal with:
sudo dnf install postgresql.x86_64
And that’s all you need to do!
Windows 10
On Windows 10, there’s a bit more work to be done. We currently recommend using the PostgreSQL installer from Enterprise DB (link resides outside ibm.com). It’s a full installation package for PostgreSQL on Windows but you can set it to only install the command line tools like psql. Click on that link and select PostgreSQL 9.6 or 10 and Windows 10 as the platform. Once the executable file is downloaded, run it and you’ll see the following options:
Select only the Command Line Tools because we don’t need the server installed. After it installs, you’ll need to set up your Windows environment variables so that you can use the psql client in the command prompt.
Go to the Control Panel > System and Security > System and select Advanced system settings.
From there, you’ll see a box called System Properties. Select Environment Variables. A window will appear with the two sets of environment variables. In the top set (marked User variables for…), select the PATH
entry and then click the Edit button. An edit window will appear. Click New and add the path to the psql client. Your path will depend on where PostgreSQL installed, but typically that would be:
C:\Program Files\PostgreSQL\10\bin
After that, click OK a couple of times to go back to the desktop. Start a new Command Prompt, and you should be able to run psql. With no server set and no server running locally, you’ll see the following, which means that it’s working:
Summing up
Now that we’ve covered getting set up with the psql client for PostgreSQL, you can start connecting to IBM Cloud Databases for PostgreSQL without having to install PostgreSQL itself on your local machine. In future PostgreSQL Tips, we’ll cover some of the basic features and functions of the database using your new psql client.
Do you want to access the remote databases installed on the PostgreSQL server from Windows 11 or 10? But don’t want the complete suite of this Database server. Then there is a way using which we can only get the PostgreSQL client but without PGAdmin and other tools on our local machine. In this tutorial, we learn how you can install PSQL Client on Windows 10 or 11:
1. Download the PostgreSQL Client Installer2. Choose Your Installation Folder3. Select Command Line Tools to install the PSQL client4. Run PSQL Client Shell on Windows 11 or 105. Connect your remote PostgreSQL server Database
1. Download the PostgreSQL Client Installer
We can use the Winget package manager to install the PostgreSQL client on Windows 10/11 but it will install the complete server setup. However, here in this tutorial we only want the PSQL client and other important command line tools of it. Therefore, first manually download the PostgreSQL installer package from the EnterpriseDB. Use the link and get the Windows x86-64 Installer.
2. Choose Your Installation Folder
Once the Installer setup is downloaded successfully, double-click to start it. The system will give a warning, ignore it and just click on the RUN button.
After that click on the NEXT from the installation wizard. Now, it will ask for the Installation folder, by default it will be at C:\Program Files\PostgreSQL\”version”.
If you want to change because your C drive doesn’t have enough space or due to any other reason then click on the folder icon and select the directory you want to set.
However, it is recommended to let the default folder be selected if you are not sure about it and simply click on the Next button.
By default, the installer will have all the PostgreSQL components selected such as Server, pgAdmin 4, Stack builder, and Command Line Tools. However, we don’t want the server and other components instead only the PSQL client.
So, uncheck other options and let the CL tools only be selected. This will also install other necessary CLI tools such as pg_dump, pg_restore, pg_bench, pg_basebackup, and more. Now, move forward using the Next button and finish the installation process.
4. Run PSQL Client Shell on Windows 11 or 10
Click on the Windows Start button and type psql
in the search box. Soon you will see SQL Shell (psql) client app option. Select it to run.
5. Connect your remote PostgreSQL server Database
- Once you are on the PSQL client Shell you will see, it will ask you for the Server address. As we don’t have a Database server installed locally, therefore, enter the IP address or domain name of your remote PostgreSQL server.
- After that, enter the name of the Database you want to connect.
- By default, the port to access the PostgreSQL server is 5432, if you haven’t changed it then simply press the Enter key to go by the default one.
- Now, provide the username that is associated with the Database you want to access.
- If everything is correct, the PSQL client will establish a successful connection with the PostgreSQL server and will ask you for the password set for the User of the Database. Provide that and hit the Enter key.
- You will have the shell of the Database to execute SQL commands.
Related Links:
- How to Install Postgresql 14 on Ec2 Amazon Linux 2
- How to create a Mysql Database on Amazon LightSail
- 2 Ways to install pgAdmin 4 on Windows 11 or 10