Skip to content

Quick Start w/ Docker

We've prebuilt docker images for common operating systems that will allow you to quickly spin up a new PostgreSQL server with PL/Python installed, along with the PostgresML extension. This database is seeded with a few toy datasets so you can experiment with a PostgresML workflow and quickly see results in the dashboard without needing to bring your own data. You can skip to Native Installation if you're ready to start using your own data in a native PostgreSQL installation.

Install Docker for Linux. Some package managers (e.g. Ubuntu/Debian) additionally require the docker-compose package to be installed separately.

Install Docker for Windows. Use the Linux instructions if you're installing in Windows Subsystem for Linux.

  1. Clone the repo:

    $ git clone

  2. Start dockerized services. PostgresML will run on port 5433, just in case you already have Postgres running:

    $ cd postgresml && docker-compose up

  3. Connect to Postgres in the container with PostgresML installed:

    $ psql postgres://postgres@localhost:5433/pgml_development

  4. Validate your installation:

    pgml_development=# SELECT pgml.version();
    (1 row)

Docker Compose will also start the dashboard app running locally http://localhost:8000/