Using MongoDB on PythonAnywhere

Getting a MongoDB server

We don't provide Mongo servers ourselves, so you'll need to get one from an external provider (many of our customers are using MongoDB Atlas). For best performance, you should provision your server in the AWS us-east-1 datacenter if you're using our US-based site at, or the eu-central-1 datacenter if you're using our EU site at

Because this will require non-HTTP external Internet access, you'll need a paid account.

Connecting to it.

If you're connecting from a console or a scheduled task, just use the regular PyMongo, creating a MongoClient object with the normal parameters to specify the server, the username and the password..

If you're connecting from a web app, and you're using Flask, we recommend that you use the Flask-PyMongo extension, which works well in a multiprocessing environment like websites on our system.

If you're not using Flask, or are just using the "raw" PyMongo API in Flask, there are a few extra parameters you need to to add to your call to pymongo.MongoClient:

connectTimeoutMS=30000, socketTimeoutMS=None, socketKeepAlive=True, connect=False, maxPoolsize=1

This handles the bulk of the stuff that would otherwise be handled by Flask-PyMongo if you were using it.

Whitelisting your IP address for MongoDB Atlas

MongoDB Atlas requires you to provide the IP address of any code that is trying to connect to your Mongo instance; this can be a bit tricky on PythonAnywhere, because the precise IP address will depend on the time your code runs, and whether it's running in a website's code, or in a task, or in a console.

The easiest, solution, though certainly not the most secure, is to whitelist the CIDR, which is a "whitelist" containing every IP address on the Internet.

A more secure solution is to use the MongoDB Atlas API to them about new IP addresses that they should allow to connect. You can combine that with the ipify service, which tells you what IP address your code is using right now, to make your code automatically whitelist the IP it's running on when it starts up. The following code (based on code provided by Nicolas Oteiza) will do that. You just need to install the ipify module and then use this, replacing the bits inside the <>s:

import requests
from requests.auth import HTTPDigestAuth
from ipify import get_ip

atlas_group_id = "<your group ID aka project ID -- check the Project / Settings section inside Atlas>"
atlas_username = "<your atlas username/email, eg.>"
atlas_api_key = "<your atlas API key>"
ip = get_ip()

resp =
    auth=HTTPDigestAuth(atlas_username, atlas_api_key),
    json=[{'ipAddress': ip, 'comment': 'From PythonAnywhere'}]  # the comment is optional
if resp.status_code in (200, 201):
    print("MongoDB Atlas whitelist request successful", flush=True)
        "MongoDB Atlas whitelist request problem: status code was {status_code}, content was {content}".format(
            status_code=resp.status_code, content=resp.content

If there are any problems whitelisting your IP address (for example, if the API key is wrong) then you will find the error messages in the program's output; for websites, it will be in the server log file (linked from the "Web" page).