Link Search Menu Expand Document

More Quickstart Options

Note: The quickstart section is for learning purposes. The installations below will not persist your data. Instead, it will spin-up a database in a docker container, which will be discarded later.

For a production suitable deployment, learn how to deploy lakeFS on your cloud.

Table of contents

  1. On Kubernetes with Helm
  2. Using the Binary

On Kubernetes with Helm

  1. Install lakeFS on a Kubernetes cluster using Helm: 
    # Add the lakeFS Helm repository
helm repo add lakefs https://charts.lakefs.io
# Deploy lakeFS with helm release "my-lakefs"
helm install my-lakefs lakefs/lakefs

  2. The printed output will help you forward a port to lakeFS, so you can access it from your browser at http://127.0.0.1:8000/setup.

  3. Move on to create your first repository in lakeFS.

Using the Binary

Alternatively, you may opt to run the lakefs binary directly on your computer.

  1. Download the lakeFS binary for your operating system:

    Download lakefs

  2. Create a configuration file:

    ---
database:
  type: local
  local:
    path: "~/lakefs/metadata"
    
blockstore: 
  type: "local"
  local:
    path: "~/lakefs/data"

  3. Create a local directories to store objects and metadata:

    mkdir -p ~/lakefs/data ~/lakefs/metadata

  4. Run the server:

    ./lakefs --config /path/to/config.yaml run

  5. Check your installation by opening http://127.0.0.1:8000/setup in your web browser.

  6. You are now ready to create your first repository in lakeFS.