---
title: "check if the lakeFS installation is already set up"
method: GET
path: "/setup_lakefs"
tags: ["internal"]
---

# check if the lakeFS installation is already set up

`GET /setup_lakefs`

## Response `200`

lakeFS setup state

- SetupState
  - `state` 'initialized' | 'not_initialized'
  - `comm_prefs_missing` boolean — true if the comm prefs are missing.
  - `login_config` LoginConfig
    - `RBAC` 'none' | 'simplified' | 'internal' | 'external' — RBAC will remain enabled on GUI if "external". That only works with an external auth service.
    - `username_ui_placeholder` string — Placeholder text to display in the username field of the login form.
    - `password_ui_placeholder` string — Placeholder text to display in the password field of the login form.
    - `login_url` string, required — Primary URL to use for login.
    - `login_url_method` 'none' | 'redirect' | 'select' — Defines login behavior when login_url is set. - none: For OSS users. - redirect: Auto-redirect to login_url. - select: Show a page to choose between logging in via login_url or with lakeFS credentials. Ignored if login_url is not configured.
    - `login_failed_message` string — Message to display to users who fail to login; a full sentence that is rendered in HTML and may contain a link to a secondary login method
    - `fallback_login_url` string — Secondary URL to offer users to use for login.
    - `fallback_login_label` string — Label to place on fallback_login_url.
    - `login_cookie_names` string[], required — Cookie names used to store JWT
    - `logout_url` string, required — URL to use for logging out.

## Other responses

- `429` — too many requests
- `default` — Internal Server Error

---

[API](https://skmtc.net/treeverse/apis/lakefs-api.md) · [All operations](https://skmtc.net/treeverse/apis/lakefs-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/treeverse/lakefs-api/versions/4617f80bee61/schema)