PostgreSQL · 1 min read · Nov 20, 2025

Ubuntu 18.04 LTSにPostgreSQLとpgAdmin4をインストールする方法

pgAdmin4は、複数のPostgreSQLデータベースバージョン用に設計されたオープンソースのPostgreSQL管理ツールです。pgAdmin4は、PostgreSQLサーバーで見られるすべての機能を備えて作成されています。PythonとjQueryで書かれており、Windows、Mac、Linuxにインストールできます。デスクトップアプリケーションまたはApache2などのWebサーバーの背後で実行されるサーバーアプリケーションとしてインストールできる複数のデプロイメントモデルを提供します。

このチュートリアルでは、Ubuntu 18.04サーバーでのpgAdmin4「サーバーモード」のインストールと構成を示します。pgAdmin4はApache Webサーバーの背後でuWSGIサービスとして実行され、リポジトリからのpgAdmin4のインストールとソースからのインストールの両方をカバーします。

前提条件

  • Ubuntu 18.04サーバー
  • ルート権限
  • PostgreSQLインストールの基本知識

Ubuntu 18.04サーバーにPostgreSQLをインストールする

まず、PostgreSQLデータベース自体の基本的なインストールと構成を示します。公式PostgreSQLリポジトリおよびデフォルトのUbuntuリポジトリからインストールできます。

公式リポジトリからPostgreSQLデータベースをインストールしたい場合は、次のコマンドを実行してPostgresキーとリポジトリを追加します。

wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -  
 sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt/ `lsb_release -cs`-pgdg main" >> /etc/apt/sources.list.d/pgdg.list'

その後、すべてのリポジトリを更新し、PostgreSQLをインストールします。

sudo apt update  
 sudo apt -y install postgresql postgresql-contrib

インストール後、デフォルトユーザー「postgres」にログインし、「psql」PostgreSQLコマンドラインインターフェースを実行します。

su - postgres  
 psql

次に、psqlインターフェースに次のクエリを実行してPostgresユーザーの新しいパスワードを追加します。

    ext{password postgres}  
 TYPE YOUR PASSWORD

リポジトリからpgAdmin4をインストールする

デフォルトでは、PostgreSQLはpgAdmin4パッケージをインストールするための独自のリポジトリを提供します。

1. PostgreSQLリポジトリを追加する

PostgreSQLキーをダウンロードし、次のコマンドを実行してリポジトリを追加します。

wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -  
 sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt/ `lsb_release -cs`-pgdg main" >> /etc/apt/sources.list.d/pgdg.list'

2. pgadmin4をインストールする

その後、すべての利用可能なリポジトリを更新し、以下のaptコマンドを使用してpgAdmin4パッケージをインストールします。

sudo apt update  
 sudo apt install pgadmin4 pgadmin4-apache2 -y

インストール中に、メールユーザー名の構成とパスワードの構成を求められます。

自分のメールアドレスを入力します。これはユーザー名として使用されます。

次に、パスワードを入力します。

インストールが完了したら、Webブラウザを開き、以下のサーバーIPアドレスを入力します。

http://10.9.9.15/pgadmin4/

pgAdmin4のログインページが表示されます。メールアドレスとパスワードでログインします。

pgAdminダッシュボードが表示されます。

ソースからpgAdmin4をインストールする

ソースからpgAdmin4をインストールするには、システムにいくつかのパッケージ依存関係をインストールし、pgAdmin4 uWSGIサービスを提供するためにApache Webサーバーを手動で構成する必要があります。

- ユーザーとディレクトリを作成する

まず、非ルートユーザーにpgAdmin4をインストールしたいと思います。したがって、新しいユーザーを作成し、pgAdmin4用のいくつかのディレクトリを作成する必要があります。

次のコマンドを実行して「ahmad」という新しいユーザーを作成します。

useradd -m -s /bin/bash ahmad  
 passwd ahmad

次に、pgAdmin4のログディレクトリと「sessions」と「storage」のデータディレクトリを作成します。

mkdir -p /var/log/pgadmin4/  
 mkdir -p /var/lib/pgadmin4/{sessions,storage}

その後、これらのディレクトリの所有者を「ahmad」ユーザーに変更します。

chown -R ahmad:ahmad /var/log/pgadmin4/ /var/lib/pgadmin4/

- 依存関係をインストールする

pgAdmin4のインストールに必要なすべてのパッケージ依存関係（Python、Python pip、virtualenvなど）を次のコマンドを実行してインストールします。

sudo apt install build-essential libssl-dev libffi-dev libgmp3-dev virtualenv python-pip libpq-dev python-dev -y

その後、Apache2 Webサーバーとmod_wsgiをインストールします。

