Status: private test candidate (v1.1.72, November 2026)
A modern multi-node BBS for the classic FidoNet world. Web, telnet, SSH,
rlogin, FTP, and PETSCII (C64/128) front-ends; FidoNet binkp + DOVE-Net
QWK echomail; inter-BBS instant messaging via MSP (RFC 1312); a built-in
collaborative wiki and RSS reader; door-game support including stock
Synchronet .js doors (LORD ships pre-installed and plays out of the box).
All four paths land on the same BBS; pick whichever fits your box.
| Your setup | Use |
|---|---|
Linux, and sudo is fine |
Quick install (Linux) below — the full install.sh wizard |
| Linux, but no root/sudo access | docs/01b-no-root-install.md — everything (web, telnet, SSH) using only your own account |
| Docker (any OS) | Quick install (Docker) below |
| Windows | docs/INSTALL-WINDOWS.md — WSL2 or Docker Desktop, both confirmed working |
You'll want a domain pointed at this box if you want the web admin and
public web pages working with HTTPS — modern browsers refuse plain-HTTP
logins, so the wizard's production mode pulls a Let's Encrypt cert.
Telnet, SSH, rlogin, BinkP, MRC, and MSP work fine without a domain;
pick test mode at the prompt if you're behind NAT or just kicking
the tires (web admin runs on http://localhost:8080).
tar xzf ANetBBS-v1.1.72.tar.gz
cd ANetBBS-v1.1.72
sudo bash install.sh
The wizard asks for BBS name, sysop, ports, services, and SSL/nginx
preferences, then sets up the venv, systemd units, ufw rules, and (if
enabled) a Let's Encrypt cert. A random admin password is generated and
written to data/admin_password.txt — log in to the web admin and
change it on first use.
For details on individual services and post-install configuration see
docs/INSTALL.md.
To upgrade an existing install in place, download the new release tarball
and run update.sh from inside it (backs up .env/database/systemd units
first, then syncs files and restarts services):
tar xzf ANetBBS-v1.1.72.tar.gz
cd ANetBBS-v1.1.72
sudo bash update.sh
install.sh itself also takes a few flags:
sudo bash install.sh --uninstall # Stops/disables services, then (after one
# y/N confirmation) deletes the ENTIRE
# install directory -- including data/ (DB,
# uploads, echomail) -- with no separate
# prompt or backup for that. Back up
# data/ first if you want to keep it.
sudo bash install.sh --defaults # Non-interactive install, all defaults
sudo bash install.sh --force # Re-run install, overwriting an existing
# .env and database (normally preserved)
Prefer containers? Two options — a single-container quick start, or a
proper multi-container docker-compose deployment (recommended for
anything beyond kicking the tires). Pre-built multi-arch images
(amd64 + arm64, works on a Raspberry Pi) are published to GHCR on
every release — no local build needed:
cp .env.docker.example .env # fill in SECRET_KEY, BBS_NAME, etc.
cp docker/compose/mrc-bridge-config.json.example mrc-bridge-config.json
docker compose -f docker/compose/docker-compose.yml up -d
.env already points at ghcr.io/anetonline/anetbbs:latest by
default — pin a specific version instead with ANETBBS_IMAGE_TAG=v1.1.72
(or whatever release you want). Testing a local change instead of a
published image? docker build -f docker/Dockerfile -t anetbbs:local .,
then set ANETBBS_IMAGE=anetbbs / ANETBBS_IMAGE_TAG=local in .env.
New to Docker? docs/22-containers.md has a
full hand-held walkthrough (including the single-container option,
what each command actually does, and troubleshooting).
- Local boards with categories, sticky/lock, threading, quote-reply, search, voting, ANSI banners, last-read tracking, moderators
- FidoNet netmail (binkp) — full kludge support (MSGID, REPLY, INTL, CHRS, FMPT/TOPT, PID, TZUTC), per-user AKAs, drafts, soft-delete
- FidoNet echomail with AreaFix robot (in/out), bad-area sysop review
- Hub mode — act as a BinkP echomail hub for downstream nodes; per-node echo area subscriptions, outbound hold queue, SEEN-BY aware fan-out tosser. Also a QWK hub: HTTP download/upload endpoints, per-node conference subscriptions with high-water mark tracking. Admin → Echomail → Hub.
- ANotherNetwork (Zone 1200) — ANetBBS's own echomail network, seeded on
every fresh install. 26 message areas across 9 categories (General,
Technology, BBS Scene, Retro, Hobby, Trading, Data, SysOp, Test) plus 9
TIC file-echo areas (nodelists, infopacks, BBS software, doors, ebooks,
Linux, retro, ANSI art). Join via BinkP (
1200:1/1) or QWK/FTP (hub ID:ANET). Hub:bbs.a-net.fyi. Apply for a node number. Public nodelist at/admin/echomail/hub/nodelist. - DOVE-Net QWK — fetch + REP packet upload, CONTROL.DAT-driven area auto-create, conf# mapping, manual quick-add for known confs
- Private messages between local users
- Inter-BBS Instant Messaging (MSP / RFC 1312) — TCP/18, with the
Synchronet
sbbsimsg.lstdirectory mirrored daily and a SYSTAT (UDP/11) Active-User responder - CP437 + ANSI rendering in every message body (proper box-draw, 16-color SGR → HTML spans)
- Game Center — 21 built-in browser games (puzzle, action, cards/ casino, strategy, RPG) playable with no telnet client or per-game setup: Hangman, Trivia, Number Guesser, Snake, Tic Tac Toe, Memory Match, Typing Speed Test, Minesweeper, 2048, a text adventure, Klondike Solitaire, Video Poker, Texas Hold'em, Blackjack, Slot Machines, Galaga, Tetris, Breakout, ANetDarkForces (a 10-sector raycaster FPS), an Ebook Reader (Project Gutenberg), and Meadowlark Valley — an original town/farm-builder sim with auto-harvesting farmer NPCs and real-time co-op building. 13 of them (Hangman through Breakout) can be played with no account at all — a per-game admin toggle, off for anything using the wallet economy or a persistent save. See docs/24-game-center.md.
- DOSBox-staging / dosbox-x / vanilla DOSBox auto-detect, TCP nullmodem bridge to the user's PTY
- Mystic Pascal Script (
.mps) and Mystic Python (.mpy) doors - Synchronet
.jsdoors — runs via realjsexecwhen found at$SBBSEXEC/jsexecor/sbbs/exec/jsexec; otherwise falls back to a Node.js + compatibility shim that the alpha 2 work expanded enough to fully run LORD (Legend of the Red Dragon — Synchronet's JS port, pre-installed, no Synchronet required) - Native binary doors with DOOR.SYS / DOOR32.SYS / DORINFO / CHAIN.TXT / SFDOORS.DAT drop files
- rlogin door bridge (
door_rlogin) — connects out to a remote BBS's own door server (Synchronet xtrn, DoorParty, etc.) instead of running a local subprocess. A-Net Online's game server ships pre-installed and active by default, same as LORD. - Web terminal pinned to 80×25 with the full CGA palette so doors draw the same way as on a 1990s VGA terminal — Violet's portrait in LORD looks like Violet's portrait in LORD
- Full collaborative wiki at
/wiki/with markdown bodies,[[Page]]cross-links, per-page revision history, unified-diff compare, revert, full-text search, recent changes, wanted/orphan pages - 52 seeded pages cover connecting, every messaging subsystem, doors (including a LORD recipe + the DosBridge), echomail/BinkP setup, NodeSpy, backup, full architecture, sysop guide, glossary, FAQ
- Anyone can read; logged-in users can edit (configurable minimum post count + account age); admins can lock/delete/rename
- Built-in feed aggregator for BBS-scene news + anything else
- Web at
/rss/(river or per-feed), terminal main-menu R - Background poller on a single shared interval, sanitized HTML via bleach
- Per-user unread state; X-News (
x-bit.org) seeded by default
- Per-area file bases with
users / sysop / noneupload permissions - TIC ingest from FTN peers + outbound TIC hatching to downstream subscribers
- Auto-extract description from
FILE_ID.DIZ,README.md/README.txt,DESCRIPT.IONinside zip / tar.{gz,bz2,xz} / 7z / rar / lha archives - Optional ClamAV virus scan on upload
- Web gallery at
/gallery/— paginated thumbnail grid, full-screen modal viewer, lazy-loaded thumbnails. Browser-native rendering for full image quality (no terminal-art middleman). - Admin at
/admin/galleries/— add / remove / edit collections (label, slug, filesystem path, sort order, active flag) and per-gallery file management with drag-and-drop multi-file upload, individual file delete, pagination. - Storage: galleries are listed in
gallery-config.jsonat the BBS install root (auto-seeded on first run). Files live wherever you point the path; the same path can be served by any other tool too. - Terminal viewer at
$INSTALL_DIR/anet-gallery.sh(default/opt/anetbbs/anet-gallery.sh) — bash script usingchafa(Unicode blocks, works in any terminal) orimg2sixel(sixel-capable terminals like SyncTERM, foot, mlterm). Standalone — not wired into the games menu.
- WebSocket bridge to the global MRC network (mrc.bottomlessabyss.net) — one BBS-level hub connection shared across all users
- Web MRC chat at
/mrc/(browser tab) - Terminal MRC chat for telnet/SSH/rlogin — talks through the same
local bridge so terminal + web users share rooms and a single trust
identity. anetmrc-style stationary status bar at row 1 (room,
topic, mention badge, latency), chat scrolls below it, input line
pinned to the bottom row. Full slash-command roster (
/identify /msg /me /join /list /who /chatters /motd /banners /topic /lastseen /afk /back /status /roomconfig /termsize /trust /broadcast /raw …). Tab-completes usernames seen in chat or via/who. ←/→ arrow keys for outgoing text color, masked password input on bare/identify, @mention highlighting with bell, 140-char outgoing cap with word-boundary auto-split, HH:MM timestamps on every line, ANSI-aware word-wrap with continuation indent
- Web (Flask + SocketIO) on port 5000
- Telnet (port 2233), SSH (2234), rlogin (513) — share the same user database
- FTP (port 21) — serves every active
FileAreaas a top-level directory. Anonymous read access to public areas; authenticated users upload subject to per-areaupload_permission. Optional FTPS via the same Let's Encrypt cert nginx uses. Earns the FTN nodelistIFCflag. - Terminal UX — single-key hotkey menus (no Enter required), screen
cleared between menus, Q logoff confirms Y/N, color rendering across
Boards / Echomail / Bulletins / Who's Online / Sysop Tools / Profile
/ PM compose / Inter-BBS IM compose / inboxes. Paged area picker for
long echomail networks. Notification banner at login (
*** You have new: 3 PMs, 1 InterBBS IM). Synchronet@CODE@and Mystic|XXdisplay codes in welcome / goodbye / menu ANSI screens. - PETSCII (C64/128) — dedicated plain-text rendering path for real
Commodore hardware and PETSCII terminal emulators, two opt-in ports
(40-col / 80-col, off by default). Boards, echomail (network-first
picker), PMs, file browsing + XMODEM download, who's-online, profile,
Number Guessing, and sysop-buildable custom menus at
/admin/petscii-menus/. See docs/25-petscii.md. - Live "X just logged in/out" presence alerts — classic multi-node BBS behavior: every other currently-online user sees it in real time, wherever they are (a menu, a board, chat) — terminal and web alike, regardless of which side someone connects from.
- Watch It Live (
/watch, off by default) — a public, no-login page showing real-time who's-online activity, styled as a retro terminal display, meant to be shared or embedded off-site. See docs/29-watch-live.md. - Postcards (
/postcards) — any logged-in user composes retro CP437 art with the same grid editor as the admin ANSI Editor, then gets a public share link and a downloadable PNG for sharing off platform. See docs/30-postcards.md.
- 18 built-in badges (First Login, 30-Day Caller, First Post, Frequent Poster, Centurion Poster, PM Sent, Echomail Hatchling, Netmail Pioneer, Town Crier, Veteran, High Scorer, Game Explorer, Door Diver, Wiki Editor, Wiki Scribe, File Uploader, Librarian, Town Legend) — checked and awarded automatically on login (or the next board post/PM/shoutbox post after qualifying), with a flash notice on new unlocks
- Shown on each user's Profile page and rolled up into a site-wide count on the public Stats page
- Sysop-extensible — new rules are plain Python functions in
anetbbs/features/achievements.py
- ANetBBS Pulse — read-only, mobile-first status dashboard at
/admin/pulse/, installable to a phone's home screen (Android + iOS). Live callers, service health, disk/uptime, 24-hour activity — no service-control actions, no shell, nothing writable. - Auto-social-posting queue (
/admin/social/, off by default) — a new #1 leaderboard score or a round-number BBS milestone queues a draft Bluesky/Mastodon post (rendered image + editable caption) for a sysop to review, plus a manual compose option for anything else (a version bump, a new feature); nothing posts automatically, and queuing a draft notifies every admin. See docs/31-social-posting.md. - Echomail dashboard with poll logs, AreaFix log, bad-areas review
- File-area admin
- Manual
+TAG/-TAGAreaFix-to-hub form - BBS directory browser with live
who's onlinequeries anetbbs-cfg— standalone full-screen terminal admin tool (SCFG /mystic -cfgstyle), run directly on the server console, near-full parity with the web admin: boards & message areas, echomail networks/ areas/hub (AreaFix log, poll log, QWK node requests), file areas & bulletins, users & security (access levels, password reset, IP bans, word filters, login auto-ban, registration log), games (door games, categories, active sessions), image galleries, BBS/PETSCII menu editors, scheduled events, graffiti wall moderation, login modules, last-callers log, backup browsing, translations, and.envsystem settings — no browser required.python -m anetbbs.cfgfrom a checkout, oranetbbs-cfgonce installed.anetbbs-monitor— a console-only sysop dashboard (uMonitor / nodespy style): a live, auto-refreshing node list (who's connected, on what protocol, from where, doing what, with a kick action), a Today/Total activity stats panel, a scrollablebbs.logviewer, one-key access toanetbbs-cfg, a light/dark theme toggle, and mouse support — no browser required.python -m anetbbs.monitor.appfrom a checkout, oranetbbs-monitoronce installed.
docs/DEVELOPMENT-WORKFLOW.md— canonical checkout, private builds, and GitHub sync workflowdocs/19-email.md— Internet Mail setup, DNS/authentication, and troubleshootingdocs/00-overview.md— architecture + table of contentsdocs/INSTALL.md— full installdocs/INSTALL-PI.md— Raspberry Pi install guide (hardware, DDNS, SSD, troubleshooting)docs/INSTALL-WINDOWS.md— Windows install guide (WSL2, Docker Desktop)docs/PORTS.md— every port the BBS usesdocs/SECURITY.md— security defaults + production hardeningdocs/CHANGELOG.md— version historydocs/MSP_LOOPBACK_TEST.md— verify MSP worksdocs/06-echomail.md— echomail configdocs/07-file-areas.md— file area configdocs/13-image-galleries.md— image galleriesdocs/25-petscii.md— PETSCII (C64/128) terminal supportdocs/26-synchronet-json-rpc-doors.md— 17 confirmed-working Synchronet door games (download/setup)docs/28-anetbbs-cfg.md—anetbbs-cfg, the SSH/console terminal config tooldocs/32-node-monitor.md—anetbbs-monitor, the console-only sysop dashboard (nodes, stats, logs, theme)docs/34-jam-export.md— JAM message base export for classic door gamesdocs/35-mods-directory.md— customizing art/scripts/login logic so changes survive updatesdocs/36-ansi-editor.md— web ANSI editor's file browser, extra export formats, TheDraw font picker
See LICENSE. ANetBBS bundles some third-party components (fonts, a Synchronet JS compatibility layer used to run Synchronet door games, and the LORD door game) under their own separate terms — see NOTICE for the full breakdown.
Known rough edges:
- MSP/SYSTAT need privileged ports (11/18) — see
docs/INSTALL.mdforsetcap/ systemd / iptables-redirect options. - Synchronet stock
.jsdoors: LORD is verified end-to-end under the Node shim. Other Synchronet doors mostly work but each one tends to exercise a different corner of the API — file an issue if a door dies with aReferenceErrorand the missing stub will get added. - Single-process rate limits — fine for one gunicorn worker; needs an external store for multi-worker setups.
Issues and patches welcome. Chat/discussion: IRC at irc.a-net.online
(port 6667 plain, 6697 SSL), room #ANetBBS.