---
title: "Toggle Databases State Operation  (Enable / Disable)"
url: "https://docs.ravendb.net/6.2/client-api/operations/server-wide/toggle-databases-state"
version: "6.2"
language: "csharp"
---

# Toggle Databases State Operation  (Enable / Disable)

> Client language: C#. Also available for [Python](https://docs.ravendb.net/6.2/client-api/operations/server-wide/toggle-databases-state.python.md), [PHP](https://docs.ravendb.net/6.2/client-api/operations/server-wide/toggle-databases-state.php.md), [Node.js](https://docs.ravendb.net/6.2/client-api/operations/server-wide/toggle-databases-state.nodejs.md).
>
> 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**
>
> - Use `ToggleDatabasesStateOperation` to enable/disable a single database or multiple databases.
>
> - The database will be enabled/disabled on all nodes in the [database-group](https://docs.ravendb.net/6.2/studio/database/settings/manage-database-group.md).
>
> - In this page:
>
>   - [Enable/Disable database from the Client API](#enable/disable-database-from-the-client-api)
>     - [Enable database](#enable-database)
>     - [Disable database](#disable-database)
>     - [Syntax](#syntax)
>   - [Disable database via the file system](#disable-database-via-the-file-system)

## Enable/Disable database from the Client API

#### Enable database:

##### Sync

```csharp
// Define the toggle state operation
// specify the database name & pass 'false' to enable
var enableDatabaseOp = new ToggleDatabasesStateOperation("Northwind", disable: false);

// To enable multiple databases use:
// var enableDatabaseOp =
//     new ToggleDatabasesStateOperation(new [] { "DB1", "DB2", ... }, disable: false);

// Execute the operation by passing it to Maintenance.Server.Send
var toggleResult = documentStore.Maintenance.Server.Send(enableDatabaseOp);
```

##### Async

```csharp
// Define the toggle state operation
// specify the database name(s) & pass 'false' to enable
var enableDatabaseOp = new ToggleDatabasesStateOperation(new [] { "Foo", "Bar" }, disable: false);

// Execute the operation by passing it to Maintenance.Server.SendAsync
var toggleResult = await documentStore.Maintenance.Server.SendAsync(enableDatabaseOp);
```

#### Disable database:

##### Sync

```csharp
// Define the toggle state operation
// specify the database name(s) & pass 'true' to disable
var disableDatabaseOp = new ToggleDatabasesStateOperation("Northwind", disable: true);

// To disable multiple databases use:
// var disableDatabaseOp =
//     new ToggleDatabasesStateOperation(new [] { "DB1", "DB2", ... }, disable: true);

// Execute the operation by passing it to Maintenance.Server.Send
var toggleResult = documentStore.Maintenance.Server.Send(disableDatabaseOp);
```

##### Async

```csharp
// Define the toggle state operation
// specify the database name(s) & pass 'true' to disable
var disableDatabaseOp = new ToggleDatabasesStateOperation("Northwind", disable: true);

// Execute the operation by passing it to Maintenance.Server.SendAsync
var toggleResult = await documentStore.Maintenance.Server.SendAsync(disableDatabaseOp);
```

#### Syntax:

```csharp
// Available overloads:
public ToggleDatabasesStateOperation(string databaseName, bool disable)
public ToggleDatabasesStateOperation(string[] databaseNames, bool disable)
```

| Parameter | Type | Description |
| - | - | - |
| **databaseName** | `string` | Name of database for which to toggle state |
| **databaseNames** | `string[]` | List of database names for which to toggle state |
| **disable** | `bool` | `true` - request to disable the database(s)<br />`false`- request to enable the database(s) |

```csharp
// Executing the operation returns the following object:
public class DisableDatabaseToggleResult
{
  public bool Disabled; // Is database disabled
  public string Name;   // Name of the database
  public bool Success;  // Has request succeeded
  public string Reason; // Reason for success or failure
}
```

## Disable database via the file system

It may sometimes be useful to disable a database manually, through the file system.

- To **manually disable** a database:

  - Place a file named `disable.marker` in the [database directory](https://docs.ravendb.net/6.2/server/storage/directory-structure.md).
  - The `disable.marker` file can be empty,  
    and can be created by any available method, e.g. using the File Explorer, a terminal, or code.

- Attempting to use a manually disabled database will generate the following exception:

  Unable to open database: '{DatabaseName}',
  it has been manually disabled via the file: '{disableMarkerPath}'.
  To re-enable, remove the disable.marker and reload the database.

- To **enable** a manually disabled database:

  - First, remove the `disable.marker` file from the database directory.
  - Then, [reload the database](https://docs.ravendb.net/6.2/studio/database/settings/database-settings.md#how-to-reload-the-database).

## See also

- [Database settings operations](https://docs.ravendb.net/6.2/client-api/operations/maintenance/configuration/database-settings-operation.md)
- [Database-group](https://docs.ravendb.net/6.2/studio/database/settings/manage-database-group.md)
