Skip to content

Quickly launch a PostgreSQL database for testing or development purposes.

Notifications You must be signed in to change notification settings

nrjdalal/pglaunch

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

57 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pglaunch is a simple script to launch a PostgreSQL docker container. It can be used to quickly launch a PostgreSQL database for testing or development purposes.

Options are available to keep the container running after the script exits and to specify the name and port of the container.

pglaunch [options]

Options:
  -h, --help           show this help message
  -v, --version        show version number
  -k, --keep           keep postgres container after restart or exit
  -n, --name <name>    name for docker container
                       (default: current directory name)
  -p, --port <port>    port for postgres container
                       (default: 5555)

Star this project on GitHub if you find it useful.

Installation

npx pglaunch

Other package managers are also supported.

Current implemented for bash/zsh shell.

Examples

  1. Launch a PostgreSQL container with the default name and port:
pglaunch

POSTGRES_URL=postgresql://postgres:895UhteoUadR@localhost:5555/postgres

  1. Launch a PostgreSQL container with a custom name and port:
pglaunch -n awesome-project -p 5432 && docker ps --format "table {{.Names}}"

POSTGRES_URL=postgresql://postgres:895UhteoUadR@localhost:5432/postgres

NAMES
awesome-project-y6zT

  1. Launch a PostgreSQL container and keep it running after the script exits:
pglaunch -k

POSTGRES_URL=postgresql://postgres:895UhteoUadR@localhost:5555/postgres

  1. Launch a PostgreSQL container with a custom name and port and keep it running after the script exits:
pglaunch -n awesome-project -p 5432 -k && docker ps --format "table {{.Names}}"

POSTGRES_URL=postgresql://postgres:895UhteoUadR@localhost:5432/postgres

NAMES
awesome-project-y6zT

License

MIT