Connecting to Vagrant DB Locally

The Vagrant VM sets up PostgreSQL such that you can access it from within the VM as well as from outside it for ease of development. When you start Vagrant, it will map the port 5432 inside the VM to the port 16442 outside the VM. You can then connect by specifying localhost for the host and then submitty_${SEMESTER}_${COURSE} (replacing ${SEMESTER} and ${COURSE} with the actual one you want) for the DB to connect to. The user and password are both submitty_dbuser. All tables are then located in the public schema.

We recommend that to connect to the DB that you use one of the following options ranging from simplest to most powerful.

  1. psql (CLI for connecting to PostgreSQL)

  2. pgAdmin (GUI for connecting to PostgreSQL)

  3. navicat (GUI for managing PostgreSQL)

  4. DataGrip (“Database IDE”, can connect to most DB types)

Note: To add the Submitty server to pgAdmin, follow the pgAdmin setup instructions.

Entity-Relation Diagrams

  1. Submitty Database (updated 2019-06-05, see code for most recent): Database Entity Graph

  2. Courses Tables (updated 2019-06-05, see code for most recent): Database Entity Graph

Diagram generated using DataGrip, by connecting to the DB, right-clicking on public schema, Diagrams > Show Visualization…