Skip to content

Quick Start

A quick start to creating a working database in four steps. This will create the database in development mode and load a small sample database.

The default user login is Admin and the password is gulpereel.

Requirements

1 - Checkout the code and change to that working directory

git clone http://bitbucket.org/mbari/deepsea-ai-backend
cd deepsea-ai-backend

2 - Copy the environment and postgres password file examples

cp config/dev.env.example .env 
cp config/.pgpass.example .pgpass

Modify the POSTGRES_DATA environment variable in .env, e.g.

POSTGRES_DATA=/Users/myusername/pgdata

and make sure the directory exists

mkdir /Users/myusername/pgdata

POSTGRES_DATA must be an absolute path that can be bind mounted into the container. If building on MacOSX, make sure this can be shared in Docker. Check your Docker Preferences->Resources->File Sharing menu.

3 - Build to run as the current user

docker-compose build --no-cache --build-arg GID=`id -g` --build-arg UID=`id -u`

4 - Run

docker-compose up

The database and API shoud be up now and a small sample should now be loaded to experiment with in the GraphQL Playground. The ending should report something similar to:

deepsea-ai-api | added classes for user: Admin userId 1
deepsea-ai-api | Merging tracks
deepsea-ai-api | Done merging tracks for 21d00e55-86e7-4d59-bf42-d57eb0e4b902
deepsea-ai-api | finished added events for user: Admin
deepsea-ai-api | disconnected from prisma
deepsea-ai-api | Done in 3.30s.
deepsea-ai-api | 🚀 Server ready at http://localhost:4000/api

That's it! Now, open the playground http://localhost:4000/api and check-out the example queries and mutations.