This section describes how to run the Open edX Developer Stack.
To connect to the Devstack virtual machine, use the SSH command from the devstack directory.
To use Devstack and perform any of the tasks described in this section, you must connect as the user edxapp.
sudo su edxapp
This command loads the edxapp environment from the file
/edx/app/edxapp/edxapp_env. This puts
venv python and
in your search path.
This command also sets the current working directory to the edx-platform
If you are installing Devstack on a Linux or Macintosh computer, in order to
use the preview feature in edX Studio, you must add the following line to the
You can customize the location of the edX source code that gets cloned when you provision Devstack. You may want to do this to have Devstack work with source code that already exists on your computer.
By default, the source code location is the directory in which you run
vagrant up. To change this location, set the
environment variable to set the base directory for the edx-platform and
cs_comments_service source code directories.
When you run the LMS on Devstack, the command updates requirements and
compiles assets, unless you use the
The command uses the file
lms/envs/devstack.py. This file
overrides production settings for the LMS.
To run the LMS on Devstack, follow these steps.
Run the following command.
paver devstack lms
Or, to start the LMS without updating requirements and compiling assets, use
paver devstack lms --fast
The LMS starts.
Open the LMS in your browser at
Vagrant forwards port 8000 to the LMS server running in the virtual machine.
When you run Studio on Devstack, the command updates requirements and compiles
assets, unless you use the
You run Studio on Devstack with the file
cms/envs/devstack.py. This file
overrides production settings for Studio.
To run Studio on Devstack, follow these steps.
Run the following command.
paver devstack studio
Or, to start Studio without updating requirements and compiling assets, use
paver devstack studio --fast
Open Studio in your browser at
Vagrant forwards port 8001 to the Studio server running in the virtual machine.
To view all available commands for Studio, enter the following command.
./manage.py cms -h --settings=devstack
To run discussion forums on Devstack, follow these steps.
Switch to the discussion forum account by entering the following command.
sudo su forum
Update Ruby requirements.
If you get a message for entering a password to install the bundled
RubyGems to the system, you can safely exit by entering
control+c on a
Ctrl+C on Windows. The RubyGems will still be installed
correctly for the forum user.
Start the discussion forums server.
ruby app.rb -p 18080
The discussions forum server starts. You can access the discussion forums API
When you install Devstack, the following accounts are created.
An LMS and Studio user with course creation and editing permissions. This user is a course team member with the Admin role, which gives rights to work with the demonstration course in Studio, the LMS, and Insights.
A student account that you can use to access the LMS for testing verified certificates.
A student account that you can use to access the LMS for testing course auditing.
A student account that you can use to access the LMS for testing honor code certificates.
The password for all of these accounts is