---
title: 'TTG Mail BBS'
url: 'https://wiki.teletypegames.org/services/bbs/ttg-mail-bbs'
markdown: 'https://wiki.teletypegames.org/services/bbs/ttg-mail-bbs.md'
lang: en
date: '2026-11-06'
description: 'The post office of the BBS network: letters between the accounts. Log in with your account of the network, open your mailbox, write to anyone with an account, read and answer your letters, and block a writer you do not want to hear from. The post office has a wall too, and a desk for a word to the…'
taxonomy:
  tag:
    - howto
    - bbs
    - rubbs
    - mail
---

# TTG Mail BBS

> The post office of the BBS network: letters between the accounts. Log in with your account of the network, open your mailbox, write to anyone with an account, read and answer your letters, and block a writer you do not want to hear from. The post office has a wall too, and a desk for a word to the sysops.
> 
> **Live at `teletypegames.org:2335`**, in the browser on [bbsweb](https://bbsweb.teletypegames.org), and through [TTG Gate BBS](https://wiki.teletypegames.org/services/bbs/ttg-gate-bbs)

# Overview

A Ruby app on the [**rubbs**](https://git.teletypegames.org/engines/rubbs) gem and [ttg-common](https://git.teletypegames.org/bbs/ttg-bbs/src/branch/master/boards/common), like every board of the network. The board keeps no data of its own: the accounts, the letters, the wall and the feedback live on [TTG Gate BBS](https://wiki.teletypegames.org/services/bbs/ttg-gate-bbs), the network's Central, and the board asks it.

It has two faces on one port:

- **Modern**: ANSI colours, menus and the mouse (SyncTERM, NetRunner, PuTTY, bbsweb). The MAIL logo on the desktop, a menubar, and each screen (the mailbox, a letter, the editor) on the whole line. The status line says how many letters are new.
- **Commodore 64**: PETSCII on a 40×25 screen, for a C64 terminal program (CCGMS, Novaterm, UltimateTerm) behind a WiFi modem. A cursor menu, the letters as numbered lists, a letter in pages, the new ones counted on the menu.

A call starts with rubbs' `Rubbs::Common::Call::Terminal` question (RETURN takes the guess, `1` picks the modern face, `2` the C64), then the TTG logo and *Login | Register | Guest*. Through TTG Gate BBS neither comes twice, and a caller logged in on the gate arrives logged in.

# Using it

**On a modern terminal:**

| Key | Action |
|---|---|
| F2 | Mail › Mailbox |
| F3 | Mail › The wall |
| F7 | Mail › Write to the sysops |
| You › Profile | Log in, register, your account |
| F10 | The menu |
| Alt-X | Log off |

**On a Commodore 64** the main menu is `M` mailbox (with the number of new letters), `W` the wall, `F` write to the sysops, `P` profile, and log off.

# The mailbox

The mailbox is ttg-common's `TTG::PrivateMessage`, the same on both faces:

- **The letters to you**, newest first, a new one marked *(new)*; **Sent letters** switches to the letters you wrote, a list of their own.
- **A letter** taken is shown whole, with its writer, its addressee, the time and the board it was written on, and so marked read. Then **Reply** (the subject gets `Re:`), **Delete**, or **Block the sender** (`K`): the writer's next letters are refused as if there were no such account.
- **Write a letter**: the account to write to, the subject on a line, then the letter in the full-screen editor, up to 4000 characters.
- **Accounts only**: a guest is told to log in or make an account in the profile.

The Central keeps the limits: one letter in 30 seconds and 50 a day an account, and no letter to a banned account. The board's words for the screen are in `lib/content/mail.yml`, over ttg-common's defaults (the C64 texts under `petscii:`).

**The wall** is the post office's own (ttg-common `TTG::Wall`, words in `lib/content/wall.yml`): callers write notes and answer each other, an account under its name, a guest marked *(guest)*. **Write to the sysops** is ttg-common's `TTG::Feedback`, read on the sysops' feedback desk.

# Configuration and data

| Variable | Default |  |
|---|---|---|
| `BBS_PORT` | `2323` | the telnet port (`boards.yml` sets 2335, inside the container too) |
| `BBS_MAX_SESSIONS` | `100` | callers at once (`boards.yml` sets 50) |
| `TTG_CENTRAL_URL` | `http://ttg-gate-bbs:8090` | the network's Central (TTG Gate BBS) on the interstack network |
| `RUBBS_AUTH_SECRET` | — | the secret every board of the network shares, in `.env` on the server |

The board keeps nothing of its own: the letters are in `data/messages.sqlite3` on TTG Gate BBS, the wall and the feedback there too. Without the Central the board still answers, and says the mail cannot be reached now.

# Under the hood

It runs as `boards/ttg-mail` of [`bbs/ttg-bbs`](https://git.teletypegames.org/bbs/ttg-bbs), in the shared `ttg-bbs` container; its data is in `/srv/stacks/ttg-bbs/boards/ttg-mail/data` and stays between deploys. A push to master of `bbs/ttg-bbs` deploys it from Woodpecker (`ci-deploy ttg-bbs`); a change only in `boards/ttg-mail` restarts only this board. Its log lines are in `docker logs ttg-bbs`, with `"board":"ttg-mail-bbs"`. Its `memory` limit in `boards.yml` is 160 MB.

The code follows the house layering: `lib/domain` (`MailboxSummaryModel`, `MailService` for a caller's mailbox at a glance, the composition root `TTGMailBBS`) knows nothing of telnet, and `lib/ui` holds `UI::Modern` (a rubbs `Rubbs::Modern::Application`) and `UI::Petscii` (a `Rubbs::Petscii::Face`). The mailbox, the wall and the feedback screens are ttg-common's; `bbs.rb` puts them together with `Rubbs.board`.

 [howto](https://wiki.teletypegames.org/tags?tag=howto)[bbs](https://wiki.teletypegames.org/tags?tag=bbs)[rubbs](https://wiki.teletypegames.org/tags?tag=rubbs)[mail](https://wiki.teletypegames.org/tags?tag=mail) 

## Related pages

- [BBS boards](https://wiki.teletypegames.org/services/bbs) Services
- [Siliconia BBS](https://wiki.teletypegames.org/services/bbs/siliconia-bbs) BBS boardsThe computer and console museum on a telnet line: every machine Wikidata knows, Wikipedia's stories, and the callers' marks and memories
- [Kinema BBS](https://wiki.teletypegames.org/services/bbs/kinema-bbs) BBS boardsThe film catalog on a telnet line: any film or person from Wikidata, Wikipedia's articles, and the callers' ratings and watchlists
- [Monitor BBS](https://wiki.teletypegames.org/services/bbs/monitor-bbs) BBS boardsGrafana's dashboards on a telnet line, for the accounts with the grafana role, through TTG Gate BBS only
- [HackerCave BBS](https://wiki.teletypegames.org/services/bbs/hackercave-bbs) BBS boardsThe hacker's reading room on a telnet line: every RFC, the IENs and the Jargon File, searched to the last line, linked, with the errata, read as published or reflowed for a C64

'; var prevLevel = 2; for (var i = 0; i < headings.length; i++) { var h = headings\[i\]; var text = h.textContent.trim(); var slug = text.toLowerCase() .replace(/\[áàâä\]/g,'a').replace(/\[éèêë\]/g,'e').replace(/\[íìîï\]/g,'i') .replace(/\[óòôöő\]/g,'o').replace(/\[úùûüű\]/g,'u') .replace(/\[^a-z0-9\]+/g, '-').replace(/^-|-$/g, ''); if (!slug) slug = 'heading-' + i; if (used\[slug\]) { slug += '-' + i; } used\[slug\] = true; h.id = slug; var level = parseInt(h.tagName.charAt(1)); var cls = level > 2 ? ' class="toc-child"' : ''; html += '- [' + text + '](#'%20+%20slug%20+%20')
'; } html += '
'; toc.innerHTML = html; // Scroll-spy: highlight current heading var links = toc.querySelectorAll('a'); var ids = \[\]; for (var j = 0; j < links.length; j++) ids.push(links\[j\].getAttribute('href').slice(1)); function updateActive() { var current = ''; for (var k = 0; k < ids.length; k++) { var el = document.getElementById(ids\[k\]); if (el && el.getBoundingClientRect().top <= 80) current = ids\[k\]; } for (var m = 0; m < links.length; m++) { links\[m\].parentNode.classList.toggle('active', links\[m\].getAttribute('href') === '#' + current); } } window.addEventListener('scroll', updateActive, { passive: true }); updateActive(); })();

---

## Navigation

- Parent: [BBS boards](https://wiki.teletypegames.org/services/bbs.md)
- Previous: [TTG Gate BBS](https://wiki.teletypegames.org/services/bbs/ttg-gate-bbs.md)
- Next: [WarpEngine BBS](https://wiki.teletypegames.org/services/bbs/warp-engine-bbs.md)
