Running an Atari BBS Today: Software, Emulators and FujiNet

In the 1980s, running a bulletin board meant a dedicated Atari, a stack of disk drives, a modem that could answer the phone, and a second phone line. Today the phone line is a TCP port, the disk drives can be a 16 MB hard-disk image, and the computer can be real or emulated. The software is the same: many of the original Atari BBS packages run unchanged once something emulates an answering modem, and new ones are being written.

This guide covers what you need to host a board: choosing the software, the three ways to accept calls, the settings that cause most problems, and how callers find you. For the calling side, see Calling Atari BBSes Today.

1. How an Atari BBS takes a call

Most Atari BBS programs talk to a Hayes-compatible modem through the R: device, as on an 850 interface. They wait for the modem to say RING, answer the call (or let the modem auto-answer), and watch for CONNECT. From then on, everything the BBS prints goes to the caller, and the caller's keys come back in. When the caller hangs up, the modem reports NO CARRIER and the board resets for the next call.

A modern "modem" does the same, except that an incoming TCP connection plays the part of the ringing phone. Each node handles one caller at a time, just as one phone line did.

2. The software

The comp.sys.atari.8bit FAQ lists about 30 Atari BBS programs and families. The ones you are most likely to run today:

Package Written in Needs (as documented) Notes
AMIS and derivatives Atari BASIC 48K, 850 + Hayes modem in the original The first: the MACE board in Michigan went online 24 hours a day in February 1982. Its BASIC source spawned Fast AMIS, Carnival, Comet AMIS and others.
FoReM XE (Matthew Singer) BASIC XE + assembler BASIC XE cartridge Public domain. Descended from AMIS via FoReM 26M and FoReM XL.
FoReM XE Professional (Len Spencer) BASIC XE + assembler XL/XE with 128K, BASIC XE, SpartaDOS 3.2 only, 500K+ storage Last version 5.4 (1993). The most-revived Atari board today.
BBS Express! / Pro! (Keith Ledbetter and others) Compiled Action! / machine language Pro!: XL/XE, SpartaDOS 3.2+, a hard drive "highly recommended" Pro! is still sold by Video 61. Express! had 835/1030/XM301 and 850 versions.
Carina II Atari BASIC + MOE modem core XL/XE, SpartaDOS 2.3+, 500K storage Modular and easy to modify. Last version 2.7 (1995).
OASIS / OASIS Jr. Machine language SpartaDOS 3.2x recommended Fast and crash-resistant, with "PAL" door modules and a sysop dial-out screen.
Action 8 BBS Action! FujiNet, Action! A new ATASCII board written for FujiNet's N: device. Work in progress.

Two practical points follow from that table. Most packages want SpartaDOS and far more storage than a floppy holds, so plan on a large hard-disk image (see section 5). And several need a cartridge language (BASIC XE or Action!) as well as the program disks.

3. Route 1: host the board in Altirra

An emulator is the easiest way to start, and many of today's revived Atari boards run this way. Altirra emulates an 850 interface with a Hayes modem behind it, and the modem can accept inbound connections:

  1. Under System, Devices, add the 850 Interface Module and enable listening for incoming connections in the serial port options, choosing a TCP port.
  2. When someone connects, the modem reports RING. It completes the connection when the BBS sends ATA or when the auto-answer register S0 is set, as on a real modem. Only one connection can be active at a time.
  3. Turn on Telnet emulation if callers use telnet clients. For incoming calls, Altirra then also tries to switch off local echo on the caller's terminal.
  4. If callers see stray characters after RETURN, turn on Automatic CR/LF conversion. It switches itself off for any session that sends an ATASCII end-of-line, so Atari callers still get a clean binary connection.
  5. Some BBS software checks the speed in the CONNECT message. The connection speed option forces a fixed figure such as CONNECT 2400.

FoReM-specific notes. Altirra's compatibility notes cover two FoReM quirks. FoReM XL/XE/XE Pro expects the U.S. Robotics result code for a 9600-baud connect (13), but Altirra's modem returns the Conexant code (12). Either limit the connection speed to 2400 baud or change the expected code as the FoReM documentation describes. FoReM's clock also assumes exactly 60 (or 50) frames a second, while a real Atari runs slightly slower, so it loses a few seconds a day. Setting the emulator's speed to exactly 50/60 Hz in Speed Options compensates. Altirra's developer has also fixed an 850-emulation control-line bug that made FoReM XEP drop calls, so use a current version.

4. Route 2: a real Atari with FujiNet

FujiNet emulates an 850 and modem on the SIO bus, and it can listen too. FujiNet's R: devices accept extra SIO commands for this:

  • Listen ($4C): open a TCP port (1–65535) for incoming connections. The FujiNet tools include an RLISTEN program that sends it, run as RLISTEN 6502 from a command-line DOS, or interactively from DOS 2.0 or MyDOS.
  • Unlisten ($4D): close the port and drop any caller.
  • Lock baud rate ($4E): ignore further baud-rate changes. FujiNet's documentation describes this as useful for BBS software that keeps changing the rate.
  • Modem sniffer: AT+SNIFF logs all modem traffic to a file on the SD card, which you can then fetch from the FujiNet's web page. Turn it off with AT-SNIFF. It is invaluable when a board answers but doesn't behave.

