All Collections
Self-Hosted Setup
External MongoDB Database
How to shift from Internal Docker database to External MongoDB
How to shift from Internal Docker database to External MongoDB

How to migrate data from Kendis docker internal MongoDB to externally hosted MongoDB

Kendis Team avatar
Written by Kendis Team
Updated over a week ago

This guide explains the steps you need to take to move your data from Kendis's internal docker MongoDB to an externally hosted MongoDB.

Note: Kendis must be running

Connect kendis with new MongoDB installed

  • Go to the System admin area by typing <yourKendisURL>/system
    The default credentials are sysadmin/admin. In case you don't have those default credentials ask them from support@kendis.io

  • Now click on the Database Settings tab on the left navigation

  • Fill up the form with all required details.
    - You must use the Host/URL for MongoDB in this format
    mongodb://<user>:<password>@host/<db>

    e.g., if your host IP is an example 123.122.121.1 then the value would be
    mongodb://<user>:<password>@123.122.121.1/<db>
    In case your MongoDB server has hostname, just replace IP with hostname

  • Once the connection is successful to the MongoDB connection, you can proceed to restore your backup to the externally hosted MongoDB.

How to Restore Data from your backup into MongoDB

  • Get the latest backup file from the host machine where you have Docker running and have mounted the backup volume, the default Kendis backup folder name is "kendis-backup"

  • Use the following command to restore the latest backup
    > mongorestore --drop --gzip --archive=<backup-file-name>.tar.gz

Once the restoration is done, just refresh the browser and you should see the login page. You can log in with your username and password that you have for your current setup, it should work without any issues.

Did this answer your question?