LibreChat/docs/features/manage_your_database.md

title	weight
🍃 Manage Your Database	-6

Manage Your MongoDB Database with Mongo Express

To enhance the security of your data, external ports for MongoDB are not exposed outside of the docker environment. However, you can safely access and manage your MongoDB database using Mongo Express, a convenient web-based administrative interface. Follow this guide to set up Mongo Express in your Docker environment.

Mongo-Express Setup

Mongo Express allows you to interact with your MongoDB database through your browser. To set it up, perform the following steps:

1. Create a new file named docker-compose.override.yml in the same directory as your main docker-compose.yml file for LibreChat.

2. Copy the following contents into the docker-compose.override.yml file:

version: '3.4'

services:
  mongo-express:
    image: mongo-express
    container_name: mongo-express
    environment:
      ME_CONFIG_MONGODB_SERVER: mongodb
      ME_CONFIG_BASICAUTH_USERNAME: admin
      ME_CONFIG_BASICAUTH_PASSWORD: password
    ports:
      - '8081:8081'
    depends_on:
      - mongodb
    restart: always

3. Security Notice: Before using this configuration, replace admin and password with a unique username and password for accessing Mongo Express. These credentials should be strong and not easily guessable to prevent unauthorized access.

4. Save the docker-compose.override.yml file and run the following command from the directory where your docker-compose.yml file is located to start Mongo-Express along with your other Docker services:

docker-compose up -d

This command will merge the docker-compose.override.yml with your docker-compose.yml and apply the configuration.

5. Once Mongo-Express is up and running, access it by navigating to http://localhost:8081 in your web browser. You'll need to enter the username and password you specified for ME_CONFIG_BASICAUTH_USERNAME and ME_CONFIG_BASICAUTH_PASSWORD.

---

Removing Mongo Express

If you wish to remove Mongo-Express from your Docker environment, follow these straightforward steps:

1. Navigate to the directory containing your docker-compose.yml and docker-compose.override.yml files.

2. Bring down the current Docker environment, which will stop and remove all running containers defined in the docker-compose.yml and docker-compose.override.yml files. Use the following command:

docker-compose down

3. Now you can either rename or delete the docker-compose.override.yml file, which contains the Mongo Express configuration.

4. Finally, bring your Docker environment back up, which will now exclude Mongo Express:

docker-compose up -d

By following these steps, you will have successfully removed Mongo Express from your Docker environment. If you want to reinstate Mongo Express at a later time, you can either rename the backup file back to docker-compose.override.yml or recreate the original docker-compose.override.yml file with the Mongo Express configuration.