pglaunch - PostgreSQL Database Launcher

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

2. 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

3. Launch a PostgreSQL container and keep it running after the script exits:

pglaunch -k

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

4. 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