DEV Community

mehmet akar
mehmet akar

Posted on

Install PostgreSQL on Windows

Install Postgresql on Windows has always been the main issue for postgreSQL newbies. So, I want to make a comprhensive tutorial about that.

How to Install PostgreSQL on Windows: A Comprehensive Guide**

PostgreSQL is a powerful, open-source relational database management system known for its robustness and scalability. Installing PostgreSQL on Windows is a straightforward process, but it requires careful attention to configuration settings to ensure a smooth experience. This guide will walk you through the installation process step by step.


Step 1: Download PostgreSQL Installer

  1. Visit the official PostgreSQL website: https://www.postgresql.org/download/windows/
  2. Click on the "Download the installer" link, which will redirect you to EnterpriseDB’s website.
  3. Choose the appropriate version of PostgreSQL for Windows and download the installer.

Step 2: Run the PostgreSQL Installer

  1. Locate the downloaded .exe file and double-click it to start the installation process.
  2. If prompted by Windows User Account Control, click "Yes" to allow the installation.
  3. The PostgreSQL setup wizard will launch. Click "Next" to proceed.

Step 3: Choose Installation Directory

  1. By default, PostgreSQL will install in C:\Program Files\PostgreSQL\<version>.
  2. You can change the directory if necessary, but it is recommended to keep the default.
  3. Click "Next" to continue.

Step 4: Select Components

The installer provides various components. By default, the following are selected:

  • PostgreSQL Server (required)
  • pgAdmin 4 (GUI management tool)
  • Stack Builder (optional, for additional extensions)

Ensure that "PostgreSQL Server" is selected, then click "Next".


Step 5: Set Data Directory

  1. The installer will prompt you to specify a directory for database storage.
  2. By default, this is C:\Program Files\PostgreSQL\<version>\data.
  3. Click "Next" to accept or change as needed.

Step 6: Configure PostgreSQL Superuser (postgres)

  1. You must create a password for the PostgreSQL superuser (postgres).
  2. Choose a strong password and confirm it.
  3. Click "Next".

Step 7: Set Port Number

  1. PostgreSQL uses port 5432 by default.
  2. Unless another application is using this port, keep the default setting.
  3. Click "Next" to proceed.

Step 8: Choose Locale Settings

  1. The default locale is usually sufficient for most users.
  2. Select the appropriate locale based on your language and region.
  3. Click "Next".

Step 9: Begin Installation

  1. Review your settings.
  2. Click "Next" and then "Install" to start the installation process.
  3. Wait for the installation to complete. This may take a few minutes.

Step 10: Verify Installation

  1. Once installed, you can verify PostgreSQL is running by:
    • Opening the Services panel (services.msc) and checking if postgresql-<version> is running.
    • Running the following command in the Windows Command Prompt:
   psql -U postgres -W
Enter fullscreen mode Exit fullscreen mode
  1. Enter the password you set during installation to access the PostgreSQL prompt.

Step 11: Using pgAdmin 4

  1. Open pgAdmin 4 from the Start menu.
  2. Connect to your PostgreSQL instance:
    • Click "Add New Server"
    • Under the General tab, enter a name for the connection.
    • Under Connection, enter:
      • Host: localhost
      • Port: 5432
      • Username: postgres
      • Password: (use the password you set during installation)
    • Click "Save" and connect.

Step 12: Enable PostgreSQL in Windows Firewall (Optional)

If you need remote access:

  1. Open Windows Defender Firewall and go to Inbound Rules.
  2. Add a new rule for PostgreSQL allowing connections on port 5432.

Step 13: Uninstalling PostgreSQL (If Needed)

  1. Open Control Panel > Programs and Features.
  2. Select PostgreSQL and click Uninstall.
  3. Follow the prompts to remove PostgreSQL and its components.

Install PostgreSQL on Windows: The Final Sentence...

Installing PostgreSQL on Windows is a simple process when following these steps. Whether you are using it for local development, testing, or production environments, ensuring a correct installation and configuration will allow you to leverage the full power of PostgreSQL effectively.

For advanced configurations, consider tuning performance settings and exploring additional extensions available via Stack Builder.

Top comments (0)