Skip to main content
Version: next

JATOS on AWS

On this page is additional information in how to install JATOS on a server on AWS. All general installation advice is in JATOS on a server and applies here too. And we recommend to use JATOS together with a reverse proxy. We have instructions for Apache or Nginx. If you are looking for an easier way to install JATOS in the cloud, the tutorial JATOS on DigitalOcean might be what you are looking for.

  1. First you need to register at AWS (they'll want your credit card).
  2. In AWS webpage move to EC2 and launch a new instance with Ubuntu (you can use other Linux too)
  3. During the creation of the new EC2 instance you will be ask whether you want to create a key pair. Do so. Download the file with the key (a *.pem file). Store it in a safe place - with this key you will access your server.
  4. Login via SSH: ssh -i /path/to/your/pem_key_file ubuntu@xx.xx.xx.xx (Use your instance's IP address: In AWS / EC2 / Instances / Description are two IPs 'Private IP' and 'Public IP'. Use the public one.)
  5. Get the latest JATOS: either bundled with Java wget https://github.com/JATOS/JATOS/releases/latest/download/jatos_linux_java.zip or without wget https://github.com/JATOS/JATOS/releases/latest/download/jatos.zip. In the latter case you have to install Java yourself.
  6. unzip jatos_linux_java.zip (You probably have to install 'unzip' first with sudo apt-get install unzip.)
  7. If you do not use a reverse proxy like Nginx or Apache you have to configure IP and port in conf/jatos.conf (or conf/production.conf in version < 3.8.3): Use the 'Private IP' from your instance description (the one that starts with 172.x.x.x) and port 80
  8. Allow inbound HTTP/HTTPS traffic: This is done in AWS GUI.
  9. (Optional) auto-start JATOS
  10. Change JATOS' admin password