PostgreSQL /etc/systemd/postgresql@.service

Authentic ๐Ÿ“‹ Ubuntu 22.04 LTS (Jammy Jellyfish) 40 lines

Compatibility

Currently viewing:
Ubuntu 22.04 LTS (Jammy Jellyfish)
Also compatible:
Debian 10 (Buster) Debian 11 (Bullseye) Debian 12 (Bookworm) Debian 13 (Trixie) Ubuntu 20.04 LTS (Focal Fossa) Ubuntu 24.04 LTS (Noble Numbat)
Different versions:

File Info

Size
40 lines
MD5
5b25f284506ad288820d584bea86fb23
SHA256
4c44931bba34e0754b7c0762852a5c1b615a1e307df9c458d231232d55e4c907

Quick Commands

curl:
curl https://exampleconfig.com/api/v1/config/original/5b25f284506ad288820d584bea86fb23?hint=postgresql@.service
wget:
wget -O postgresql@.service https://exampleconfig.com/api/v1/config/original/5b25f284506ad288820d584bea86fb23?hint=postgresql@.service
/etc/systemd/postgresql@.service
# systemd service template for PostgreSQL clusters. The actual instances will
# be called "postgresql@version-cluster", e.g. "postgresql@9.3-main". The
# variable %i expands to "version-cluster", %I expands to "version/cluster".
# (%I breaks for cluster names containing dashes.)

[Unit]
Description=PostgreSQL Cluster %i
AssertPathExists=/etc/postgresql/%I/postgresql.conf
RequiresMountsFor=/etc/postgresql/%I /var/lib/postgresql/%I
PartOf=postgresql.service
ReloadPropagatedFrom=postgresql.service
Before=postgresql.service
# stop server before networking goes down on shutdown
After=network.target

[Service]
Type=forking
# -: ignore startup failure (recovery might take arbitrarily long)
# the actual pg_ctl timeout is configured in pg_ctl.conf
ExecStart=-/usr/bin/pg_ctlcluster --skip-systemctl-redirect %i start
# 0 is the same as infinity, but "infinity" needs systemd 229
TimeoutStartSec=0
ExecStop=/usr/bin/pg_ctlcluster --skip-systemctl-redirect -m fast %i stop
TimeoutStopSec=1h
ExecReload=/usr/bin/pg_ctlcluster --skip-systemctl-redirect %i reload
PIDFile=/run/postgresql/%i.pid
SyslogIdentifier=postgresql@%i
# prevent OOM killer from choosing the postmaster (individual backends will
# reset the score to 0)
OOMScoreAdjust=-900
# restarting automatically will prevent "pg_ctlcluster ... stop" from working,
# so we disable it here. Also, the postmaster will restart by itself on most
# problems anyway, so it is questionable if one wants to enable external
# automatic restarts.
#Restart=on-failure
# (This should make pg_ctlcluster stop work, but doesn't:)
#RestartPreventExitStatus=SIGINT SIGTERM

[Install]
WantedBy=multi-user.target

How to Install PostgreSQL

Alpine Linux

sudo apk add postgresql

Debian

sudo apt update && sudo apt install postgresql

Red Hat Enterprise Linux

sudo yum install postgresql17-server

Ubuntu

sudo apt update && sudo apt install postgresql

Configuration File Location

File Path
/etc/systemd/postgresql@.service
Directory
/etc/systemd/
Significance
System-wide configuration directory
Description
Files in /etc/ contain system-wide configuration settings that affect all users.

Quick Answers

When should I use this postgresql@.service?

Use this file to restore PostgreSQL defaults after misconfiguration, for fresh installations, or as a customization baseline.

How do I restore PostgreSQL defaults?

Download this file, backup your current config, then replace /etc/systemd/postgresql@.service. Restart PostgreSQL service.

Is postgresql@.service safe for production?

Factory default from PostgreSQL on Ubuntu 22.04 LTS (Jammy Jellyfish). Safe baseline, but customize for your requirements.

How does this differ from other OS versions?

This config is from Ubuntu 22.04 LTS (Jammy Jellyfish). Other OS versions may have different defaults. Check compatibility section.

Can I use this for PostgreSQL troubleshooting?

Yes, compare this original config with your current settings to identify problematic modifications.