This tutorial will show you how to install Blinky-Lite on a Ubuntu Server that is installed on amd64 or x86_64. The server should have at least 2048MB of memory and 20GB of disk space.
Blinky-Lite is composed of a number of Docker containers. We use a web based tool called Portainer to install and orchestrate the containers. From a terminal on your application server, retrieve the Blinky-Lite Portainer installation script
wget https://raw.githubusercontent.com/Blinky-Lite/blinky-compose/main/scripts/installDockerPortainer.sh
Give the script execution privileges
chmod +x installDockerPortainer.sh
Run the script and supply a password for administering the Portainer web app. The password must be at least 12 characters long.
./installDockerPortainer.sh doNotUseThisPassword
The script will take a while to execute and give a message
…Finished installing docker..serving Portainer on port 9000
when complete.
Now open a browser that is on the same network as the Ubuntu server.
Return to your web browser and in the address bar enter the IP address of your Ubuntu server followed by a :9000 to navigate to the Portainer web app.
Fill in the environmental variables into the table as shown.
DOCKER_TAG
- Enter amd64
for now. More choices in the futureBLINKYLITE_PASSWORD
- same password as you used for the portainer appBOX
- name of your blinky-lite box eg. my-blinky-box-01REMOTE_MQTTSERVER
- Enter none
. Since this is an introductory tutorial we will not use an external MQTT broker as a bridgeREMOTE_MQTTUSER
- Enter none
REMOTE_MQTTPASSWORD
- Enter none
HUB
- Enter blinky-hub
EXTRA_HUB_TOPIC1
- Enter none
JWTKEYSECRET
- Used to encrypt communications between the client web apps and the server.MAXDBSIZE
- The maximum size of the database in bytes. 4500000000 is a good size to start.TWOFA
- The two factor authentication flag.At the bottom of the stack configuration web page, press the blue deploy the stack button. It will take some time to deploy the stack because all the necessary docker containers need to be imported. Once the stack has been deployed, you will see blinky-lite show up on the stacks list.
Blinky-Lite will be served on port 80 of the Ubuntu server. Because blinky-lite implements an nginx reverse proxy server, you can also reach the Portainer web application by entering portainer after the server ip address.
You can also edit the blinky-lite database by entering mongo-express after the server ip address. The user name for mongo-express is admin and the password is the same as the blinky-lite password you set when configuring the stack. You should only touch the blinky-lite database.
The blinky-lite database contains a number of mongo-db collections. For example, you can change user credentials and permissions in users collections. You can set the color scheme of all the applications by adjusting the general app document. You can also adjust the look of the initial landing page.