Link Search Menu Expand Document

Create a Repository

A repository contains all of your objects, including the revision history. It can be considered the lakeFS analog of a bucket in an object store. Since it has version control qualities, it is also analogous to a repository in Git.

Create the first user

When you first open the lakeFS UI, you will be asked to create an initial admin user.

  1. In your browser, open the address of your lakeFS server. Depending on how you deployed lakeFS, this can be a custom address pointing at your server (e.g., the address of a load balancer, or something else. You should see the following page, prompting you to set up an admin user.


    Note: If you already have lakeFS credentials, log in and skip to creating the repository.

  2. Follow the steps to create an initial administrator user. Save the credentials you’ve received somewhere safe, you won’t be able to see them again!


  3. Follow the link and go to the login screen.

  4. Use the credentials to login as an administrator.

    Login Screen

Create the repository

  1. Click Create Repository.

    Create Repository

  2. Fill in a repository name.

  3. Set the Storage Namespace to a location in the bucket you’ve configured in a previous step. The storage namespace is a location in the underlying storage where data for this repository will be stored.

  4. Click Create Repository.

Next steps

You just created your first lakeFS repository!