Edit me

Introduction

This page is about how to expose your locally installed JATOS to the Internet. That means using your personal computer as a server. If you want to know a bit more about the background, I recommend reading Tunnelling services for exposing localhost to the web. There are several tunneling services and some of those are free or have at least a free offer. Here we concentrate on Serveo, ngrok, and localhost.run. All three are working fine. Just pick one. If you have Windows and don’t know SSH, ngrok will suit you best since it has an installer.

But first some general advice:

  • This way to bring JATOS online is the easiest to use - but also the least reliable one. Your local computer is prone to accidents (e.g. unplugged power cable, interrupted Internet). If you need a more dependable JATOS look at Bring your JATOS online.
  • You have to leave your computer running you want your participants to access your JATOS with your study. Potentially you can use your computer in the mean time, but be aware that everything might interfere with JATOS, e.g. a crashed OS stops JATOS too. Better let your computer run in peace for the duration of your study.
  • Find more reliable ways to bring your JATOS online

ngrok

  1. Download & setup ngrok: https://ngrok.com/download

  2. I recommend creating an account with ngrok. It’s free and ngrok gives you better connection compared to without.

  3. Start your local JATOS

  4. In your terminal move to the directory where you installed ngrok and start it with:

    ./ngrok http 9000
    

    The output should look similar to this:

    ngrok screenshot

  5. Copy & Paste the URL with https to your browser and check that JATOS is running properly with JATOS’ test page https://my-subdomain.ngrok.io/jatos/test (exchange my-subdomain with the subdomain you got in the last step)

  6. That’s all. Now you can create worker links and send them to your participents. Remember to use JATOS under the ngrog.io address when you create worker links (and not your localhost one).

More information on https://ngrok.com.

localhost.run

  1. Start your local JATOS

  2. Execute in your terminal

    ssh -R 80:localhost:9000 ssh.localhost.run
    

    E.g. the output could look like:

    $ ssh -R 80:localhost:9000 ssh.localhost.run
    Connect to http://kristian-44bs.localhost.run or https://kristian-44bs.localhost.run
    
  3. Copy & Paste the URL with https into your browser and check that JATOS is running properly with JATOS’ test page https://my-subdomain.localhost.run/jatos/test (exchange my-subdomain with the subdomain you got in the last step)

  4. That’s all. Now you can create worker links and send them to your participents. Remember to use JATOS under the localhost.run address when you create worker links (and not your localhost one).

More information on http://localhost.run/.

Serveo

  1. Start your local JATOS

  2. Execute in your terminal

    ssh -R 80:localhost:9000 serveo.net
    

    Serveo gives you an URL that is accessible from everywhere in the Internet.

    The output should look similar to this:

    $ ssh -R 80:localhost:9000 serveo.net
    Forwarding HTTP traffic from https://relego.serveo.net
    Press g to start a GUI session and ctrl-c to quit.
    
  3. Copy & Paste the URL into your browser and check that JATOS is running properly with JATOS’ test page https://my-subdomain.serveo.net/jatos/test (exchange my-subdomain with the subdomain you got in the last step)

  4. That’s all. Now you can create worker links and send them to your participents. Remember to use JATOS under the serveo.net address when you create worker links (and not your localhost one).

More information on https://serveo.net.