---
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: "nodejs"
---

# Toggle Databases State Operation  (Enable / Disable)

> Client language: Node.js. Also available for [C#](https://docs.ravendb.net/6.2/client-api/operations/server-wide/toggle-databases-state.md), [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).
>
> 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

> **Note**
>
> &#x20;**Enable database**:
>
> ```javascript
> // Define the toggle state operation
> // specify the database name & pass 'false' to enable
> const enableDatabaseOp = new ToggleDatabasesStateOperation("Northwind", false);
>
> // To enable multiple databases use:
> // const enableDatabaseOp =
> //     new ToggleDatabasesStateOperation(["DB1", "DB2", ...], false);
>
> // Execute the operation by passing it to maintenance.server.send
> const toggleResult = await documentStore.maintenance.server.send(enableDatabaseOp);
> ```

> **Note**
>
> &#x20;**Disable database**:
>
> ```javascript
> // Define the toggle state operation
> // specify the database name(s) & pass 'true' to disable
> const disableDatabaseOp = new ToggleDatabasesStateOperation("Northwind", true);
>
> // To disable multiple databases use:
> // const disableDatabaseOp =
> //     new ToggleDatabasesStateOperation(["DB1", "DB2", ...], true);
>
> // Execute the operation by passing it to maintenance.server.send
> const toggleResult = await documentStore.maintenance.server.send(disableDatabaseOp);
> ```

> **Note**
>
> &#x20;**Syntax**:
>
> ```javascript
> // Available overloads:
> const enableDatabaseOp = new ToggleDatabasesStateOperation(databaseName, disable);
> const enableDatabaseOp = new ToggleDatabasesStateOperation(databaseNames, 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** | `boolean` | `true` - request to disable the database(s)<br />`false`- request to enable the database(s) |
>
> ```javascript
> // Executing the operation returns an object with the following properties:
> {
>   disabled, // Is database disabled
>   name,     // Name of the database
>   success,  // Has request succeeded
>   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.nodejs.md)
- [Database-group](https://docs.ravendb.net/6.2/studio/database/settings/manage-database-group.md)
