Running a personal instance of the editor on Windows

Installation

1. Install Python 3 from python.org/download.
2. If you already have two versions of Python installed on your PC, the command python might run the wrong version. The easiest way of making sure you use the right one is to create a virtual environment. Here's how to do that: pip3 install virtualenv virtualenv -p python3 numbas_venv numbas_venv\Scripts\activate You'll need to activate the virtual environment each time you want to use it.
3. You can either download static copies of the Numbas software, or get a version-tracked copy which is easier to update through git. If you're using git, you'll need to install Git for Windows first.
4. Either download the Numbas runtime tools from github and extract to a folder called numbas_runtime, or use git to clone the repository: git clone git://github.com/numbas/Numbas.git numbas_runtime
5. Either download the Numbas editor from github and extract to a folder called numbas_editor, or use git to clone the repository: git clone git://github.com/numbas/editor.git numbas_editor
6. Install all the required Python modules: pip3 install -r numbas_editor/requirements.txt pip3 install -r numbas_runtime/requirements.txt
7. You may have some trouble installing Pillow. If so, try installing it using a wheel file:
   • Download Pillow-3.4.2-cp35-cp35m-win32.whl from the Python package index (on 64-bit systems, it's Pillow-3.4.2-cp35-cp35m-win_amd64.whl
   • Run pip3 install Pillow-3.4.2-cp35-cp35m-win32.whl
   • Once Pillow is successfully installed, try again to install the rest of the required modules.

Configuration

• Run python first_setup.py

  This will configure the editor based on your answers to a few questions, and write numbas/settings.py.

  The default answers for most of the questions apply only to Linux systems; make the appropriate changes using the paths described in the earlier steps.

  If you've followed these instructions exactly, use the following values:

  Path of the Numbas compiler

  ../numbas_runtime

  Which database engine are you using?

  sqlite3

  Where are static files stored?

  static/

  Where are uploaded files stored?

  media/

  Where are preview exams stored?

  static/previews/

  Base URL of previews

  /static/previews/

  Python command

  python

  If you make any mistakes, you can run the script again, or edit numbas/settings.py directly.

• Start the server python manage.py runserver
• Open htttp://localhost:8000 in your web browser.

Ongoing maintenance

If you used git to clone the runtime and editor repositories, run the following commands to update your installation: cd numbas_editor git pull origin master python manage.py migrate pip install -r requirements.txt cd ../numbas_runtime git pull origin master pip install -r requirements.txt

The admin site, where you can manually edit entries in the database, is at http://localhost:8000/admin.