Fidian is a Fido Autoinstaller for Debian, RaspberryPi OS and Docker.
Fidian can be installed in three different ways:
Download and run as root:
sudo bash fidosetup.sh
This will guide you through the interactive installation process.
You will be asked a few questions, you'll need to answer - all the rest is done automatically.
There are possible parameters. Please see below for details.
For non-interactive installation, provide a file
at the same directory, your
fidosetup.sh is located.
Please use this example as a template and change it according to your configuration.
You can install Fidian as a docker container, too. Just add the parameter
"docker" to your fidosetup.sh call:
sudo bash fidosetup.sh --docker
This will start the same interactive installation process as described under
"Manual Installation" but runs a docker container in
There are more possible parameters. Please see below for details.
You can also install the docker image manually if you prefer. This may make sense when automating stuff:
docker run -d \
-v /etc/binkd:/etc/binkd \
-v /etc/husky:/etc/husky \
-v /var/spool/ftn:/var/spool/ftn \
-v /var/log/fidian:/var/log/fidian \
-e YOUR_SYSTEM="Fidian" \
-e YOUR_LOCATION="Frankfurt, germany" \
-e YOUR_HOSTNAME="johnny.kennmer.net" \
-e ENABLE_TTYD="1" \
-e WEB_PASSWORD="fidian" \
-e LINK_NAME_1="FidoNet" \
-e LINK_DOMAIN_1="fidonet" \
-e YOUR_NAME_1="John Doe" \
-e YOUR_AKA_1="0:0/0.0" \
-e UPLINK_HOST_1="example.com" \
-e UPLINK_PORT_1="24554" \
-e UPLINK_AKA_1="0:0/0" \
-e SESSION_PASSWORD_1="SECRET123" \
-e PACKET_PASSWORD 1="SECRET123" \
-e AREAFIX_PASSWORD_1="SECRET123" \
-e FILEFIX_PASSWORD_1="SECRET123" \
-e TZ="Europe/Berlin" \
-p 24554:24554 \
-p 24580:24580 \
--name fidian \
See below for an explanation of the environment variables.
The default password for user fido is fidian.
Change it asap using the command
Configuration is done via
This give you the possibility to setup and tweak all the configuration parameters available in an interactive dialog.
All the relevant daemons and tools are automatically reconfigured afterwards.
If you really have to, you'll find the configuration file at:
Fidian will now start to send and receive mail to and from your
configured uplink(s) automatically.
However, you may want to interact in one way or another. Fundamentally there are two ways: Via Commandline or via Webinterface, if enabled during installation.
When enabled during installation you can access the webinterface with all the most important functions at the exposed address and port, eg:
Login with user "fido" and your WEB_PASSWORD (default: fidian)
This is intended for local use only! You really should not make this publicly available on the internet! At least put a proxy with encryption and some real authentication in front of it.
For full access to all the functions you'll need to login to the commandline either with a locally attached keyboard, via SSH or by entering the docker container - depending on how and where you installed Fidian:
docker exec -u fido -t -i fidian /bin/bash
Here's a list of most of the commands you may want to use:
A dashboard combining all the most important functions and options in a tmux and dialog based screen.
This is what you'll see at the webinterface, too.
Configuration tool for Fidian. Use it to add uplinks, update your configuration and Fidian itself.
GoldED Plus message editor.
Use this to read and post messages.
These were the most common commands you'll want to use. But there's more:
Send and receive all mail and files available.
This isn't needed normally. Everything is happening automatically but you can always run this to speed up things.
poll.sh | toss.sh | tick.sh | echoscan.sh | netscan.sh
Force poll, toss, tick, echoscan or netscan.
This isn't needed normally. Everything is happening automatically but you can always run these to debug or speed up things.
fidohelp.sh | fidolist.sh | fidosubscribe.sh | fidounsubscribe.sh
Use these scripts to communicate with your uplink's areafix.
They will create messages to areafix with the corresponding commands.
Add an existing LINK_NAME as first option to send the message to a Network other than LINK_NAME_1.
For fido(un)subscribe.sh every extra option is treated as an echo so (un)subscribe to/from.
fidosubscribe.sh BBSnet kuehlbox_en blackice
This will send a message to your BBSnet uplink's areafix,
subscribing to the echos kuehlbox_en and blackice.
hpt | htick | nlupd | sqpack
These are just some of the more common tools coming with the
You do not need to use them directly - they're all
integrated with the Fidian scripts to run automatically or
If you want or need to use them anyway, please see the project pages for further documentation.
This is the tosser. It's running in the background as
a daemon but you can also run it with parameters, for example
for force polling an uplink as
Please see the man-page for further documentation.
Use this to update Fidian and re-generate all the configuration files.
You'll be asked to run this automatically after running fidoconfig.sh.
When running manually, there are a few command line parameters:
Install as Docker container
Override OS autodetection to debian
Override OS autodetection to raspbian / RaspberryPi OS
Don't ask any questions
Update only. No Re-Configuration
Don't install anything. Just pretend
Install current development snapshot
--add-docker-parameters -- (must be last parameter)
Additional parameters for docker run
--add-docker-parameters -- --network fido --ip 192.168.23.42
git clone https://gitlab.ambhost.net/scripts/fidian.git