Getting started with PakCatt

2023-03-05

PakCatt is a open source bulletin board (BBS), recently written from the ground up using modern technologies. It’s also an extensive framework for building your own applications and services that can be accessed over Packet Radio, APRS and the Internet.

If you’re in the Melbourne area you can connect to a running instance on 144.875MHz, callsign VK3AT-1. You can also send it APRS messages on 145.175MHz to the same callsign.

Here is an example of a typical PakCatt session, accessing the bulletin board:

Welcome to PakCatt! Type help to learn more :-)
You have 3 unread messages.

menu> board
Launching Bulletin Board
board> list 3

  No  Updated       Topic
  13  19 Nov 11:44  Contests
  2   04 Feb 08:27  Features & Ideas
  14  25 Feb 21:11  
14 threads

board> open 2

board/2 Features> list 3

  No  Posted        By     Size
  22  29 Jan 21:01  VK3AT  194B
Callsign change - If you're reading this then you already know. My
callsign has changed to VK3AT, and I've updated the BBS to listen
on VK3AT-1. Please let othe...

  23  31 Jan 22:18  VK3AT  312B
Big update for this BBS - I've added a TCP/IP interactive socket so
anyone can connect to it from anywhere on the Internet! This is
terrifying, because it's wid...

  24  04 Feb 08:24  VK3AT  517B
Hey all, check out the last command. Lots of stations! But I need
to explain - I've connected this BBS to @VK3LEs APRS iGate so
that it can send and receive APR...


25 posts in: Features & Ideas

board/2 Features> open 24

Hey all, check out the last command. Lots of stations! But I 
need to explain - I've connected this BBS to @VK3LEs APRS 
iGate so that it can send and receive APRS messages on the 
APRS frequency. This means it also hears stations on that 
frequency and will log them in the last log. You'll see 
the last column in the last log captures wthe channel on 
which the station was last heard - most are on APRS while 
others (like you reading this) will be on the BBS channel 
or the TCP/IP channel.
Hope that makes sense!
73, B

The bulletin board is just one of several applications. Other applications allow you to read personal mail, send APRS messages to remote stations, and do simple mathematics, for example:

menu> sqrt 12
Square root of 12 is 3.4641016151377544

Install and setup

Running PakCatt is easy:

Download the latest pakcatt-x.x.jar and application.yml files from the PakCatt repo on GitHub. Replace x.x with the latest release version. For release 0.4:

$ wget https://github.com/dotb/pakcatt/releases/download/release_0.4/pakcatt-0.4.jar
$ wget https://github.com/dotb/pakcatt/releases/download/release_0.4/application.yml

Install the Java Runtime Environment (JRE). Yes I know, don’t worry it’ll be painless! On a Debian / Ubuntu system this can be done using apt:
```
$ apt install default-jre
```

Edit the application.yml file to taste. At minimum you’ll want to change the mycall, TCP/IP and MongoDB configuration:

pakcatt:
 application:
     mycall: PAKCAT-1

network.tcp:
 enabled: true
 port: 7331
 callsign-regex: '[a-zA-Z]+[0-9][a-zA-Z]+-?[0-9]?'
 pre-welcome-message: Welcome to PakCatt!
 callsign-regex-fail-message: Sorry, your callsign could not be validated.

spring:
 ## Database configuration
 data.mongodb.database: pakcatt
 spring.data.mongodb.host: 127.0.0.1
 spring.data.mongodb.port: 27017

The bulletin board and mail apps need a database to store messages. PakCatt uses MongoDB as it’s persistence layer, which is also quick and easy to get running. On Debian / Ubuntu systems this can be done using apt, then run MongoDB and specify a folder to store your data:
```
$ apt install mongodb
$ mongodb --dbpath /home/mydir/pakcattdb
```

Now you can start PakCatt and then connect to it over TCP/IP to create posts and messages!

$ java -jar pakcatt-x.x.jar --spring.config.location=./application.yml
╔═══╗     ╔╗  ╔═══╗      ╔╗  ╔╗ 
║╔═╗║     ║║  ║╔═╗║     ╔╝╚╗╔╝╚╗
║╚═╝║╔══╗ ║║╔╗║║ ╚╝╔══╗ ╚╗╔╝╚╗╔╝
║╔══╝╚ ╗║ ║╚╝╝║║ ╔╗╚ ╗║  ║║  ║║ 
║║   ║╚╝╚╗║╔╗╗║╚═╝║║╚╝╚╗ ║╚╗ ║╚╗
╚╝   ╚═══╝╚╝╚╝╚═══╝╚═══╝ ╚═╝ ╚═╝
By VK3AT & VK3LE
2023-03-03 09:46:59.349 [         PakCattKt] 	 INFO: Starting PakCattKt v0.2 
on mufasa.utiku.io with PID 21435 (/tmp/pakcatt-0.2.jar started by bradley 
in /tmp)
2023-03-03 09:46:59.355 [         PakCattKt] 	 INFO: The following profiles 
are active: production
...

Connect via TCP/IP

To connect to PakCatt via TCP/IP, use your favorite terminal program such as telnet, Putty or netcat. Here I’ve used netcat:

$ nc localhost
Welcome to the VK3AT BBS, running the PakCatt software https://github.com/dotb/pakcatt. This BBS is connected to an RF network and you require a valid amateur radio licence to operate it. Please supply your callsign on the next line to get started!
VK3AT
Welcome to PakCatt! Type help to learn more :-)

menu> last VK3AT
VK3AT: Sunday, 23 April 2023, 17:05 via TCPClient

Connecting via radio

To use PakCatt over radio you need to connect it to a Terminal Node Controller (TNC) and transceiver radio. PakCatt can connect to TNCs that support the KISS protocol, through TCP/IP or a serial connection.

Using Dire Wolf

Dire Wolf is a software TNC that uses the sound-card in your computer to modulate/demodulate the tones that encode AX.25 packets. It’s a fantastic tool that’ll get you you onto packet radio without needing the older hardware type TNC. This guide doesn’t cover the Dire Wolf configuration but there are heaps of examples elsewhere.

Once Dire Wolf is set up, edit the application.yml file to point PakCatt at your Dire Wolf instance:

## TNC Configuration
  tnc:
    ## TCP/IP TNC connections
    tcp-connections:
      - channel-identifier: 'TCP TNC'
        ip-address: 127.0.0.1
        port: 8001

The example configuration above will connect to Dire Wolf running on localhost, on port 8001

Using an old skewl TNC

Fun fact - PakCatt’s name is a play on the old Pakratt Hardware TNC. If you’re into blinking lights, then this option is for you! Connect your hardware TNC to the computer running PakCatt. You’ll probably need a USB to Serial converter cable and in Linux should see the serial interface appear as something like /dev/ttyUSB0. Then configure PakCatt to connect to the serial port:

## TNC Configuration
  tnc:
    ## Serial port / TNC configuration
    serial-connections:
      - channel-identifier: 'Serial TNC'
        port-path: /dev/ttyUSB0
        port-baud: 9600