Synchronet is a modern bulletin board software supporting classic terminal interfaces as well as modern web interfaces and other services.
The repository source is meant
to build/push to
bbsio/synchronet on Docker Hub.
For the @bbs/synchronet utility,
click here
:latest - The latest stable release version (3.18b)#, #.##, #.##x - Major, Minor, Patch options:nightly - The latest nightly:nightly-YYYYMMDD - Specific nightly (ex: nightly-20210222)Stick to bbsio/synchronet:3.19c if you are currently running a version prior
to 3.20 you should until this project is updated to work through issues
regarding the 3.20 migration scripts. They don't seem to like /sbbs/ctrl as
a symbolic link inside the container.
See updates document for more information.
If you are running Windows, it is recommended that you first install WSL2, then
Docker Desktop, configured for WSL2 and doing your volume mounts from inside
WSL2 (such as with Ubuntu). VS Code with WSL Remote extension will make editing
much easier to work with. Note: you can access your WSL2 instances in explorer
via \\wsl$. You may want to add your SBBS volume directory to your Quick
access shortcuts.
For your first run, you may want to run the Synchronet Configuration Program (scfg) before you proceed to start any services.
mkdir -p ~/sbbs
cd ~/sbbs
docker run --rm -it -v "$PWD:/sbbs-data" bbsio/synchronet:latest scfgThis will create your sbbs storage directory inside your profile, and run the
synchronet configuration program with that directory connected. This container
is setup so that the data directories are initialized on first run of (scfg or
sbbs) if necessary.
The easiest way to get running is with docker-compose.
mkdir -p ~/sbbs
cd ~/sbbs
wget -O docker-compose.yml https://raw.githubusercontent.com/bbs-io/synchronet-docker/master/docker-compose.yml
docker-compose up -d
sudo chmod -R a+rwX ./*To shutdown:
docker-compose downTo get a bash prompt inside the running container:
docker exec -it sbbs bashIf you are wanting to edit/update files, you may want to run the following on your common shared path, as files are created as root within the container.
sudo chmod a+rwX ~/sbbsor
docker exec -it sbbs sbbs-accessIn order to better support portability, you should mount your storage directory
to /sbbs-data/ inside the running container. Most directories will be
populated on first run.
Under your /sbbs-data/ directory, the following directories will be populated.
backup/defaults/ - will be initialized with the default build for synchronet
on first run, or upgrade.ctrl/ - note: text.dat will be overwritten on updated versions.data/ - Synchronet's default data storage directory, includes file
directories.text/web/ - default populated from /backup/defaults/web-ecweb4data/fido/xtrn/ - external programs, will populate directories that don't exist on
first run or updatemods/ - your customizations, empty by defaultnodes/node{n} - shared nodes directory (mapped to /sbbs/node{n}
internally).WARNING: If you are bringing in a configuration from outside this project,
you should make sure your ctrl/sbbs.ini is NOT binding to IPv6 addresses,
this will likely cause problems running in the container.
Synchronet is preconfigured for the following services/ports, see
/sbbs/ctrl/sbbs.ini and /sbbs/ctrl/services.ini for additional
configuration.
80 - http443 - https1123 - ws-term - used for ftelnet virtual terminal web connections11235 - wss-term - used for ftelnet virtual terminal web connections21 - ftp22- ssh23 - telnet513- rlogin64 - petscii 40-column128 - petscii 128-column25 - smtp-mail587 - smtp-submit465 - smtp-submit+tls110 - pop3995 - pop3+tls119 - nntp563 - nntps18 - message send prot11 - active user svc17 - qotd79 - finger6667 - ircOther services/ports that may be enabled:
5500 - hotline5501 - hotline-trans24554 - binkp24553 - binkps143 - imap993 - imap+tls6697 - irc+tlsThis project is ISC Licensed, Synchronet itself is mostly GPL.