/vagrant-postgis

Vagrant configuration of Linux VM for hassle-free fun with PostGIS

Primary LanguageShell

Vagrant PostGIS

Vagrant configuration to provide users with virtual environment for hassle-free fun with PostGIS.

Looking for PostGIS on Windows VM? Check https://github.com/mloskot/vagrant-postgis-windows

Looking for PostGIS development environment? Check Paul Ramsey's Vagrant setup at https://github.com/pramsey/postgis-vagrant

Features

  • Ubuntu 17.04
  • PostgreSQL 9.6 (official packages)
  • PostgGIS 2.3 (official packages)
  • Pre-configured with
    • Vagrant default user: vagrant with password vagrant
    • Port forwarding from host 6543 to guest 5432.
    • PostgreSQL server with admin and non-admin user.
    • Sample PostgreSQL user pggis (password: pggis) created.
    • Sample PostgreSQL database pggis created, with PostGIS enabled.

Requirements

Installation

  • git clone this repository or download ZIP.
  • cd vagrant-postgis
  • Follow the Usage section.

Usage

  • vagrant up to create and boot the guest virtual machine. First time run, this may take quite a while as the base box image is downloaded and provisioned, packages installed.

  • vagrant ssh to get direct access to the guest shell via SSH. You'll be connected as the vagrant user. You can get root access with sudo command.

  • vagrant halt to shutdown the guest machine.

  • vagrant destroy to wipe out the guest machine completely. You can re-create it and start over with vagrant up.

  • psql -h localhost -p 6543 -d pggis -U pggis to connect to database from host. Similarly, you can connect using pgAdmin3.