Skip to main content

If you are using our backend SDK that is lesser than the following versions, please visit the older documentation link here.

supertokens-node lesser than v18.0.0
supertokens-python lesser than v0.21.0
supertokens-golang lesser than v0.20.0

MongoDB setup

important

This is needed only if you are running the SuperTokens core yourself.
We support only session management with MongoDB. Login support will be added in the future.

1) Connect SuperTokens to your database 🔌#

With Docker
Without Docker

docker run \
    -p 3567:3567 \
    -e MONGODB_CONNECTION_URI="mongodb://root:[email protected]:27017/dbName" \ 
    -d registry.supertokens.io/supertokens/supertokens-mongodb

# You need to add the following to the config.yaml file.
# The file path can be found by running the "supertokens --help" command

mongodb_connection_uri: "mongodb://root:[email protected]:27017/dbName"

2) Test the connection 🤞#

To test, start SuperTokens and run the following query in your database

db.key_value.find()

If you see at least one row, it means that the connection has been successfully completed! 🥳🎉

Looking for older versions of the documentation?

1) Connect SuperTokens to your database 🔌
2) Test the connection 🤞