Installation - macOS

Installation on macOS

Option 1: Using Homebrew (Recommended)

1. Install Homebrew (if not already installed):

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Install PostgreSQL:

   brew install postgresql@17

3. Start PostgreSQL service:

   brew services start postgresql@17

4. Install pgvector extension:

   brew install pgvector

5. Verify installation:

   psql --version

Option 2: Using Postgres.app

1. Download Postgres.app from https://postgresapp.com/
2. Install by dragging Postgres.app to your Applications folder
3. Launch Postgres.app from Applications
4. Click "Initialize" to create a new server
5. Add PostgreSQL to your PATH (optional, for command line access):

   sudo mkdir -p /etc/paths.d &&
   echo /Applications/Postgres.app/Contents/Versions/latest/bin | sudo tee /etc/paths.d/postgresapp

   Then restart your terminal.

Option 3: Using Docker

Docker provides an easy way to run PostgreSQL with pgvector pre-installed. See the Docker Installation Guide for detailed instructions.

Next Steps

After installation, proceed to:

• Configuration - Configure and manage PostgreSQL service
• Setup - Create database and enable extensions