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.
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:
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:
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.
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.
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 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:
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.
--target DIR | Where to install. Asked for if not given |
--channel development | Track development builds |
--version 0.9.6a | A specific release |
--from DIR | Artifacts already on disk, from a file echo or copied by hand |
--download-only | Fetch and verify, then stop |
--extract-only DIR | Unpack and stop, to read the docs first |
--create-database | Also create the PostgreSQL role and database |
| Web | 8080 |
| Terminal | 2023 |
| IMAP | 10143 |
| SMTP | 10587 |
| Binkp | 24554 |