NeuroDesk running on Azure
After creating a free account with Azure, you can set up a Linux Virtual Machine to run an instance of NeuroDesk.
The free tier gives provisions for 750 hours of Azure B1S General Purpose Virtual Machines for Linux, documented at https://azure.microsoft.com/en-in/free/free-account-faq/.
Creating a Virtual Machine in Azure
From the Azure portal landing page, navigate to “Virtual machines”. Once on the “Virtual machines” page, click “Add” in the top left corner, and then click “Create a virtual machine”.
Under Size, be sure to click “See all sizes”.
Select B1s, to ensure you qualify for the free 750 hours, then click “Select” to return to the “Create a virtual machine” page.
It’s best to create an SSH key to access the instance remotely.
The parameters below would suffice, however feel free to change the administrator username or key pair name to what works best.
The remaining settings can be left as is, click “Next : Disks >” down the bottom to proceed to the next stage.
Change OS disk size to 64 GiB as this is eligible for your Free account.
The remaining steps don’t need to be set or changed, click “Create” under the “Review + create” tab.
Accessing the VM
After downloading and installing the certificate, wait for the instance to deploy.
When the resource has deployed, copy the public IP address to configure SSH access.
ssh -i <Path to your private key> -L 5900:127.0.0.1:5900 -L 6080:127.0.0.1:6080 username@yourPublicIP to setup a link from your local machine to the remote instance.
Setup the VM
To setup Docker installation:
sudo apt-get install \
Add Docker’s GPG key:
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
Add the ‘Stable’ Repository:
sudo add-apt-repository \
"deb [arch=amd64] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) \
Install the Docker engine & CLI:
sudo apt-get update
sudo apt-get install screen docker-ce
Check Docker is working:
sudo systemctl enable --now docker
sudo systemctl status docker
Start or reconnect to a screen session:
Create a directory for the persistent data:
Start the NeuroDesk container (this may take a while):
sudo docker run — privileged — name vnm -v ~/vnm:/vnm -v /dev/shm:/dev/shm -e USER=neuro -p 6080:80 vnmd/vnm:20210708
Once the container has started and you see a message similar to
novnc entered RUNNING state, you are ready to go!
Locally, navigate to [http://localhost:6080/] to access the instance via a web browser. Ensure you have configured the port-forwarding correctly.
If you have any additional issues in following this guide, check out the repository for the container on GitHub here: [https://github.com/NeuroDesk/vnm/]
Trying to install
dockerce will fail, the package
docker-ce should be installed instead.
This guide previously used a version of NeuroDesk from 2020, the
docker run command has been updated to use just the latest version of the NeuroDesk image.