Skip to main content
← Back to Documentation

TCP KISS Connection Guide

TCP KISS allows you to connect APRS Chat to a network-attached TNC or software modem like Dire Wolf. This is the preferred method for connecting to local RF networks.

Prerequisites

  • A TNC or software modem with TCP KISS support
  • Network connectivity between your device and the TNC
  • The IP address and port of your TNC's KISS interface

Common TCP KISS Sources

Dire Wolf

Popular software modem for Linux, Windows, and Raspberry Pi

Default settings:

  • Port: 8001
  • Protocol: KISS over TCP

Mobilinkd TNC

Hardware TNC with optional TCP KISS support via computer connection

Connection method:

Connect via computer running kiss-passthrough software

KISS-over-IP Hardware

Hardware TNCs with built-in Ethernet/WiFi

Configuration varies by device - check manufacturer documentation

Step-by-Step Setup

  1. 1. Verify Your TNC

    Ensure your TNC is running and the TCP KISS port is accessible. For Dire Wolf, check that the software is running and listening on port 8001.

  2. 2. Find the IP Address

    Determine the IP address of the computer or device running your TNC:

    • Same device: Use 127.0.0.1
    • Local network: Use the device's local IP (e.g., 192.168.1.100)

  3. 3. Configure APRS Chat

    Navigate to Settings → Connection → TCP KISS

    • Host: Enter the IP address
    • Port: Enter the KISS port (usually 8001)

  4. 4. Connect

    Tap Connect. The app will establish a TCP connection to your TNC.

Dire Wolf Configuration

Add these lines to your direwolf.conf to enable TCP KISS: 

# Enable TCP KISS interface
KISSPORT 8001

# Allow connections from local network
KISSCLIENT 0.0.0.0:8001

Troubleshooting

  • Connection refused:
    • Verify the TNC is running and the port is correct
    • Check firewall settings on the TNC host
  • Connection timeout:
    • Verify you're on the same network as the TNC
    • Try using the hostname instead of IP (or vice versa)
  • Connected but no data:
    • Check that your radio is properly connected to the TNC
    • Verify the TNC is receiving audio from the radio

Still having issues? Submit a support ticket