To make it easier for you to get an OppiaMobile server up and running, we have created an Amazon Web Services machine image that you can copy and comes pre-packaged with the latest version of the OppiaMobile Server so will run ‘out of the box’.
Once you have created your account on AWS:
Note
When you search the OppiaMobile server AMI will only appear in the search results if you have selected the ‘EU (Ireland)’ zone
Once your instance is up and running you will be able to assign a static IP, access via your web browser and log into the server using SSH. It is beyond the scope of this guide to give the full information about how to connect and configure your AWS account instances.
When you install and launch your instance it is set up with a default set of usernames/passwords:
Warning
You are very strongly advised to change these passwords as soon as you have set up your instance
All the required files are stored in the /home/oppiamobile directory, which has the following structure:
Please note that on this machine the django-oppia server is installed as a clone from GitHub (rather than using the pip install method described in the standard installation instructions).
The code is based on a ‘point-in-time’ version of the OppiaMobile server code, so once you have set up your instance, you should try to keep it up to date. Fortunately it’s straightforward to update to the latest version:
This will update your server to the latest version of the django-oppia server. If any new updates were made, run the following commands (when the virtualenv is active):
If you have created your own fork of django-oppia (for example to customise the look and feel), then you can point git to the fork of your code by editing the /home/oppiamobile/django-oppia/.git/config file and pulling the code from your fork instead.
The current version of the instance (OppiaMobile Server 0.4.0) is running:
By default your AWS OppiaServer instance is not configured to send email, any emails generated by the system (for example reset password messages) are just saved as plain text files in the /tmp directory.
To enable sending email you will need to: