Instructions for the SCION Android App

Prerequisites

• Android device with at least Android 7.0
• SCION app, available on the Play Store (source code available on GitHub)

Instructions

To connect to the SCIONLab network with your Android phone, perform the following steps:

1. Register for a free user account on scionlab.org.

2. In “My ASes”, create a new SCIONLab AS with the following settings:

   • Label: any value (is ignored by the app)
   • Installation type: Choose SCION installation from packages
   • Attachment point: Choose any attachment point you like, preferably the nearest to your location
   • Use VPN: You must check this box
   • Public Port: You must not change this from its default value 50000

   Alternatively, you can also use an existing SCIONLab AS if you adjust its settings as described above. In that case, also make sure that the Active box is checked.

3. Once you have created the AS, you can download its configuration from “My ASes” as a .tar.gz archive. Store this archive somewhere on your smartphone (e.g., on the SD card).
4. In the app, press the blue SCION button. The app will ask you to install OpenVPN for Android, which is required to connect to SCIONLab. You do not need to start OpenVPN for Android manually, everything is set up by the SCION app.
5. Once OpenVPN for Android is installed, press the SCION button again. You may have to grant permissions regarding VPN and media storage. Then choose the .tar.gz SCIONLab configuration you have downloaded previously.
6. The app will now connect to SCIONLab and ping the given SCION address. To disconnect, press the SCION button again.

Demo Video

There is a demo video of the app and its configuration.

Troubleshooting

In the app, you can view all log data from SCION. For more detailed information, have a look at the /Android/data/org.scionlab.scion/files/ directory in the internal (or, on some devices, external) storage of your phone.

---