Deployment

This page covers prerequisites, host setup, and bring-up steps for toc-lp-kit.

---

🛠 Prerequisites

• Ubuntu 24.04 LTS (or similar Debian-based)
• Docker & Docker Compose installed
• USB port available for RTL-SDR v4
• SSH or local desktop access for GUI launch

---

🔧 Host Setup

1. Install Docker & Compose
   Execute: sudo apt update &&
   sudo apt install -y docker.io docker-compose

2. Enable PulseAudio Socket
   Execute: pactl load-module module-native-protocol-unix socket=/tmp/pulse/native &&
   mkdir -p /tmp/pulse && chmod 777 /tmp/pulse

3. Blacklist DVB Kernel Driver
   Execute: echo 'blacklist dvb_usb_rtl28xxu' | sudo tee /etc/modprobe.d/rtl.conf &&
   sudo reboot

---

🚀 Bringing Up Services

From the repository root (toc-lp-kit):

1. Build or Pull Containers
   docker-compose pull || docker-compose build

2. Start All Services
   docker-compose up -d

3. Verify Running Containers
   docker ps | grep toc_

4. Confirm Time Sync
   docker logs toc_timesync | grep 'System clock'

5. Launch JS8Call GUI

   • On the host’s desktop, click the JS8Call icon
   • Or run: js8call

---

Return to Home