Install Tilecast Edge

A clean install puts Edge on a Linux computer that doesn’t run a Tilecast Player yet. When you finish, the screen shows the Edge setup screen and is ready to pair.

If the computer already runs the stable Linux AppImage Player, migrate it instead. Don’t install Edge over it.

Before you start

Check the requirements. The installer takes over the display from the desktop session.
Get a signed Edge release for the computer’s architecture. Tilecast hasn’t published a signed Edge release yet; the release notes will say which hardware each release supports.
Have root access on the computer.

Install and start Edge

Unpack the release into an empty directory, and verify its signature with OpenSSL and the published Tilecast key as described in the packaging guide.
From the unpacked release directory, install the release:
In the unpacked release directory
```
sudo ./bin/tilecast-edge-migrate install --from .
```
The installer checks the signature and every file again, then installs Edge under /opt/tilecast-edge/. It doesn’t start Edge yet.
Run the clean install:
Terminal window
```
sudo /opt/tilecast-edge/current/bin/tilecast-edge-migrate clean-install
```
Edge runs a self-test of the daemon and the WPE renderer, then starts and shows its setup screen. If Edge can’t settle on the setup screen, the installer turns Edge off again and restores the display session.
Pair the screen from the setup screen, or from the command line. See Pair an Edge screen.

Pair the screen

What the installer sets up

Edge runs as system services under a dedicated tilecast account, not in a desktop session:

tilecast-edge.service runs tilecastd, the Player service. It doesn’t run as root.
tilecast-renderer.service runs the WPE WebKit renderer in a more restricted sandbox. It can’t read the Player’s data directory and gets media only through tilecastd.
tilecast-edge-update.socket starts the update helper only when tilecastd asks it to install an update. While an update is provisional, a guard from the previous release also runs. See Update Tilecast Edge.
A small process in the tilecast account’s session reads the audio devices for the Noise Meter.

Directory/opt/tilecast-edge/
- Directory1.5.0/ An installed release. Releases are never changed after install.
  - …
- current Points to the release that runs.
Directory/etc/tilecast-edge/ Optional local configuration.
- …
Directory/var/lib/tilecast-edge/ Player state, the Player credential, and cached content. Only tilecastd can read it.
- …
Directory/run/tilecast-edge/ Local sockets between the Edge processes.
- …

Don’t copy, share, or delete /var/lib/tilecast-edge/. It holds the screen’s pairing, and deleting it means pairing the screen again.