---
title: MongoDB
description: Using MongoDB on your serverlet.
---

MongoDB is a NoSQL document database that stores data in BSON (Binary JSON) format. It's well suited for applications with unstructured or semi-structured data that need a flexible schema and horizontal scalability.

For more details on MongoDB, see the [official documentation](https://www.mongodb.com/docs/).

## First use

By default, MongoDB is disabled on the serverlet. You can enable it from administration, on the serverlet's Software tab (see [Serverlet Control](/docs/serverlet/control/)):

Or via a terminal command:

```
$ app enable mongodb
```

Starting MongoDB:

```
$ app start mongodb
```

## Creating and managing databases

Databases can be created and managed from the UI, or from SSH/CLI using the Futrou DB Manager tool.

### Administration (UI)

You can add a new database with a user account in [Administration](https://old-app.futrou.com), on the serverlet's Databases tab.

### Futrou DB Manager (CLI)

Use the **Futrou DB Manager** tool to manage databases from the terminal:

```
Futrou DB Manager
Usage: db {name} list
Usage: db {name} add {database_name} {password}
Usage: db {name} update {database_name} {new_password}
Usage: db {name} del {database_name}
Supported databases: mariadb, mongodb, postgresql
Example: db mongodb list
```

Commands:

- `db mongodb list` — lists all databases
- `db mongodb add database_name password` — creates a new database with a user and password
- `db mongodb update database_name new_password` — updates the password for a database
- `db mongodb del database_name` — deletes a database

Example:

```
$ db mongodb add moje_db tajne_heslo
```

## Control

Control MongoDB with:

```
$ mongosh
```

## Configuration

All MongoDB configuration is stored in the `/srv/config/mongodb/mongod.conf` file.