Fidian

Debian Fido Autoinstaller

Warning!

This has only been tested under laboratory conditions. While it should work, don't blame me, if it blows up your cat.. 😉

If you run into any problems, please feel free to contact me.


Installs and configures

  • BinkD
    The Mailer Daemon sending and receiving your mail.
  • Husky Suite
    Tosser, Ticker, etc to handle incoming and outgoing mail.
  • GoldED+
    The editor for reading and writing mail.
  • TTYd
    Access GoldED+ with your webbrowser. (docker only, for now)

Supported OS:

  • Debian GNU/Linux 10+
  • RaspberryPi OS (Raspbian) 10+

Installation

Fidian can be installed in three different ways:


Manual Installation (existing Debian/Raspbian system)

Fidian installation instructions


Download and run as root: 

  wget https://fido.de/fidosetup.sh
  sudo bash fidosetup.sh
  rm 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.


Headless installation

For non-interactive installation, provide a file fidoconfig.txt at the same directory, your fidosetup.sh is located.

Please use this example as a template and change it according to your configuration.


Raspberry Pi Image

You can download a Raspberry Pi SD-Card Image based on the standard Raspbian Image.
This will automatically download and start fidian setup when you first login as the default user "pi" via console or SSH.

Nothing else is done. It's a completely fresh Raspbian installation. So, the following steps are strongly adviced:

  1. Run sudo raspi-config to change the password for user "pi", setup your localisation options and most important: Expand your filesystem! (at the "Advanced Options" submenu)
  2. Update your Raspbian base system:
    sudo apt update
    sudo apt upgrade
  3. You could also think about further securing the SSH server, silencing syslog to safe your SD-Card, setting up dyndns and portforwarding, so you can receive crashmail, but that's beyond the scope of this manual..

Docker Container

You can install Fidian as a docker container, too:


Docker installation:
    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 LINK_NAME="FidoNet" \
      -e LINK_DOMAIN="fidonet" \
      -e YOUR_NAME="John Doe" \
      -e YOUR_AKA="0:0/0.0" \
      -e YOUR_SYSTEM="Fidian" \
      -e YOUR_LOCATION="Trancentral" \
      -e YOUR_HOSTNAME="fidian" \
      -e UPLINK_HOST="example.com" \
      -e UPLINK_PORT="24554" \
      -e UPLINK_AKA="0:0/0" \
      -e SESSION_PASSWORD="SECRET123" \
      -e PACKET_PASSWORD="SECRET123" \
      -e AREAFIX_PASSWORD="SECRET123" \
      -e FILEFIX_PASSWORD="SECRET123" \
      -e WEB_PASSWORD="SECRET123" \
      -e TZ="Europe/Berlin" \
      -p 24554:24554 \
      -p 24580:24580 \
      --name fidian \
    stimpy23/fidian:latest

See below for an explaination of the environment variables.

If you didn't set environment variables for configuration, the fidian setup wizard will start on your first login as user fido.

The default password for user fido is fidian.
Change it asap using the command passwd!


Use with webbrowser:

Point your web browser to the exposed port 24580.
eg: http://localhost:24580
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 via the internet! At least put a proxy with encryption and some real authorization in front of it.


Use via console:

Enter as user fido: 

docker exec -u fido -t -i fidian /bin/bash


Configuration Parameters:

LINK_NAME Free text identifier for this link.
eg: FidoNet
LINK_DOMAIN Domain identifier (used internally to distinguish different links)
While this is technically free text, but you should still use the standards provided by your uplink.
eg: fidonet
YOUR_NAME Your full first- and last name.
eg: John Doe
YOUR_AKA Your AKA, assigned by your uplink.
eg: 2:240/5853.5
YOUR_SYSTEM Free text to identify your system. Commonly used for the name of your BBS or just your name.
eg: Johnny's Fido System
YOUR_LOCATION Free text to identify your location.
You're kindly asked to use a format like this: City, country.
eg: Frankfurt, germany
YOUR_HOSTNAME If your system is reachable from the internet, please enter your FQDN here.
If it isn't, please enter your hostname here (what you get, when running "hostname")
eg: your.domain.com
UPLINK_HOST The FQDN or IP of your uplink.
eg: his.domain.com
UPLINK_PORT Port number of uplink's binkd. (Leave empty for default)
eg: 24554
UPLINK_AKA The AKA of your uplink.
eg: 2:240/5853
SESSION_PASSWORD The session- / binkp password provided by your uplink.
eg: SECRET123
PACKET_PASSWORD The packet password password provided by your uplink. (Leave empty to use SESSION_PASSWORD)
eg: SECRET123
AREAFIX_PASSWORD The areafix password provided by your uplink. (Leave empty to use PACKET_PASSWORD)
eg: SECRET123
FILEFIX_PASSWORD The filefix password provided by your uplink. (Leave empty to use AREAFIX_PASSWORD)
eg: SECRET123

MIT License

Copyright (C) 2023 Philipp Giebel <stimpy {ÄT} kuehlbox.wtf>

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


Download

Download Fidian installscript (beta)

Download RaspberryPi Image (Bullseye 2021-10-30) Download RaspberryPi Image (Buster 2020-02-13)

Docker Container 

git clone https://gitlab.ambhost.net/stimpy/scripts_fidian.git


Contents