---
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' | 'external' — RBAC will remain enabled on GUI if "external". That only works with an external auth service.
    - `login_url` string, required — primary URL to use for login.
    - `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

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

## Changes

- **2024-09-17** `3b10653a8013` — 3 warning, 3 info
  - removed the optional property `login_config/login_url_method` from the response with the `200` status
  - removed the optional property `login_config/password_ui_placeholder` from the response with the `200` status
  - removed the optional property `login_config/username_ui_placeholder` from the response with the `200` status
  - added the non-success response with the status `420`
  - …2 more

[Change history](https://skmtc.dev/treeverse/apis/lakefs-api/changes/setup_lakefs/get.md)

---

[API](https://skmtc.dev/treeverse/apis/lakefs-api.md) · [All operations](https://skmtc.dev/treeverse/apis/lakefs-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/treeverse/lakefs-api/revisions/86ce93ccfb89/schema)