Local Server

Arrivals Board includes a built-in web server that accepts messages over your local network. Any device or script on the same network can post messages to the board by sending a request. The server also provides a web-based form for quick manual submissions.

Local server web interface

Setup

  1. Open Settings and tap Sources > Local Server.
  2. Toggle Enable on. The server starts immediately.
  3. Note the URL displayed below the toggle (e.g., http://192.168.1.42:8080). This is the address other devices will use to send messages.
  4. An API Key is generated automatically. You will need this key to authenticate requests.
  5. Optionally adjust the Port if the default conflicts with another service.
  1. Open Settings and navigate to Sources > Local Server.
  2. Toggle Enable on. The server starts immediately.
  3. Note the URL displayed on screen.
  4. The API Key is shown on screen. You can also view it by navigating back to this settings page at any time.
  5. Optionally adjust the Port.

Configuration reference

Option Default Description
Enable Off Starts or stops the built-in web server
Port 8080 The port the server listens on (1024--65535)
API Key Auto-generated A secret key required for requests. Tap Regenerate to create a new key and invalidate the old one.

Web interface

When the local server is running, opening the displayed URL in any browser on the same network loads a dark-themed web form where you can compose and send messages manually.

The web form includes the following fields:

Field Description
API Key Pre-filled if you opened the link from Arrivals settings. Otherwise, paste your API key here.
Sender The name displayed in the sender column on the board
Message The message text to display. Supports inline formatting for colored text and SF Symbols.
Avatar An optional image for the sender avatar. Upload a PNG or JPEG (max 1 MB). The image is automatically cropped to a square and scaled to 512×512.
Indicator Color A color picker for the indicator lamp (optional)
Priority Controls when the message is displayed: Queue (wait for turn), Next (jump ahead), or Now (interrupt immediately)

Submit the form and the message appears on the board immediately.

REST API

The local server exposes a REST API for programmatic message posting. This is the same API documented in detail in the Automation > REST API section. Here is a quick example:

curl -X POST http://192.168.1.42:8080/api/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "sender": "Build Server",
    "text": "Deploy completed successfully",
    "indicatorColor": "#00FF00",
    "urgent": false
  }'

For the full API reference --- including request/response formats and error codes --- see Automation > REST API.

Features

Auto-generated API key

When the local server is first enabled, Arrivals generates a random API key. All requests must include this key in the Authorization header. You can regenerate the key at any time from the source settings, which immediately invalidates the previous key.

Configurable port

The default port is 8080, but you can change it to any value between 1024 and 65535. This is useful if another service on your network already uses port 8080.

QR code authentication for Apple TV

The local server also handles QR code sign-in for Apple TV. When you scan a QR code to sign in to a source (such as Mastodon or Threads) on Apple TV, the QR code points to the local server, which completes the sign-in and passes the credentials back to the Apple TV.

Troubleshooting