Rocky LinuxでPostgreSQLを使い始めたい方向けに、最短でインストール→初期化→起動→接続確認までを一気に進めます。
「とりあえず動かす」だけでなく、あとで困りにくいように 確認コマンド と つまずきポイント もまとめています。
この記事の対象読者
前提(この記事の環境)
PostgreSQLをインストールする
まずはパッケージを入れます。
1-1) パッケージインストール
Rocky Linuxの標準リポジトリのPostgreSQLを使う場合の最短例です。
sudo dnf -y install postgresql-server postgresql1-2) インストール確認(どれが入ったか)
rpm -qa | grep -E '^postgresql|^postgresql-server'1-3) psqlのバージョン確認
psql --version手順2:DBを初期化する(初回だけ必要)
PostgreSQLは「インストールしただけ」では起動できません。
最初に DBクラスタ初期化(initdb) が必要です。
2-1) 初期化
sudo postgresql-setup --initdb2-2) 初期化できたか確認(データディレクトリ)
代表例(環境により場所は異なることがあります):
sudo ls -la /var/lib/pgsql/dataここに PG_VERSION や postgresql.conf などが作られていれば、初期化は成功しています。
手順3:サービスを起動する(+自動起動)
3-1) 起動
sudo systemctl start postgresql3-2) 自動起動を有効化(再起動後も起動する)
sudo systemctl enable postgresql3-3) 状態確認(必ず実行)
systemctl status postgresql --no-pageractive (running) が見えればOKです。
手順4:待受とプロセスを確認する(動作の二重チェック)
「起動したつもり」でも実は止まっている、がよくあるので二重チェックします。
4-1) 5432ポート待受確認
sudo ss -lntp | grep 54324-2) postgresプロセス確認
ps -ef | grep postgres | grep -v grep手順5:psqlでローカル接続確認(ここまで来たら成功)
まずは管理用アカウント(postgres)で接続できるか確認します。
5-1) postgresユーザーに切り替えて接続
sudo -iu postgres
psql入れたら以下で確認:
SELECT version();
\l
\qpostgresユーザーから抜ける:
exit(任意)アプリ用ユーザーとDBを作る(最小で安全な運用)
「postgresでアプリ接続」は避けた方が無難です。
最小でも 専用ユーザー+専用DB を作っておくと後で楽になります。
6-1) ユーザー作成(例:appuser)
sudo -iu postgres
createuser --pwprompt appuser6-2) DB作成(例:appdb)
createdb -O appuser appdb6-3) 接続テスト(ローカル)
psql -U appuser -d appdb -h 127.0.0.1ここでパスワード入力後に接続できればOKです。
よくあるつまずき(原因→対処を最短で)
1) postgresql-setup: command not found
原因:postgresql-server が入っていない/環境差
対処:
sudo dnf -y install postgresql-server
入れた後に再度:
sudo postgresql-setup –initdb
2) systemctl start postgresql で起動しない
まずログで原因特定が最短です:
sudo journalctl -u postgresql –no-pager -n 200
「初期化していない」系が多いので、未実施なら:
sudo postgresql-setup --initdb
sudo systemctl restart postgresql3) psql: FATAL: role “xxxx” does not exist
原因:そのロール(ユーザー)が存在しない
対処:createuser で作る、または sudo -iu postgres で接続して確認する
4) 5432が待ち受けていない
原因候補:サービス停止/起動失敗/別ポート設定
対処:
systemctl status postgresql を再確認
journalctl -u postgresql でエラー確認
設定変更したなら restart しているか確認
FAQ
Q1. 今動いているPostgreSQLのバージョンはどこで見ますか?
コマンド:
psql –version
SQL(接続後):
SELECT version();
Q2. 別PCから接続したい(リモート接続)
この記事ではローカル確認に限定しています。
リモート接続は pg_hba.conf / listen_addresses / firewalld / SELinux の4点セットでミスが起きやすいので、次の記事で手順を分けて解説するのがおすすめです。
Q3. “とりあえず動けばOK”ですが、最低限やるべきことは?
最低限おすすめはこの2つです。
postgresユーザーでアプリ接続しない(専用ユーザーを作る)
ログ確認コマンド(journalctl)を覚えておく
まとめ
この記事では、Rocky LinuxでPostgreSQLを インストール→初期化→起動→接続確認 まで最短で進めました。
ここまで終われば「PostgreSQLが動く状態」は完成です。
