Open edX: Deployment Checklist
25 Sep 2014

This page is extremely rough. It’s just my notes with very little editing or checking. Be warned!

Deploying a production service

You probably want to use the release branch of edx-platform. This is slightly more stable that the main branch; apparently it is what runs on

Before updating your production server, it’s probably a good idea to run any updates against a staging server just to make sure things are sane. (A batch of unit testing wouldn’t hurt, either.)

Initial user and security setup

If you’re using a machine that is directly exposed to the Internet, the first thing to do is get basic account and network security in place. You can skip this if you’re in an LXC container on an isolated network.

  1. Create a new user account, if the default install has you log in as root.
  2. Fix /etc/sudoers so that the new account can sudo.
  3. Copy your SSH public key to the new account’s ~/.ssh/authorized_keys.
  4. Configure SSH: change the default port (Port <new port number>), only allow the new user account (AllowUser <username>) and disable password login (PasswordAuthentication no).
  5. For some reason, service ssh restart or service ssh reload don’t actually do anything, so inside a tmux session I do /etc/init.d/ssh stop ; killall sshd ; /etc/init.d/ssh start. Obviously, this will kick you out of the SSH session, which is why we do it inside tmux. If you mistype this or have done something wrong in the config, you will be locked out. Be warned. (This is also why we do this config right at the start, so we can nuke from orbit if necessary.)
  6. For paranoia’s sake, I set up the ufw firewall. Yes, it’s fiddly and annoying. But remember, this is a public-facing web service. Randoms will poke and prod it. You probably want (as root):
ufw allow <ssh port>/tcp  # permit SSH
ufw allow 80/tcp          # permit edX LMS
ufw allow 18010/tcp       # permit edX Studio
ufw default deny          # drop anything else

Again, setting these rules might lock you out of the system. Be careful.

Side note 1: I don’t believe that firewalls actually achieve much in reality, but it’s cheap insurance. Notably, if you forget to make a service internal-only and accidentally bind it to a public IP, the firewall will still protect you.

Side note 2: The edX codebase is huge and undoubtedly contains security problems. The firewall will not protect you against these. You will need to stay up-to-date with security alerts and patch your edX instance regularly.

Set up the host machine

There are a few tweaks that I like to make to all new Ubuntu machines.

Setting up edX

Follow the instructions at []. If you’re in a rush, you can skip to ‘One step installation’, which I find works pretty well.

LXC: apparmor issues

While running, you’ll get an error like:

stderr: apparmor_parser: Unable to replace "/edx/app/edxapp/venvs/edxapp-sandbox/bin/python".  Permission denied; attempted to load a profile while confined?

I spent a while trying to get this to work correctly but was not successful. It’s related to a Python sandbox, used for programming MOOCs (to ensure that students can’t run malicious code on the server). I’m not running a programming MOOC, so I disabled it.

Edit /var/tmp/configuration/playbooks/roles/edxapp/defaults/main.yml. Change:




Re-run the deployment script with

cd /var/tmp/configuration/playbooks && sudo ansible-playbook -c local ./edx_sandbox.yml -i "localhost,"

This is the same as the last line of Ideally, you would check that config change into a local branch of the edX Configuration repository.

The slightly nicer way to do this is to add the EDXAPP_PYTHON_SANDBOX line to your server-vars.yml, as described here.

LXC: rabbitmq issues

TASK: [rabbitmq | remove guest user]
stderr: Error: unable to connect to node rabbit@localhost: nodedown

I didn’t solve this completely, but a functional (if horrible) workaround is to edit /etc/hosts: <hostname> localhost

Installing your theme

Setting up user accounts

Setting configuration variables

In configuration repo, modify /playbooks/roles/edxapp/defaults/main.yml


Tasks to complete before live deployment

comments powered by Disqus