Fixing the Issue: How to Troubleshoot The PgAdmin 4 Server Could Not Be Contacted Error

In this guide, we'll walk you through the process of troubleshooting the "The pgAdmin 4 server could not be contacted" error. This error usually occurs when you're trying to use the pgAdmin 4 tool to manage your PostgreSQL databases, but the server is unable to establish a connection with pgAdmin.

Follow the steps below to resolve the issue:

Step 1: Check the PgAdmin 4 Configuration File

First, make sure that your pgAdmin 4 configuration file is set up correctly.

Open the or file located in the pgAdmin 4 installation folder. The default location is:

  • Windows: C:\Program Files\pgAdmin 4\v5\web
  • macOS: /Library/PostgreSQL/pgAdmin 4/web
  • Linux: /usr/local/lib/python3.x/dist-packages/pgadmin4

Verify that the SERVER_MODE and ALLOWED_HOSTS settings are configured correctly. For example, if you're running pgAdmin 4 in server mode, your configuration should look like this:


If you're running pgAdmin 4 in desktop mode, your configuration should look like this:

ALLOWED_HOSTS = ['localhost', '']

Save the configuration file and restart pgAdmin 4.

Step 2: Verify the PgAdmin 4 Service Status

Make sure the pgAdmin 4 service is running correctly.

Windows: Open the "Services" application and look for the "pgAdmin 4" service. Ensure that its status is set to "Running."

macOS: Open the "Activity Monitor" and search for "pgAdmin." Ensure that the process is running.

Linux: Run the following command in the terminal:

systemctl status pgadmin4

Ensure that the service is "active (running)."

Step 3: Check Firewall and Antivirus Settings

Your firewall or antivirus software might be blocking the connection between pgAdmin 4 and the server. Temporarily disable your firewall and antivirus software, then try connecting again. If the issue is resolved, create exceptions for pgAdmin 4 in your firewall and antivirus settings.

Step 4: Examine Log Files

If the issue persists, examine the log files to identify any error messages or other relevant information. The log files are located in the following directories:

  • Windows: C:\Users\YourUsername\AppData\Roaming\pgAdmin\pgadmin.log
  • macOS: ~/Library/Application Support/pgAdmin/pgadmin.log
  • Linux: ~/.pgadmin/pgadmin.log

Frequently Asked Questions (FAQs)

How do I install pgAdmin 4?

Refer to the official pgAdmin 4 documentation for detailed installation instructions for your specific operating system.

How do I update pgAdmin 4 to the latest version?

To update pgAdmin 4, simply download the latest version from the pgAdmin 4 download page and follow the installation instructions.

Can I use pgAdmin 4 to manage multiple PostgreSQL servers?

Yes, pgAdmin 4 supports managing multiple PostgreSQL servers. You can add multiple servers by clicking on the "Add New Server" button in the "Servers" tab.

Why is my pgAdmin 4 interface slow or unresponsive?

This issue might be due to insufficient system resources or an outdated version of pgAdmin 4. Try closing other applications to free up system resources, or update pgAdmin 4 to the latest version.

Can I use pgAdmin 4 with other databases like MySQL or Oracle?

No, pgAdmin 4 is specifically designed for managing PostgreSQL databases. To manage other databases, consider using alternative tools such as MySQL Workbench for MySQL or Oracle SQL Developer for Oracle.

Great! You’ve successfully signed up.

Welcome back! You've successfully signed in.

You've successfully subscribed to

Success! Check your email for magic link to sign-in.

Success! Your billing info has been updated.

Your billing was not updated.