How to remote access the web dashboard

Enable the web dashboard for your setup

Windows
Linux
macOS
Windows

See Dashboard for Windows GUI or Dashboard for docker version

Linux

See Dashboard for docker version

macOS

See Dashboard for docker version

Install a ssh server on your PC with the storagenode

Install a ssh client on your device

Check connection

Here we will use a user as user on the remote ssh server, and server as hostname or IP of the remote ssh server.

Windows
Linux
macOS
Android
iOS
Windows
ssh user@server

Password: user@server:~$

Linux
ssh user@server

Password: user@server:~$

macOS
ssh user@server

Password: user@server:~$

Android

Launch the Termius application

Navigate to the Keychain via hamburger menu

Keychain

Tap on plus sign and select New Identity.

New Identity

Specify a name of the Identity in the field Name, provide a username for your PC with storagenode in the Username filed, specify a password in the Password field, confirm creation with a confirmation \sqrt{} button.

Navigate to the Hosts in the hamburger menu.

Hosts

Create a new host with the plus sign.

New host

Specify alias for the host, i.e. MyHomePC. Provide the local or public hostname or IP address in the Hostname or IP Address field. Tap on Username icon and select the Identity, created earlier. In our example - user. Confirm creation of the host with a confirmation \sqrt{} button.

Tap on your host, the MyHomePC in our example, it should request a confirmation to add the fingerprint of the host to the list of known host on your smartphone.

Confirm the connection with a tap on Connect button, the Terminal to your host should appear.

iOS

We use the same application, so all steps are similar to Android version, please take a look on Android tab.

Port forwarding

Windows
Linux
macOS
Android
iOS
Windows
ssh -L 14002:localhost:14002 user@server
Linux
ssh -L 14002:localhost:14002 user@server
macOS
ssh -L 14002:localhost:14002 user@server
Android

Navigate to the Port forwarding screen in the hamburger menu.

Port forwarding

Tap on plus sign to create a new port forwarding rule.

Tap on Select host and select the host created earlier, in our case MyHomePC.

Select it and fill other parameters for the port forwarding rule:

  • Port forward from with 14002 (dashboard port)

  • Host to with 127.0.0.1

  • Port to with 14002

  • Address with 127.0.0.1

Confirm creation with confirmation \sqrt{} button.

Check that it's working - tap on your port forwarding rule, it should connect immediately.

You should see that connection is established and the button Close is appear.

Now, open a web dashboard in your mobile browser: http://localhost:14002

Congratulation!

iOS

We use the same application, so all steps are similar to Android version, please take a look on Android tab.

Navigate to the http://localhost:14002 in your browser, you should see a web dashboard of your storagenode.

The connection can be established to your ssh server on that stage from the LAN, however, to publish your ssh server to the internet we need to secure it first. We should enable key-only way to login to your server. To be able to do so we need to generate and export your ssh public key to your ssh server before disabling the password login.

Generate ssh keys

Windows
Linux
macOS
Android
iOS
Windows
ssh-keygen
Linux
ssh-keygen
macOS
ssh-keygen
Android

Navigate to the Keychain in the hamburger menu, select created Identity by tap on Identity icon then tap on pencil icon to edit an Identity, tap on Key icon, you will see a screen Select key.

Select key

Select existing key or tap on plus sign, select the option Generate key to generate a new key.

Generate Key

Specify a name for the key in the field Name, provide a passphrase (optional) in the field Passphrase. Tap the confirmation \sqrt{} button.

Select the key to return to the edit of the Identity screen, confirm modification with the confirmation \sqrt{} button.

iOS

We use the same application, so all steps are similar to Android version, please take a look on Android tab.

Export public key from the ssh client to the ssh server

Windows
Linux
macOS
Android
iOS
Windows

If the ssh server is a Windows machine, then you can use this guide: Deploying the public key. Otherwise, use the Powershell:

cat ~/.ssh/id_rsa.pub | ssh user@server "umask 077; test -d .ssh || mkdir .ssh ; cat >> .ssh/authorized_keys"
Linux
ssh-copy-id -i ~/.ssh/id_rsa.pub user@server
macOS
ssh-copy-id -i ~/.ssh/id_rsa.pub user@server
Android

Select Keychain from the hamburger menu

Select the key by tap on key icon, tap on three vertical dots and select Export to host.

Tap on Select host and select the needed host, MyHomePC in our example

Confirm the export to the selected host with a confirmation \sqrt{} button.

iOS

We use the same application, so all steps are similar to Android version, please take a look on Android tab.

Disable the password login on your ssh server with storagenode

We need to specify the PubkeyAuthentication yes and PasswordAuthentication no in the config file for the ssh daemon. So, return back to your server with storagenode.

You can use a ssh terminal to make these modifications, but be careful - if you have not added your key to the .ssh/authorized_keys file on your ssh server on previous steps, you will lose an access via ssh to your server.

Windows
Linux
macOS
Windows

Open the config file %programdata%\ssh\sshd_config with a Notepad++ and set options PubkeyAuthentication yes and PasswordAuthentication no, save changes and restart the sshd service either from the Services applet or from the elevated Powershell:

Restart-Service sshd
Linux

Open the config file /etc/ssh/sshd_config with a text editor, nano for example, set the PubkeyAuthentication yes and PasswordAuthentication no options, save the config file and restart the ssh daemon

sudo service ssh restart
macOS

Edit the configuration file /private/etc/ssh/sshd_config with a plain text editor, for example - with nano, set the PubkeyAuthentication yes and PasswordAuthentication no options, save the config file and restart the ssh daemon

sudo launchctl stop com.openssh.sshd
sudo launchctl start com.openssh.sshd

Now check your connection: try to connect from your ssh client again, it should now use the ssh key for authentication instead of password.

To add more security you can install applications such as fail2ban to your Linux or macOS server.

Now, you can make a port forwarding rule on your router for the 22 TCP port (default ssh port) to your ssh server. For more security we recommend to forward an unusual port to the 22 port of the PC with ssh.