Swiftpack.co - Package - PostgresApp/PostgresApp

Postgres.app Version 2

This is a complete rewrite of Postgres.app

  • Modern User Interface
  • Improved Error Messages & Status Reporting
  • Run Multiple Versions of PostgreSQL simultaneously
  • Written in Swift!

If you are looking for the current/old version of Postgres.app, please switch to the pg9X branches!

Most of this README is outdated and needs to be updated for the new version.

Download

You can download Postgres.app from the Postgres.app website.

Older versions and pre-releases are available in the releases section on GitHub.

Documentation

Documentation is available at http://postgresapp.com/documentation, as well as from the "Open Documentation" menu item in Postgres.app.

What's Included?

How To Build

Note: This section is outdated

If you want to tweak the GUI only, just make sure you have a compiled copy of Postgres.app in your applications folder. Open the XCode file and start hacking!

If you want to build your own versions of all the PostgreSQL binaries, you have a bit more work.

Make sure you have autoconf, automake installed. The quickest way to install them is using MacPorts:

sudo port install autoconf automake

For building PostgreSQL with docs, you also need a bunch of other tools:

sudo port install docbook-dsssl docbook-sgml-4.2 docbook-xml-4.2 docbook-xsl libxslt openjade opensp

Then make sure you remove other versions of Postgres.app from your Applications folder.

Open the src directory and type make. This will download and build PostgreSQL, PostGIS, and PLV8. Several hundred megabytes of sources will be downloaded and built. This can take an hour or longer, depending on your Internet connection and processor speed. All the products will be installed in /Applications/Postgres.app/Contents/MacOS/.

Once this is done, you can just open Postgres.xcodeproj in Xcode, select the "Postgres" scheme, and click "Build".

To share your build, use the "Archive" command and then use the "Distribute" command in Organizer.

Under the Hood

Postgres.app bundles the PostgreSQL binaries inside the application package. When you first start Postgres.app, here's what it does:

  • Initialise a database cluster: initdb -D DATA_DIRECTORY -EUTF-8 --locale=XX_XX.UTF-8
  • Start the server: pg_ctl start -D DATA_DIRECTORY -w -l DATA_DIRECTORY/postgres-server.log
  • Create a user database: createdb USERNAME

On subsequent app launches, Postgres.app only starts the server.

The default DATA_DIRECTORY is /Users/USERNAME/Library/Application Support/Postgres/var-9.X

Note that Postgres.app runs the server as your user, unlike other installations which might create a separate user named postgres.

When you quit Postgres.app, it stops the server using the following command:

  • pg_ctl stop -w -D DATA_DIRECTORY

Command Line Utilities

Postgres.app also includes useful command line utilities:

  • PostgreSQL: clusterdb createdb createlang createuser dropdb droplang dropuser ecpg initdb oid2name pg_archivecleanup pg_basebackup pg_config pg_controldata pg_ctl pg_dump pg_dumpall pg_receivexlog pg_resetxlog pg_restore pg_standby pg_test_fsync pg_test_timing pg_upgrade pgbench postgres postmaster psql reindexdb vacuumdb vacuumlo
  • PROJ.4: cs2cs geod invgeod invproj nad2bin proj
  • GDAL: gdal_contour gdal_grid gdal_rasterize gdal_translate gdaladdo gdalbuildvrt gdaldem gdalenhance gdalinfo gdallocationinfo gdalmanage gdalserver gdalsrsinfo gdaltindex gdaltransform gdalwarp nearblack ogr2ogr ogrinfo ogrtindex testepsg
  • PostGIS: pgsql2shp raster2pgsql shp2pgsql

See the documentation for more info.

Contact

If you find a bug, please open an issue.

Postgres.app is maintained by Jakob Egger and Chris Pastl.

License

Postgres.app is released under the PostgreSQL License. See LICENSE for additional information.

Github

link
Stars: 4891
Help us keep the lights on

Dependencies

Used By

Total: 0

Releases

v2.2.4 - Jun 20, 2019

This release fixes a security issue in PostgreSQL 10 and later. We recommend to update as soon as possible. For more details, see the PostgreSQL change log.

Also included in this release is the second beta version of PostgreSQL 12, and bugfixes for 9.x versions.

Here are all the downloads that are included in this release:

The Beta bundle

Postgres-2.3beta2.dmg comes with 3 versions of PostgreSQL:

  • PostgreSQL 12beta2, PostGIS 3.0.0alpha2
  • PostgreSQL 11.4, PostGIS 2.5.2 and PL/v8 2.3.11
  • PostgreSQL 10.9, PostGIS 2.4.7 and PL/v8 1.4.8

For Macs running macOS 10.12 or later

The newest version is Postgres.app 2.2.4.

We offer two downloads:

  • Postgres-2.2.4-11.dmg comes with the latest version of PostgreSQL:
    • PostgreSQL 11.4, PostGIS 2.5.2 and PL/v8 2.3.11
  • Postgres-2.2.4-9.5-9.6-10-11.dmg comes with the 4 most recent versions of PostgreSQL:
    • PostgreSQL 11.4, PostGIS 2.5.2 and PL/v8 2.3.11
    • PostgreSQL 10.9, PostGIS 2.4.7 and PL/v8 1.4.8
    • PostgreSQL 9.6.14, PostGIS 2.3.9 and PL/v8 1.4.8
    • PostgreSQL 9.5.18, PostGIS 2.2.8 and PL/v8 1.4.8

For Macs running macOS 10.10 or later

Postgres-2.1.8.dmg comes with the following versions of PostgreSQL:

  • PostgreSQL 10.9, PostGIS 2.4.7 and PL/v8 1.4.8
  • PostgreSQL 9.6.14, PostGIS 2.3.9 and PL/v8 1.4.8
  • PostgreSQL 9.5.18, PostGIS 2.2.8 and PL/v8 1.4.8

For Macs running macOS 10.7 or later

For even older Macs, we offer the legacy version of Postgres.app with the old UI.

You can choose between these legacy versions:

  • PostgreSQL 10.9, PostGIS 2.4.7 and PL/v8 1.4.8
  • PostgreSQL 9.6.14, PostGIS 2.3.9 and PL/v8 1.4.8
  • PostgreSQL 9.5.18, PostGIS 2.2.8 and PL/v8 1.4.8
  • PostgreSQL 9.4.23, PostGIS 2.1.9 and PL/v8 1.4.8

v2.3beta1 - May 23, 2019

This version of Postgres.app includes the first beta of PostgreSQL 12!

Postgres-2.3beta1.dmg comes with 3 versions of PostgreSQL:

  • PostgreSQL 12beta1, PostGIS 2.5.2
  • PostgreSQL 11.3, PostGIS 2.5.2 and PL/v8 2.3.11
  • PostgreSQL 10.8, PostGIS 2.4.7 and PL/v8 1.4.8

Unfortunately PL/v8 is not yet available for PostgreSQL 12beta1, because a few APIs for extensions seem to have changed.

v2.2.3 - May 9, 2019

For Macs running macOS 10.12 or later

The newest version is Postgres.app 2.2.3.

We offer two downloads:

  • Postgres-2.2.3-11.dmg comes with the latest version of PostgreSQL:
    • PostgreSQL 11.3, PostGIS 2.5.2 and PL/v8 2.3.11
  • Postgres-2.2.3-9.5-9.6-10-11.dmg comes with the 4 most recent versions of PostgreSQL:
    • PostgreSQL 11.3, PostGIS 2.5.2 and PL/v8 2.3.11
    • PostgreSQL 10.8, PostGIS 2.4.7 and PL/v8 1.4.8
    • PostgreSQL 9.6.13, PostGIS 2.3.9 and PL/v8 1.4.8
    • PostgreSQL 9.5.17, PostGIS 2.2.8 and PL/v8 1.4.8

For Macs running macOS 10.10 or later

Postgres.app 2.1.7 comes with the following versions of PostgreSQL:

  • PostgreSQL 10.8, PostGIS 2.4.7 and PL/v8 1.4.8
  • PostgreSQL 9.6.13, PostGIS 2.3.9 and PL/v8 1.4.8
  • PostgreSQL 9.5.17, PostGIS 2.2.8 and PL/v8 1.4.8

For Macs running macOS 10.7 or later

For even older Macs, we offer the legacy version of Postgres.app with the old UI.

You can choose between these legacy versions:

  • PostgreSQL 10.8, PostGIS 2.4.7 and PL/v8 1.4.8
  • PostgreSQL 9.6.13, PostGIS 2.3.9 and PL/v8 1.4.8
  • PostgreSQL 9.5.17, PostGIS 2.2.8 and PL/v8 1.4.8
  • PostgreSQL 9.4.22, PostGIS 2.1.9 and PL/v8 1.4.8

v2.2.2 - Feb 14, 2019

Welcome to the 2019 Valentine's Day PostgreSQL update!

For Macs running macOS 10.12 or later

The newest version is Postgres.app 2.2.2.

We offer two downloads:

  • Postgres-2.2.2-11.dmg comes with the latest version of PostgreSQL:
    • PostgreSQL 11.2, PostGIS 2.5.1 and PL/v8 2.3.9
  • Postgres-2.2.2-9.5-9.6-10-11.dmg comes with the 4 most recent versions of PostgreSQL:
    • PostgreSQL 11.2, PostGIS 2.5.1 and PL/v8 2.3.9
    • PostgreSQL 10.7, PostGIS 2.4.6 and PL/v8 1.4.8
    • PostgreSQL 9.6.12, PostGIS 2.3.8 and PL/v8 1.4.8
    • PostgreSQL 9.5.16, PostGIS 2.2.8 and PL/v8 1.4.8

For Macs running macOS 10.10 or later

Postgres.app 2.1.6 comes with the following versions of PostgreSQL:

  • PostgreSQL 10.7, PostGIS 2.4.6 and PL/v8 1.4.8
  • PostgreSQL 9.6.12, PostGIS 2.3.8 and PL/v8 1.4.8
  • PostgreSQL 9.5.16, PostGIS 2.2.8 and PL/v8 1.4.8

For Macs running macOS 10.7 or later

For even older Macs, we offer the legacy version of Postgres.app with the old UI.

You can choose between these legacy versions:

  • PostgreSQL 10.7, PostGIS 2.4.6 and PL/v8 1.4.8
  • PostgreSQL 9.6.12, PostGIS 2.3.8 and PL/v8 1.4.8
  • PostgreSQL 9.5.16, PostGIS 2.2.8 and PL/v8 1.4.8
  • PostgreSQL 9.4.21, PostGIS 2.1.9 and PL/v8 1.4.8

v2.2 - Oct 18, 2018

Hello PostgreSQL 11!

This version of Postgres.app comes with:

  • PostgreSQL 11.0
  • PostGIS 2.5.0
  • plv8 2.3.8

Unfortunately we've had to bump the minimum required macOS version to 10.12. The reason for this is that a lot of things no longer build on earlier versions.

Starting with this version, we'll offer two separate DMGs:

  • Postgres-2.2-11.dmg contains only the latest version of PostgreSQL
  • Postgres-2.2-9.5-9.6-10-11.dmg contains four versions for maximum compatibility

If you just want PostgreSQL, get the smaller DMG. It includes everything you need to get started. If you need multiple versions of PostgreSQL for testing, get the big DMG.