Link Search Menu Expand Document

Other Installation Options

Table of Contents

  1. Docker on Windows
  2. On Kubernetes with Helm
  3. Manual Installation

Docker on Windows

To run a local lakeFS instance using Docker Compose:

  1. Ensure you have Docker installed on your computer.

  2. Run the following command in your terminal:

    Invoke-WebRequest https://compose.lakefs.io | Select-Object -ExpandProperty Content | docker-compose -f - up
    
  3. Check your installation by opening http://127.0.0.1:8000/setup in your web browser.

On Kubernetes with Helm

You can install lakeFS on a Kubernetes cluster with the following commands:

# 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

Manual Installation

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. Install and configure PostgreSQL

  3. Create a configuration file:

    ---
    database:
      connection_string: "postgres://localhost:5432/postgres?sslmode=disable"
        
    blockstore: 
      type: "local"
      local:
        path: "~/lakefs_data"
        
    auth:
      encrypt:
        secret_key: "a random string that should be kept secret"
    gateways:
      s3:
        domain_name: s3.local.lakefs.io:8000
    
  4. Create a local directory to store objects:

    mkdir ~/lakefs_data
    
  5. Run the server:

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