Skip to content

Conversation

NikolayS
Copy link
Owner

Summary

Adds comprehensive macOS installation instructions for psql and pspg using Homebrew, improving documentation for macOS users.

Changes

macOS installation section

  • Add dedicated subsection for macOS using Homebrew
  • Document libpq installation (client-only, lightweight option)
  • Document full postgresql@18 installation as alternative
  • Include PATH configuration for both Apple Silicon (/opt/homebrew) and Intel Macs (/usr/local)
  • Add pspg installation via Homebrew
  • Include pspg configuration example for ~/.psqlrc

Documentation improvements

  • Organize Requirements section with clear subsections (Ubuntu, macOS, pspg)
  • Add code syntax highlighting to bash blocks
  • Provide verification step (psql --version)

Credits cleanup

  • Remove "from Data Egret (aka PostgreSQL-Consulting)" from credits line

Context

The README only contained Ubuntu/Linux installation instructions. macOS users needed guidance on installing PostgreSQL client tools using Homebrew, which is the standard package manager for macOS.

Key considerations for macOS:

  • libpq is "keg-only" in Homebrew, requiring manual PATH configuration
  • Different paths for Apple Silicon vs Intel Macs
  • pspg is available directly via Homebrew

@NikolayS NikolayS force-pushed the docs/add-macos-install-instructions branch from b3ec97d to d16d5cf Compare September 30, 2025 01:14
- Add dedicated macOS section using Homebrew
- Include both libpq (client-only) and full PostgreSQL installation options
- Document PATH configuration for Apple Silicon and Intel Macs
- Add pspg installation and configuration instructions
- Organize Requirements section with subsections for Ubuntu and macOS
@NikolayS NikolayS force-pushed the docs/add-macos-install-instructions branch from d16d5cf to a0bfbbd Compare September 30, 2025 01:14
@NikolayS NikolayS merged commit ac864a2 into master Sep 30, 2025
6 checks passed
@NikolayS NikolayS deleted the docs/add-macos-install-instructions branch September 30, 2025 03:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant