1 Quick install
Vivy edited this page 2026-11-17 17:35:03 +00:00

Quick install

You need two things:

  • one server: a Linux computer that is always on (Debian, Ubuntu or Raspberry Pi OS);
  • one device per screen: a Raspberry Pi, a mini PC or an old laptop with Linux, connected to the screen.

One command installs each part. Open a terminal on the computer and paste the command. The first install builds the software, so it takes 10 to 30 minutes, longer on a Raspberry Pi.

1. Install the server

curl -fsSL https://git.grimoirix.org/Grimoirix/grimoire-of-digital-signage/raw/branch/dev/install.sh | sudo bash -s -- server

If the server has no database yet, the script asks if it may install one. Answer yes unless you already have a PostgreSQL database that you want to use.

At the end the script shows the address of the panel, for example:

Management panel: http://signage-server:8000/

Open that address in a web browser and go on with First start.

2. Install a device

On the computer that drives the screen, put the address of your server after --server:

curl -fsSL https://git.grimoirix.org/Grimoirix/grimoire-of-digital-signage/raw/branch/dev/install.sh | sudo bash -s -- client --server http://signage-server:8000

The device starts automatically after a power cut, with nobody at the keyboard. It then appears in the panel as a pending device. Go on with Add a screen to approve it.

Upgrade or remove

Put upgrade or uninstall in front of server or client:

curl -fsSL https://git.grimoirix.org/Grimoirix/grimoire-of-digital-signage/raw/branch/dev/install.sh | sudo bash -s -- upgrade server

An upgrade keeps your settings, your media and your playlists.

More options

Docker, your own database, Kubernetes and the manual steps are in the README. install.sh --help lists every option.