Skip to content

AIS-catcher-control

AIS-catcher-control is a separate package for Raspberry Pi and Debian-based systems that starts and stops the AIS-catcher process and manages the host from the browser. Configuration of the receiver itself is done in AIS-catcher's own dashboard — AIS-catcher-control is the tool around it: service control, one-click updates and reboot.

Note

Earlier versions of AIS-catcher-control included full configuration menus (device, outputs, data flow). This functionality has been superseded by managed mode; AIS-catcher-control now focuses on controlling the process and the host. On other platforms the process is managed with the native tools instead — e.g. Docker containers via Docker itself.

Installation

First install AIS-catcher itself via the install script, then install AIS-catcher-control as a separate service:

sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/jvde-github/AIS-catcher-control/main/install_ais_catcher_control.sh)"

Accessing the Interface

Open your web browser and navigate to the machine's address on port 8110, for example: http://raspberrypi.local:8110

Default password

Log in with the default password admin — you will be asked to set your own password right after. Systems upgraded from an earlier installation keep their previously set password.

Controlling the Service

Navigate to Control to manage the AIS-catcher service:

  • Start/Stop the service.
  • Enable Auto-Start functionality.
  • Monitor the service status through the live log stream (colour-coded by level: error, warning, notice, info, debug).

image

System Management

The System section shows host information (load, memory, disk, AIS-catcher and Control versions) and lets you:

  • check for updates of both AIS-catcher and AIS-catcher-control;
  • start the update / install scripts and watch their progress live;
  • reboot the host or reset a failed service;
  • inspect the optional reboot watchdog status (enabled via the install script).