Install

Up in one command

A Linux box with Node 22, PostgreSQL and Redis. The bootstrap does the rest and tells you what it did.

1. Requirements

Debian or Ubuntu is what it is tested on. Other distributions work with the equivalent packages.

bash
sudo apt install build-essential python3 postgresql redis-server zip unzip gnupg lrzsz
sudo npm install -g pm2

Node 22 or later is required and Node 26 is the tested target. nvm is the recommended way to run it, so the board's Node version stays decoupled from the operating system's:

bash
nvm install 26
nvm alias default 26

DOS doors also need dosemu2, which comes from a PPA, and socat, which gives a DOS door a serial port to talk to the caller on:

bash
sudo add-apt-repository ppa:dosemu2/ppa && sudo apt update
sudo apt install dosemu2 socat

2. Install

Download the bootstrap, verify it, run it. It resolves the newest stable release, verifies that against the signed checksum list before unpacking anything, and hands off to the release's own installer, which asks where to install and for database credentials, writes .env, creates the directory structure, installs dependencies, builds the schema and starts the processes.

bash
curl -fsSLO https://canectic.tranqsoft.com/releases/bootstrap.sh
curl -fsSLO https://canectic.tranqsoft.com/releases/bootstrap.sh.sha256
sha256sum -c bootstrap.sh.sha256 && bash bootstrap.sh --target /opt/canectic --create-database

Drop --create-database if you have already created the PostgreSQL role and database yourself. Register your first account at http://localhost:8080/users/register; the first user becomes the sysop.

3. Check the signature

Releases are signed. Import the key once and every release you ever fetch is signature checked. Compare the fingerprint against this one before you trust it; it is what an installed board pins, and it does not change if the release host moves.

bash
curl -fsSLO https://canectic.tranqsoft.com/releases/canectic-release.asc
gpg --import canectic-release.asc

F3F1 6D36 59AF 25FB F947 4C6D B5D8 AB14 3016 761F

Read the docs first, if you prefer

Unpack the release and stop, so you can read INSTALL.md and run the setup scripts before committing to anything:

bash
bash bootstrap.sh --extract-only ~/canectic
cd ~/canectic
less docs/sysop/INSTALL.md
bash setup/create_pg_db_user.sh
node src/tools/install.js --target /opt/canectic

Updating

From inside the board on /admin/update, which shows what is available, what applying it would do and how many callers it would disconnect. Or from the shell:

bash
node src/tools/update.js --target /opt/canectic          # plan only, writes nothing
pm2 stop all && node src/tools/update.js --target /opt/canectic --handoff
node src/tools/update.js --status --target /opt/canectic

An opt-in daily check raises a notification when a release exists. It never downloads or applies anything by itself. Boards with an FTN link can take releases down the CANECTIC_FILES echo with no outbound HTTP at all.

Bootstrap flags
--target DIRWhere to install. Asked for if not given
--channel developmentTrack development builds
--version 0.9.6aA specific release
--from DIRArtifacts already on disk, from a file echo or copied by hand
--download-onlyFetch and verify, then stop
--extract-only DIRUnpack and stop, to read the docs first
--create-databaseAlso create the PostgreSQL role and database
Default ports
Web8080
Terminal2023
IMAP10143
SMTP10587
Binkp24554