Skip to content

Setting Up Nessie

As part of each release, Nessie is made available as a fast-start docker image. This is the easiest and fastest way to try out nessie locally and test all its capabilities. The image is relatively small and builds on top of standard base images. To get started:

$ docker pull ghcr.io/projectnessie/nessie

Pulling from ghcr.io/projectnessie/nessie
0fd3b5213a9b: Already exists
aebb8c556853: Already exists
a50558612231: Pull complete
Digest: sha256:bda3dead4eb51a4c0ff87c7ce5a81ad49a37dd17d785f2549f4559f06cbf24d6
Status: Downloaded newer image for ghcr.io/projectnessie/nessie

$ docker run -p 19120:19120 ghcr.io/projectnessie/nessie

__  ____  __  _____   ___  __ ____  ______
 --/ __ \/ / / / _ | / _ \/ //_/ / / / __/
 -/ /_/ / /_/ / __ |/ , _/ ,< / /_/ /\ \
--\___\_\____/_/ |_/_/|_/_/|_|\____/___/
2020-10-01 21:50:27,166 INFO  [io.quarkus] (main) nessie-quarkus 0.1-SNAPSHOT native (powered by Quarkus 1.8.1.Final) started in 0.025s. Listening on: http://0.0.0.0:19120
2020-10-01 21:50:27,166 INFO  [io.quarkus] (main) Profile prod activated.
2020-10-01 21:50:27,166 INFO  [io.quarkus] (main) Installed features: [amazon-dynamodb, cdi, hibernate-validator, jaeger, resteasy, resteasy-jackson, security, security-properties-file, sentry, smallrye-health, smallrye-metrics, smallrye-openapi, smallrye-opentracing]

Once the docker image is up and running, you can install the Nessie cli.

$ pip install pynessie

You’re now ready to start using Nessie. To create a new branch, you can do the following:

# create a branch pointing to the same hash as
# the current default branch (typically the main branch)
$ nessie branch my_branch

From there, you can use one of the three main Nessie integrations of: