Connect your Squad server.

One command on the machine that runs it. After that, every match your server finishes becomes a replay anyone can watch here.

Connect a server Read the installer

$ curl -fsSL https://squadreader.com/install.sh | sudo bash -s -- <your token>
==> found a running Squad server (pid 4781)
==> installing into /opt/sqreader
==> downloading sqreader-1.4.9-linux-x86_64
==> verifying checksums
==> checking the binary runs on this box
==> writing systemd units
==> enrolling against https://squadreader.com
==> starting services
==> sqreader is running

Name it, then run it.

Name it

Pick a short name. It becomes your server's address:

squadreader.com/s/your-name

Then run it

As root, on the Linux machine running Squad:

curl -fsSL https://squadreader.com/install.sh | sudo bash -s -- <your token>

Your token appears in this line once you have named your server. Your next finished match shows up on Servers.

A finished match on Narva, replayed on squadreader.com: both teams' players, vehicles and flags on the map, with the ticket timeline below.

Every match, back on the map.

Players, vehicles, flags and every kill, replayed in the browser at up to eight times speed.

The latest 15 replaysfor each server you connect.
All-time statsfor every player who played on it, on Stats.
A page of its ownpublic, or private to you and the people you add.

What it does on your machine.

It only reads.

The agent reads the game's memory and its log. It never writes to the game and never sends it a command.

Only finished matches leave.

The final stats and the replay, once a round is over. Nothing live. Both are sealed end to end, and the key stays on your server.

It looks after itself.

After a Squad update it finds the game's memory again on its own, and it installs its own updates between matches.

What it needs.

Linux, root (or CAP_SYS_PTRACE and CAP_DAC_READ_SEARCH) and a Squad dedicated server on the same machine. Nothing else to install.

Questions.

How do I know it's running?

This should say active (running):

systemctl status sqreader-prod

And this is its log, if something looks wrong:

journalctl -u sqreader-prod -n 50

Installed it before starting Squad? That's fine. It waits, and attaches once the game is up.

I run several Squad servers on one machine.

Name each one above, so each gets its own token. Then run the installer without a token: it lists the Squad servers it finds and prints the exact command for each.

curl -fsSL https://squadreader.com/install.sh -o install.sh && sudo bash install.sh

Each server gets its own service, named after it: sqreader-<name>.

Can it publish matches from before I connected?

Yes, their stats. Run this once:

sudo sqreader stats-backfill --recordings-dir /opt/sqreader/recordings \
  --stats-db /opt/sqreader/stats/player_stats.db --push

How do I stop it, or hide my server?

Stop it any time with sudo systemctl stop sqreader-prod. To hide the server instead, sign in and tick "Keep private" under your server above: only you and the people you add can see its page, matches and replays.