Link Search Menu Expand Document

Create a Repository

Create the first user

Once you have a running lakeFS instance, we’ll need to set up an initial admin user in order to log in to the UI and make our first steps in lakeFS! In this guide, we’re going to run an initial setup and then create a new repository.

Once we have a repository created, we can start copying and modifying objects, commit and reset changes - and even communicate with this repository from Spark, Presto/Trino or other S3-compatible tools using our S3 Gateway API.

  1. Open http://127.0.0.1:8000/setup in your web browser to set up an initial admin user, used to login and send API requests.

    Setup

  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!

    Setup Done

  3. Follow the link and go to the login screen

    Login Screen

Create the repository

  1. Use the credentials from step #2 to login as an administrator

  2. Click Create Repository

    Create Repository

    A repository is lakeFS’s basic namespace, akin to S3’s Bucket (read more about the data model here). Since we’re using the local block adapter, the value used for Storage Namespace should be a static local://. For a deployment that uses S3 as a block adapter, this would be a bucket name with an optional prefix, e.g. s3://example-bucket/prefix. Notice that lakeFS will only manage the data written under that prefix. All actions on the managed data must go through lakeFS endpoint. Data written directly to the bucket under different paths will be accessible in the same way it was before.

Next steps

You just created your first lakeFS repository! Go to Copy Files for adding data to your new repository.