FujiNet's wiki has deployment guides for FoReM 850-26M, BBS Express 850 1.0 and Carina BBS 2.7. Large hard-disk ATR images on the FujiNet's SD card take the place of the hard drive that big boards once needed.

Action 8 BBS takes a more modern route. It skips the R: modem layer and listens directly on FujiNet's N: network device, opening N:TCP://:6502, so callers connect to port 6502 at the FujiNet's IP address. Its README sets it up with Action! and DOS on D1:, a blank formatted data disk on D2: and the source files on D3:. You compile and run SETUPBBS once to create the data files, then compile and run ACTBBS. The local screen only shows debugging output: the board runs unattended.

5. Route 3: the PC as the modem

With an SIO2PC cable, APE for Windows can emulate the 850 and modem, including an inbound server mode that answers like a Hayes modem. One sysop on AtariAge reported running FoReM XE Pro on a real Atari through APE's modem this way. Otherwise it works like the FujiNet route: the Atari runs the BBS, and the PC supplies the network connection.

6. Setting up storage and boot

The details depend on the package, but the pattern is the same. FoReM XE Pro, as rebuilt by AtariAge members since 2021, is a good example:

  • A big SpartaDOS volume. Builders use 16 MB SpartaDOS ATR images for the program and each data area, mounted in Altirra or on FujiNet. One report of bad sectors at the top of FMTDIR-created 16 MB images is unresolved, so test new images before trusting them with a live board.
  • The directory tree. FoReM XEP expects directories such as BASES, SIGS, TEXT, HELP, GAME01, DATABASE and PERM on drive 1, plus a BIRTHDAY tree and a DAY directory. Create them with SpartaDOS's CREDIR command and unpack the matching archives into them. Later builders wrote batch files to create the whole tree automatically.
  • The boot sequence. Load the RS-232 handler and the modem and handler extensions before starting the board. For FoReM XEP that means RS232.COM, AMP850.COM and ZHAND.COM, with the BASIC XE cartridge (and its extensions) in place.
  • Initialisation. Run the package's set-up programs once (for FoReM, SGINIT.BXE and SIGUTIL.BXE) before the first caller.

Back up the data images regularly, and keep a clean copy of the master disk.

7. Letting callers in

  • Port forwarding. On your router, forward the TCP port you chose to the PC running Altirra or to the FujiNet's address. Give the FujiNet a fixed address on your network so the forward stays valid.
  • A stable name. Home connections change address. Several current Atari boards use dynamic-DNS names (such as southernamis.ddns.net and basementbbs.ddns.net), which callers can dial directly: ATDT basementbbs.ddns.net:9000 from a FujiNet modem.
  • Raw or telnet. Many boards accept raw TCP, which works with every Atari modem. If you run a telnet front end, Atari callers need telnet switched on (ATNET1 on FujiNet).
  • Modern callers. People without an Atari can still call an ATASCII board. The Action 8 BBS README suggests SyncTERM (Windows, Linux, macOS), MuffinTerm (Mac) and AtConnect (Windows).
  • Getting listed. Announce the board in the AtariAge 8-bit forums and ask to be added to the active-BBS list linked from the FujiNet wiki.

Troubleshooting

  • The board answers, then goes straight back to "waiting": the modem isn't reporting carrier the way the software expects. Check the 850/modem options, the connection-speed setting and the BBS's modem configuration. Logging the modem traffic (FujiNet's sniffer, or Altirra's MODEM log channel) shows exactly what was said.
  • FoReM drops callers at 9600: the CONNECT result-code mismatch (12 versus 13). Lower the speed limit or patch the expected code.
  • Callers see junk at login: telnet negotiation codes are reaching a raw-TCP board, or vice versa. Match the telnet setting to what callers use.
  • Stray characters after every RETURN: turn on CR/LF conversion in Altirra, or tell callers to switch off "send LF" in their terminal.
  • The clock drifts: see the 50/60 Hz speed setting above, or use an R-Time 8 if the software supports it.
  • Disk errors on big images: test new hard-disk images thoroughly and keep backups.

Further reading

  • The comp.sys.atari.8bit FAQ, section 8.16, "What programs can I use to host a BBS on the Atari?", with notes from many of the original authors.
  • Jason Scott's BBS Documentary software archive, which collects Atari 8-bit BBS packages and screenshots.
  • Altirra's help file: "850 Interface Module emulation" and the FoReM compatibility notes.
  • FujiNet wiki: "Additional Commands for R: Devices", "Using the MODEM Sniffer" and "Deploying your Favorite BBS".
  • On this site: Calling Atari BBSes Today, the FoReM XE BBS, BBS Express! and BBS Express! Professional, Carina BBS and OASIS BBS software entries, FujiNet Setup Guide, Programming the FujiNet N: Device.

Credits