If you would like to expose the Pioreactor UI to view remotely, you can use a service like Ngrok to do so.
This exposes your Pioreactor UI and therefore your Raspberry Pi over the internet. You should have a strong password on your Raspberry Pi leader, and use a strong password for basic-auth (below). We make our best security effort in our products, however we are not responsible for any damages as a result of exposing your Raspberry Pi online.
The following are the steps to take:
- Sign up for Ngrok - the free plan is all we need. Make sure to confirm your account through your email.
- Download the app onto the Raspberry Pi:
wget -O ngrok.tgz https://bin.equinox.io/c/bNyj1mQVY4c/ngrok-v3-stable-linux-arm.tgz
tar zxvf ngrok.tgz
- Make a new folder for the program:
sudo mkdir /opt/ngrok
sudo mv ngrok /opt/ngrok
- Make a config folder:
- Fill in the following:
nano ~/.ngrok/ngrok.yml. We advise changing the basic auth credentials below to something more secure
authtoken: <add your ngrok auth token here, find in nrgok dashboard>
- Run in background:
nohup /opt/ngrok/ngrok start ui ws --config ~/.ngrok/ngrok.yml &
Alternatively, if you wish to set this up as a service that will launch on start up, the following
sudo systemctl enable ngrok
- At dashboard.ngrok.com, you'll see two urls. One of the unique urls should link to your Pioreactor dashboard (when asked for a name and password, use "pioreactor" and "raspberry" respectively).
- The other url is added to your config.ini section
ws_url(under Configuration in the Pioreactor UI), without the
http://infront. For example:
# see docs at https://docs.pioreactor.com/user-guide/remote-access
- Save the configuration by clicking [Save].
- You're all done! You can now access the Pioreactor UI anywhere at
http://some_address.ngrok.io. The username and password are the same you added to your yaml file above.
Custom domain (if using Pro plan)
Set up a domain in the ngrok UI, and follow the steps to add it to you your domain provider. Then in your
hostname fields, example: