Ubuntu provisioning

To install the signageOS agent, follow the guide below.

Prerequisites (applies for both 20.04 and 22.04)

• Ubuntu 20.04 or 22.04 installed with automatically login option
• Have curl installed on the target machine
  • sudo apt install curl
• Run the command as a system administrator (root or any sudo-er)
• Organization UID under which you would like to provision the device
• Set Screen Blank to Never in Settings > Power > Power Saving Options 

Installation steps for 20.04

Ubuntu supports both - CloudControl and full-featured Core App.

Open a terminal and input the following commands in order:

• wget https://linux-package-repository.signageos.io/ubuntu/provision.sh

• chmod +x provision.sh

• sudo ./provision.sh <Company ID>

  • At this point the script should fail due to absence of appropriate package for node.js
  • In next step we will install node.js on your machine

• curl -s https://deb.nodesource.com/setup_16.x | sudo bash

• sudo apt-get install -y gcc g++ make

• sudo apt-get install -y nodejs

• sudo ./provision.sh <Company ID>

  • At this point signageOS should be installed, a warning will be displayed with a message "signageOS does not support snap version of Chromium" and "Disabling front-display"

• sudo snap remove chromium

• sudo apt remove chromium-browser

• sudo apt autoremove

• execute following:
  

  sudo cat <<EOF | sudo tee /etc/apt/sources.list.d/bionic-updates.list
  # for deb-based chromium. Supported only 'til 2023
  # see also /etc/apt/preferences.d/chromium-deb-bionic-updates
  deb http://archive.ubuntu.com/ubuntu/ bionic-updates universe
  EOF

• followed by:
  

  sudo cat <<EOF | sudo tee /etc/apt/preferences.d/chromium-deb-bionic-updates 
  Package: chromium-browser chromium-browser-l10n chromium-codecs-ffmpeg-extra chromium-codecs-ffmpeg 
  Pin: release a=bionic-updates 
  Pin-Priority: 900 
  EOF

• sudo apt update

• sudo apt install chromium-browser

• in file /etc/signageos/signageos.conf remove line disable_frontend=true

• sudo systemctl restart signageos-server.service

• sudo systemctl start chromium.service

At this point the installation is complete and the device should be displaying a provisioning hash. Provisioning from this point is the same as any other device. If you are not familiar with provisioning devices into your company - please follow this documentation article.

Other versions

If you are using Ubuntu 22.04 follow these steps to get your device provisioned. This guide uses Terminal commands.

Firstly get rid of snap version of chromium in your system

• sudo apt remove chromium-browser

• sudo snap remove chromium

Then install original Ubuntu version of Chromium

• sudo add-apt-repository ppa:savoury1/chromium

• sudo apt update

• sudo apt install chromium-browser

You will also need to install nodeJS, execute these commands:

• sudo apt install curl

• curl -sL https://deb.nodesource.com/setup_16.x -o nodesource_setup.sh

• chmod +x nodesource_setup.sh

• sudo ./nodesource_setup.sh

And lastly if you have followed this guide so far, install signageOS application

• wget https://linux-package-repository.signageos.io/ubuntu/provision.sh

• chmod +x provision.sh

• sudo ./provision.sh <companyID>

If all steps were followed and successful, your device should be provisioned within your Organization in Box.