sudo apt install apache2 apache2-utils libapache2-mod-wsgi libexpat1 ssl-cert python -y

- Pythonの仮想環境を作成する

このガイドでは、pgAdmin4をPythonの仮想環境内にインストールします。

「ahmad」ユーザーにログインし、「pgadmin4」という名前の新しいPython仮想環境を作成します。

su - ahmad  
 virtualenv pgadmin4

次に、「pgadmin4」ディレクトリに移動し、仮想環境をアクティブにします。

cd pgadmin4/  
 source bin/activate

- pgadmin4をインストールする

Pythonの仮想環境内で、pgAdmin4のwhlパッケージファイルをダウンロードします。

wget https://ftp.postgresql.org/pub/pgadmin/pgadmin4/v3.6/pip/pgadmin4-3.6-py2.py3-none-any.whl

次に、pipコマンドを使用してパッケージをインストールします。

pip install pgadmin4-3.6-py2.py3-none-any.whl

pgAdmin4のインストールを待ちます。

「サーバーモード」でpgAdmin4を実行するには、Pythonのsite-packagesディレクトリに追加の構成を追加する必要があります。

「lib/python-version/site-packages/pgadmin4」ディレクトリに移動し、「config_local.py」という名前の新しい構成ファイルを作成します。

cd lib/python2.7/site-packages/pgadmin4/  
 vim config_local.py

以下の構成を貼り付けます。

LOG_FILE = '/var/log/pgadmin4/pgadmin4.log'
SQLITE_PATH = '/var/lib/pgadmin4/pgadmin4.db'
SESSION_DB_PATH = '/var/lib/pgadmin4/sessions'
STORAGE_DIR = '/var/lib/pgadmin4/storage'
SERVER_MODE = True

保存して閉じます。

その後、「setup.py」スクリプトを実行します。

python setup.py

管理者のメールとパスワードの構成を求められます。詳細を入力すると、pgAdminのインストールが完了します。

注意:

「psycopg2」パッケージが次のリリースで名前が変更されるという通知が表示された場合は、パッケージのバイナリバージョンをインストールしてください。

pip install psycopg2-binary

その後、Pythonの仮想環境を無効にし、pgAdmin4のログおよびデータディレクトリの所有者を「www-data」ユーザーに変更します。

deactivate

chown -R www-data:www-data /var/lib/pgadmin4/  
 chown -R www-data:www-data /var/log/pgadmin4/

- Apache2を構成する

このガイドでは、Apache2 WebサーバーをuWSGIアプリケーションpgAdmin4のリバースプロキシとして使用します。

「/etc/apache2/sites-available」ディレクトリに移動し、「pgadmin4.conf」という名前の新しい仮想ホストファイルを作成します。

cd /etc/apache2/sites-available/  
 vim pgadmin4.conf

「ServerName」を自分のドメイン名に変更し、以下を貼り付けます。


    ServerName pgadmin.ahmad-labs.io
    LogLevel debug
    ErrorLog ${APACHE_LOG_DIR}/pgadmin-error.log
    CustomLog ${APACHE_LOG_DIR}/pgadmin-access.log combined

    LoadModule wsgi_module modules/mod_wsgi.so
    WSGIDaemonProcess pgadmin processes=1 threads=25 python-home=/home/ahmad/pgadmin4
    WSGIScriptAlias / /home/ahmad/pgadmin4/lib/python2.7/site-packages/pgadmin4/pgAdmin4.wsgi
 
    
        WSGIProcessGroup pgadmin
        WSGIApplicationGroup %{GLOBAL}
        Require all granted

保存して閉じます。

次に、構成をテストし、pgAdmin4の仮想ホストを有効にします。

apachectl configtest  
 a2ensite pgadmin4

エラーがないことを確認し、Apache2サービスを再起動します。

systemctl restart apache2

最後に、pgAdmin4はApache Webブラウザの背後でuWSGIサービスとして稼働しています。

Webブラウザを開き、pgadminのドメイン名を入力します。

http://pgadmin.hakase-labs.io/

pgAdmin4のログインページが表示されます。

pgAdmin4を使用してPostgreSQLデータベースに接続する

メールアドレスとパスワードを使用してpgAdmin4ダッシュボードにログインします。

「サーバーを追加」ボタンをクリックし、接続したいPostgreSQLサーバーの詳細を入力します。

「保存」をクリックします。

その後、左側のパネルにPostgreSQLデータベースの詳細が表示されます。

最終的に、pgAdmin4はUbuntu 18.04にインストールされました。

リンク

Share: X/Twitter LinkedIn
#PostgreSQL

新しい投稿を受信箱で受け取る

スパムはありません。いつでも購読を解除できます。