---
title: "Setup Wizard Overview"
description: "Use the RavenDB Setup Wizard for a guided process to configure server networking, licensing, security, and cluster initialization."
url: "https://docs.ravendb.net/7.2/start/installation/setup-wizard/overview"
version: "7.2"
---

# Setup Wizard Overview

> RavenDB publishes an official agent skill for coding assistants at https://docs.ravendb.net/skills/ravendb/SKILL.md (also installable with `npx skills add ravendb/skills`). The skill describes itself as: "Read this before writing any RavenDB query, client call or /databases/ request. Covers server setup, document modelling, the Node.js, .NET and Python clients, RQL, indexes, vector search and AI agents. Code written from recall tends to run and return the wrong rows, because RQL resembles SQL and the clients take field names as plain strings."

> **Note**
>
> - The Setup Wizard offers a fast, guided process to configure and initialize a RavenDB server or cluster,  
>   including network, licensing, and security options.
>
> - If you prefer to configure RavenDB manually, see: [Manual setup](https://docs.ravendb.net/7.2/start/installation/manual.md).
>
> - In this article:
>   - [How to run the Setup Wizard](#how-to-run-the-setup-wizard)
>   - [License agreement (EULA)](#license-agreement-eula)
>   - [Guided setup flow](#guided-setup-flow)
>   - [RavenDB settings files](#ravendb-settings-files)

## How to run the Setup Wizard {#how-to-run-the-setup-wizard}

Download the RavenDB server package from the official [RavenDB downloads page](https://ravendb.net/download).  
Extract the downloaded archive into a permanent folder on each machine that will host a RavenDB server instance.  
Each extracted folder represents a potential cluster node.

Then:

1. Open a command prompt or terminal on the machine where you want to run the Setup Wizard.
2. Navigate to the extracted `Server` folder.
3. Run the appropriate script:

### Windows

```text
.\run.ps1
```

### Linux

```text
./run.sh
```

When started for the first time, the server opens a browser window with the Setup Wizard.  
The first screen prompts you to accept the license agreement (EULA).

## License agreement (EULA) {#license-agreement-eula}

You must review and accept the End-User License Agreement (EULA) to proceed with the installation.

![EULA](https://docs.ravendb.net/assets/images/overview-1-400794bc52db762c1151df741f4195db.png)

## Guided Setup Flow {#guided-setup-flow}

After accepting the EULA, the wizard starts a guided configuration flow.

The next screen is [Choose setup method](https://docs.ravendb.net/7.2/start/installation/setup-wizard/choose-setup-method.md), where you select your setup path:  
set up a new cluster, create a package for external setup, or use an existing setup package.

Each step of the wizard is documented in its own article to help you through specific configuration choices.

## RavenDB settings files {#ravendb-settings-files}

### `settings.default.json`

When you extract the RavenDB server package, the extracted *Server* folder includes a `settings.default.json` file.  
This file contains a minimal configuration that causes RavenDB to start the Setup Wizard on first run.

```javascript
{
    "ServerUrl": "http://127.0.0.1:0",
    "Setup.Mode": "Initial",
    "DataDir": "RavenData"
}
```

- `"ServerUrl": "http://127.0.0.1:0"`  
  The Setup Wizard runs on *localhost* and uses a random available port.

- `"Setup.Mode": "Initial"`  
  The *Initial* value causes RavenDB to start the Setup Wizard instead of running as a regular server.

- `"DataDir": "RavenData"`  
  By default, your RavenDB data (databases, documents, and indexes) is stored in the `RavenData` directory under the extracted `Server` folder.
  You can customize this location later in the wizard flow in the [Additional settings](https://docs.ravendb.net/7.2/start/installation/setup-wizard/additional-settings.md#configure-advanced-options) step.

---

### `settings.json`

During setup, RavenDB creates a `settings.json` file in the same *Server* folder.  
This file contains the configuration you selected during the wizard (including paths, security settings, and other options).

After setup is complete, you can still add additional server configuration keys to this file as needed.  
For more details, see the [settings.json](https://docs.ravendb.net/7.2/server/configuration/configuration-options.md#settingsjson) section
in the [Configuration overview](https://docs.ravendb.net/7.2/server/configuration/configuration-options.md) article.

On subsequent runs, the server reads this `settings.json` file and starts as a regular RavenDB server using that configuration, rather than starting the Setup Wizard again.

---

### `settings.json.bak`

During setup, if a `settings.json` file already exists, its content is first saved to `settings.json.bak` as a backup before being overwritten.

On a fresh install, this backup usually contains the same content as `settings.default.json`, because that template is used to create the initial `settings.json` file.

RavenDB does not read `settings.json.bak` at runtime; it is kept only so you can inspect or manually restore the previous configuration if needed.
