Install the console 1.0

Install the console

Last updated 10 Nov 2026
On this page

Install Signal Console from its release package, create the first account, and serve it over HTTPS.

Requirements

  • Node.js 22.5 or later (the console uses Node's built-in SQLite).

  • A machine the hosts can reach, if they will push to it. The default port is 7446.

Where to get it

Signal Console Community is free on GitHub: Signal-Console-Community. Download the release package from its Releases page, or clone the repository (the repository's README shows the commands). Report bugs and ask for features in its Issues.

Install

  1. Unzip the release

    Unzip signal-console-X.Y.Z.zip into a new folder.

  2. Start it

    Run node launch.js. It starts the console; its data lives in data/ beside it.

  3. Create the first account

    On the first start with no account, the console asks in the same shell for a name (Enter: admin) and a password, typed twice. It creates an admin before it listens.

  4. Open it

    Browse to http://localhost:7446 (or the server's name) and sign in.

PowerShell Start, and manage accounts 
node launch.js
node launch.js users add <name> analyst
node launch.js users list

Roles

Role

Can

admin

Everything, in every case; manage accounts, updates, the audit log.

analyst

Triage, suppression rules, import, remove - in the cases they may open.

viewer

Read every page; change nothing.

Passwords are at least 12 characters. A session ends after 8 hours unused, after 7 days in any case, and whenever the account's password, role or status changes. After 5 failed sign-ins for one account or from one address, sign-in is refused for 15 minutes.

Serve it over HTTPS

Either let the console serve HTTPS itself - set SIGNAL_CONSOLE_TLS_CERT and SIGNAL_CONSOLE_TLS_KEY to the paths of a PEM certificate (with its chain) and key, issued by your organisation's own authority so the hosts trust it - or put a reverse proxy in front of it and set SIGNAL_CONSOLE_SECURE_COOKIE=1.

Settings, HTTPS shows whether the console answers over HTTPS, its certificate's names, issuer, validity and fingerprint, and the steps to turn it on.

Updates

A console installed from a release package updates itself from a signed update file, backing up its data first and rolling back if the new version does not start. Settings, Updates (admins) checks, updates now, turns automatic updates off, or accepts an update uploaded by hand for a console without Internet access.