How do I add basic authentication to my web site?

My web site is hosted with the Aerobatic add-on for Bitbucket, and now I'd like to limit access to users with a username and password.

Step-by-step guide

  1. Navigate to your web site's repository
  2. Either create a package.json file or, in your existing package.json, add the code block below (the /protected path is optional). Make sure your package.json is in the root level of your repository.
  3. Git push your code to Bitbucket
  4. In Bitbucket, navigate to the Aerobatic Hosting link in your repository
  5. Click environment variables and add an environment variable for the username and another for the password

  "_virtualApp": {
    "router": [
        "module": "basic-auth",
        "path": "/protected",
        "options": {
          "username": "env:BASIC_AUTH_USERNAME",
          "password": "env:BASIC_AUTH_PASSWORD"
        "module": "webpage"

Auth Environment Variables

Sample App

Further Documentation

Full documentation on basic authentication can be found on which is the open-source project that Aerobatic is built on.