---
title: 'TTG Gate BBS'
url: 'https://wiki.teletypegames.org/services/bbs/ttg-gate-bbs'
markdown: 'https://wiki.teletypegames.org/services/bbs/ttg-gate-bbs.md'
lang: en
date: '2026-10-30'
description: "One address for every board of the network: pick one from the menu and the gate puts you through; when that board hangs up, you are back at the menu. And Global Discovery: the world's other telnet BBSes in one searchable list, each with the result of our last call, dialled the same way. Live at te…"
taxonomy:
  tag:
    - howto
    - bbs
    - rubbs
    - auth
---

# TTG Gate BBS

> One address for every board of the network: pick one from the menu and the gate puts you through; when that board hangs up, you are back at the menu. And **Global Discovery**: the world's other telnet BBSes in one searchable list, each with the result of our last call, dialled the same way.
> 
> **Live at `teletypegames.org:2399`**, and in the browser on [bbsweb](https://bbsweb.teletypegames.org) (the last card)

# Overview

TTG Gate BBS is the network's front door: a dialing menu, the telnet counterpart of the list on [bbsweb](https://bbsweb.teletypegames.org). The chosen board's own port takes the call through a telnet gateway of [rubbs](https://wiki.teletypegames.org/engines/rubbs) (`Rubbs::Common::Line::Gateway`); every board keeps its code, its port and its deploy, and the gate only carries the bytes. It is also the network's **Central**: the accounts, the walls, the feedback, the letters and the badges of every board live here (see *Accounts and the Central* below and the [BBS Network](https://wiki.teletypegames.org/services/bbs-network)), and it has a daily page, **Today**.

Like every board of the [BBS Network](https://wiki.teletypegames.org/services/bbs-network) it has two faces on one port, and a call starts with the same terminal question:

- **Modern** — the logo and the tabs **Own Servers** | **Global Discovery** | **Today** | **Profile** (TAB or the right arrow goes to the next, the left arrow back; `T` opens Today, `W` the Wall, which has no tab of its own). Over the list one line tells the day: the date, the name days, Budapest's weather. Own Servers: one row a board in its own colour (number, name, tags, port), and under the list the chosen board's description and address. The arrows choose, RETURN or the board's number dials, `Q` or Esc hangs up.
- **Commodore 64** — one frame around every screen, in the C64's sixteen colours and its lower/upper character set: the colour `TTG GATE` logo with the node and the clock; the tabs **Own**, **Global** and **Today** (and **You**, the profile), the active one a band in its colour, with the boards online on the right; under them the active tab's sub-menu (`/Find`, `Browse`, `New`, `Random`, `Died`, `Graves`, `Srcs`, their keys in yellow); the content across all 40 columns; and a hint bar of the screen's keys. **Own Servers** lists our boards that have a C64 face: a block of the board's colour, its name and port, and under the list the lit board's description, address and tags. `O` and `D` switch the tabs from anywhere; CRSR up and down move in a list, and on Global Discovery CRSR up from the top of the list goes to the sub-menu (left and right move its bar, RETURN opens, CRSR down goes back); a yellow key opens its place from anywhere; RETURN opens or dials, `←` or RUN/STOP goes back, `Q` hangs up.

![Own Servers on the C64 face](https://wiki.teletypegames.org/wiki-assets/ttg-gate-bbs/c64-tabs-own-servers.png)

# Dialing a board

The board asks its own terminal question first. The gate reports the caller's window size to it, so a modern terminal is its default; a C64 reports none, so the board takes it for a C64. RETURN takes the guess.

Leave the board the way you always do (log off, Alt-X, Q on a C64): the gate says that it hung up, and a key brings the menu back.

# Today

The gate's daily page, a tab on both faces (`T`):

- **the day:** the date, day of the year and week, the Hungarian name days, the holidays, sunrise, sunset and the moon (Budapest's time);
- **the weather** now, today and tomorrow in Budapest and in the capital of the caller's country (from the address's country, not kept), from Open-Meteo (CC BY 4.0);
- **the forint:** EUR, USD, GBP, CHF from the ECB's daily reference rates;
- **on this day** in history, from the English Wikipedia's feed (CC BY-SA);
- **earthquakes** of magnitude 4.5 and over in the last day, from the USGS;
- **the network:** the callers on the gate, our boards, the catalog's boards online and new this week, the board of the day (RETURN opens its page) and the newest note of the walls.

A caller never waits for the web: a background job fetches each source at its own pace into `data/herald.sqlite3` every ten minutes, and the page is made from it. A source that fails keeps its old payload until it is too old to show, then its part is left out. On the modern face the page has two columns with the network under them; on a C64 four pages (`+`/`-`): TODAY, THE WORLD, ON THIS DAY, THE NETWORK. `TTG_GATE_BBS_HERALD_FETCH=false` stops the fetching.

## Accounts and the Central

The gate is the network's Central (rubbs' `Rubbs::Common::Central`, `http://ttg-gate-bbs:8090` on the `interstack` network, every request signed with `RUBBS_AUTH_SECRET`; `TTG_GATE_BBS_CENTRAL_PORT`, 0 turns it off). Its services and databases: the accounts (`data/accounts.sqlite3`), the feedback (`data/feedback.sqlite3`), the walls (`data/wall.sqlite3`), the letters (`data/messages.sqlite3`) and the badges (`data/badges.sqlite3`). A caller signed in here is signed in on the board the gate dials. **PROFILE** (**YOU** on a C64, or `P`) logs in, makes an account and changes the password; the Wall (`W` on Own Servers or Today) shows every board's wall together and takes notes on the gate's own; **FEEDBACK** (`F`) is the gate's feedback box.

Own Servers is the same for every caller but one row: **[Monitor BBS](https://wiki.teletypegames.org/services/bbs/monitor-bbs)** (Grafana's dashboards) shows at its end only for an account signed in with the `grafana` role (`role: grafana` in `config/boards.yml`). The list is asked again on every screen, so the row appears as soon as such a caller logs in on the profile. Its port is not published (`local: true`): the gate dials it in its own container and shows *through the gate* (`GATE` on a C64) for its address.

A caller with the `sysop` role finds **SysOp** in the profile, on either face: the console, with five tabs.

- **Calls:** who is on the gate now, from where (`telnet`, `bbs-web`), on which face and where they are (`› Feedia BBS`); RETURN or `H` hangs the chosen call up.
- **Accounts:** every account with its roles and last login; `/` finds, `G` grants a role, `R` revokes one, `B` bans (its calls hung up) or lifts the ban, `N` gives a new random password, `H` hangs up its calls.
- **Feedback:** what callers sent from every board, newest first; RETURN reads, `D` done, `S` spam, `U` new again, `X` deletes.
- **Wall:** every board's notes, hidden ones too; `H` hides or shows, `B` bars a guest's line for a day.
- **Log:** the gate's last 500 log lines; `F` keeps warnings and errors, `/` finds a word.

Every step is a log line with the sysop's name. From the server's shell `bin/account` does the same (the first sysop, the import):

```bash
docker exec -it -w /app/boards/ttg-gate ttg-bbs bin/account password NAME     # makes the account when there is none
docker exec -it -w /app/boards/ttg-gate ttg-bbs bin/account grant NAME sysop
docker exec -it -w /app/boards/ttg-gate ttg-bbs bin/account ban NAME [REASON]
docker exec -it -w /app/boards/ttg-gate ttg-bbs bin/account list
```

**Badges.** With an account this board counts for Explorer (1, 10, 50 boards of Global Discovery dialled), Newsreader (Today seven days in a row), besides the network's own.

# Global Discovery

Besides our own boards, the gate keeps a catalog of the world's other telnet BBSes, from public lists, and calls every one of them once a day to see whether it answers. Nothing in it is written by hand: every field comes from a source list, from our own call, from DNS or from a fixed rule table, and no language model is involved. Only telnet; no SSH, rlogin or web addresses.

## Finding a board

On the **modern** face, Global Discovery has:

| Entry |  |
|---|---|
| Every board | all but the dead ones, the answering ones first, then by name |
| Search | `/` anywhere; see below |
| Browse | by Terminal (ANSI, PETSCII, ASCII, ATASCII), Software, Country and Network, each with its count |
| New this week | the boards a list named first in the last 7 days |
| Random board | one that answered our last call |
| Recently died | the boards that turned dead in the last 30 days |
| Graveyard | every dead board: none is ever deleted, its history stays |
| Sources | the lists, their credits, DB-IP, and how to opt out |

A list shows the state of each board: `●` online, `◐` flaky, `✗` down (with how long: "down for 3 days"), `†` dead, `?` not called yet. `F` filters by state, the arrows and PgUp/PgDn page. The board's own page has its address, state and last answer, why our server did not reach it (a name that does not resolve is not the same as a firewall), a strip of the last 30 days (`█` answered that day, `·` did not), every field with the list it came from, the FTN address, the tags, and `B` for the first screen of its banner.

**Search** reads its words as tags where it can: `petscii hu online` is the encoding, the country and the state together, `synchronet`, `fidonet` or `sbl` find the software, the network or the list. The other words search the names, sysops, places, software and host names, each word the start of a word there. The dead boards stay out unless the search says `all`. FTN mailers (mail programs answering a nodelist's telnet address, not BBSes) are never listed unless searched for as `sw:ftn-mailer`.

On the **Commodore 64**, `D` (the Global Discovery tab) opens Global Discovery in the same frame: ten boards a page under a row of filter chips (`PETSCII`, and the state `F` chose: alive, online, flaky, down, not called yet), each with its state mark (a half block: light green online, yellow flaky, red down, grey dead), name, country and software, and under the list the lit board's whole address, state, latency, software and terminals. Only PETSCII boards are on it, the dead ones apart but in Died, Graves or a search with `all`, since the gate carries the bytes as they are and an ANSI board is noise on a C64. A board is a PETSCII board when one of our calls got PETSCII from it, not because a list says so (see the C64-style call below). Find (`/`) is typed on the hint row; Browse (`B`) has Software, Country and Network; `S` opens the Sources. A board's page shows the 30-day strip, the fields (a long value wraps) with the list each came from, the tags as chips, and the buttons: RETURN dials, `B` shows its PETSCII banner. **Sources** draws each list with a bar of its records, whether its last import went well and how long ago, its format and terms, and PETSCII measured against claimed.

[![Global Discovery on the C64 face](https://wiki.teletypegames.org/wiki-assets/ttg-gate-bbs/c64-tabs-discovery.png)](https://wiki.teletypegames.org/wiki-assets/ttg-gate-bbs/c64-tabs-discovery.png)Global Discovery on the C64 face

[![A board's page on the C64 face](https://wiki.teletypegames.org/wiki-assets/ttg-gate-bbs/c64-tabs-board-page.png)](https://wiki.teletypegames.org/wiki-assets/ttg-gate-bbs/c64-tabs-board-page.png)A board's page on the C64 face

[![Sources on the C64 face](https://wiki.teletypegames.org/wiki-assets/ttg-gate-bbs/c64-tabs-sources.png)](https://wiki.teletypegames.org/wiki-assets/ttg-gate-bbs/c64-tabs-sources.png)Sources on the C64 face

## Dialling a board of the catalog

RETURN on a board's page dials it, through the same gateway as our own boards; when it hangs up, a key brings back its page, and `Q` (on a C64 `←`) the list where you were.

- Only a board of the catalog can be dialled: there is no free address to type, so the gate is no open relay.
- 10 dials in 10 minutes a caller, and at most 3 lines from the gate to one host at once (the defaults; they are configurable, see Configuration).
- The modern face asks before a board made for a C64 only; the C64 face dials PETSCII boards only. A dead board can be dialled too, after a question.
- A dial counts as one of our calls: its result goes into the board's history and state, and a failed one makes the prober call the board again at once.

## How we call a board

The prober runs on our server (`teletypegames.org`, `vps.teletype.hu`) and calls only the addresses the source lists publish: **nothing is scanned**.

1. It looks the host up and connects, giving up after 10 s.
2. It answers the telnet questions with fixed replies: the terminal type `ANSI`, a window of 80×25; every other option is declined.
3. It reads for at most 8 seconds or 4 KB. If nothing comes in 4 seconds, it sends one Enter, nothing else. **It never logs in.**
4. It hangs up. The result is `ok` (a banner came), `silent`, `closed`, `refused`, `timeout` or `dns_fail`.

**The C64-style call.** Because the prober says it is an ANSI terminal, a board that adapts to its caller shows it ANSI, while a real Commodore 64 (a terminal program behind a WiFi modem, which knows no telnet) would get PETSCII. So a board a list calls a Commodore or PETSCII board (every board of the CBBS Outpost, a SyncTERM entry in C64 mode, a PETSCII comment in the SBL, a Telnet BBS Guide entry naming PETSCII or running a Commodore BBS program), or whose banner was PETSCII, is called a second time, 30 seconds after its daily call answered, the way a C64 calls: the same connection, one Enter (CR, 0x0D) after 4 seconds of silence, but every telnet option declined, no terminal type, no window size, and a longer window, since a real C64 behind tcpser may answer late: up to 20 seconds for the first byte, reading until 25 seconds or 4 KB. It belongs to the same daily round and never runs beside another call to the host, so these boards get at most two calls a day; after a failed call there is no C64-style one, and a silent one is tried again the next day. It does not count towards the board's state.

A board gets the `petscii` tag only when one of the two calls actually got PETSCII bytes. What a list says is kept as `claims:petscii`, a tag you can search for but that is not shown: a Commodore-listed board whose C64-style call gets ANSI or plain text is no PETSCII board. A board that shows ANSI to our terminal and PETSCII to a C64 gets both tags and can be dialled from both faces; both banners are kept, the modern face plays the ANSI one, the C64 face the PETSCII one.

An answering board is called once a day (± 2 hours), a failing one again after 1, 6 and then 24 hours, a dead one (no answer for 30 days) weekly; a board that no list names any more and has been dead for a year is no longer called. At most 8 calls run at once, never two to the same host or IP address. The software and the encoding come from the banner by a fixed table of patterns, the country from the IP address.

## Opting out

A sysop can ask for either of two things, for a host name or an IP address (every port of it):

- **hide** — the board is never called and never shown;
- **no\_preview** — the board is listed and called, but its banner is never shown.

Send the host name or address and the level to the Teletype Games team ([contact](https://teletypegames.org/contact): Discord or e-mail). The entry goes into [`config/discovery-optout.yml`](https://git.teletypegames.org/bbs/ttg-bbs/src/branch/master/boards/ttg-gate/config/discovery-optout.yml), and the prober honours it within the hour of the push.

## Sources and credits

| Source | What we read |
|---|---|
| [FidoNet nodelist](https://nodelist.fidonet.cc) (Z2DAILY, via NodelistDB) | the nodes with a telnet address: name, place, sysop, FTN address |
| [fsxNet nodelist](https://fsxnet.nz) | the same, for fsxNet |
| [Micronet nodelist](https://minftn.outpostbbs.net) | the same, for Micronet |
| [Synchronet BBS List](https://www.synchro.net/sbbslist.html), exported from Vertrauen | name, sysop, place, software, addresses, networks, year of start |
| [SyncTERM BBS list](http://synchro.net/syncterm.lst) | name and telnet address |
| [CBBS Outpost (commodorebbs.com)](https://www.commodorebbs.com), the list of Commodore boards | name, telnet address, place, software, hardware, website |
| [Telnet BBS Guide (telnetbbsguide.com)](https://www.telnetbbsguide.com), used with permission | the monthly list: name, telnet address, place, software, website |

We read the listed facts of each board and never republish the files. From the **CBBS Outpost (commodorebbs.com)** we take the facts only, once a day in one request, with its credit on every board page it names and on the Sources screen: never the sysop's name, e-mail or user name, screenshots, comments or the site's own online mark; its listing of a Commodore board is a claim that our C64-style call checks. Its sysops can ask us to take an entry down, as in Opting out. For a board it lists, its software and place come first. The **Telnet BBS Guide (telnetbbsguide.com)** is used with its permission: we read its official monthly list, the one it publishes for distribution, never its e-mail addresses or descriptions (a description only tells whether it names PETSCII), and only the telnet entries. It is the largest list, but edited by hand once a month, so for a board the nodelists and the SBL name, their fields come first. The countries come from [DB-IP](https://db-ip.com)'s IP to Country Lite database, under CC BY 4.0: **IP Geolocation by DB-IP**; we keep our own copy, downloaded monthly.

# Configuration

The boards come from [`config/boards.yml`](https://git.teletypegames.org/bbs/ttg-bbs/src/branch/master/boards/ttg-gate/config/boards.yml), in the order of the menu, with the names, descriptions, tags and accent colours of their bbsweb cards:

| Field |  |
|---|---|
| `id` | a short name, unique |
| `name` | shown in the menu |
| `summary` | the description on the modern face |
| `tags` | the line under the name on the C64 face |
| `port` | the board's port |
| `accent` | the board's colour, `#rrggbb` (the nearest of xterm's 256, or of the C64's) |
| `petscii` | `true` when the board has a C64 face |
| `enabled` | `false` keeps it out of the menu |

A new board of the network gets an entry here as part of the [new board](https://wiki.teletypegames.org/services/bbs-network) checklist; a push to master deploys it.

| Variable | Default |  |
|---|---|---|
| `TTG_GATE_BBS_GATEWAY_HOST` | `host.docker.internal` | where the boards are dialled |
| `TTG_GATE_BBS_PUBLIC_HOST` | `teletypegames.org` | the address shown with every board |
| `TTG_GATE_BBS_BOARDS` | `config/boards.yml` | the boards list |
| `TTG_GATE_BBS_DIAL_WINDOW` | `600` | Global Discovery: the window of the per-caller dial limit, seconds |
| `TTG_GATE_BBS_DIAL_PER_CALLER` | `10` | the dials one caller may make in the window |
| `TTG_GATE_BBS_DIAL_PER_HOST` | `3` | the lines from the gate to one host at once |

# Under the hood

The layers of the house standard: `BoardModel`, `BoardRepository` (the YAML file), `DirectoryService` and the composition root `TTGGateBBS`; the faces are `UI::Modern` (the chooser, the selector and the Discovery screens) and `UI::Petscii` (the frame with its tabs and sub-menu, and the views, drawn as changed cells only). Global Discovery lives in `lib/domain/discovery/`: the catalog is a SQLite file (`data/discovery.sqlite3`, WAL, FTS5) that the daily import and the prober (its own container, `ttg-gate-bbs-prober`) write, and the gate reads, but for the record of its dials (`BrowseService`, `DialService`). The gateway's report of a call comes from rubbs 0.31 (`Rubbs::Common::Line::Gateway::Report`). The numbers go to `data/discovery-metrics.prom` (`ttg_gate_bbs_discovery_*`, among them the dial limits, how near the callers and hosts are to them, the refused dials by reason, and the time and traffic of the dials) for Grafana. It runs as `boards/ttg-gate` 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-gate/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-gate` restarts only this board. Its log lines are in `docker logs ttg-bbs`, with `"board":"ttg-gate-bbs"`. It reaches the boards on their host ports (`host.docker.internal`). Those internal connections are exempt from the per-IP limits of `ttgvps security bbs-firewall` (the `vps-bbs-firewall` service), so every caller of the gate counts once.

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

## 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
- [TTG Mail BBS](https://wiki.teletypegames.org/services/bbs/ttg-mail-bbs) BBS boardsThe mail of the BBS network on a telnet line: letters between the accounts, read, answered and written on either face, plus the board's wall and a word to the sysops

'; 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 Blog BBS](https://wiki.teletypegames.org/services/bbs/ttg-blog-bbs.md)
- Next: [TTG Mail BBS](https://wiki.teletypegames.org/services/bbs/ttg-mail-bbs.md)
