A web interface for ka9q-radio by John Melton G0ORX
git clone https://github.com/ka9q/ka9q-radio.git- detailed instructions are here: https://github.com/ka9q/ka9q-radio/blob/main/docs/INSTALL.md
The Onion framework requires GnuTLS and libgcrypto to compute the SHA1 checksum required by WebSockets. They can be installed as follows:
- on Ubuntu 22.04 (Jammy Jellyfish) and Ubuntu 24.04 (Noble Numbat):
sudo apt install libgnutls28-dev libgcrypt20-dev
- on Debian Stable (12, bookworm) and similar Linux distributions:
sudo apt install libgnutls28-dev libgcrypt-dev
- on RedHat, CentOS, Fedora and similar Linux distributions:
sudo dnf install gnutls-devel libgcrypt-devel
The Orion framework includes a lot of dependencies (like sqlite3, redis, etc) that are not needed just to run ka9q-web. The instructions below build the Onion framework with all the dependencies. See section 3A for instructions to build a lighter version of the Onion framework with only the few necessary dependencies.
git clone https://github.com/davidmoreno/onion
cd onion
mkdir build
cd build
cmake ..
Before going ahead with the next steps, do make sure that the output from 'cmake' contains the line:
-- SSL support is compiled in.
If you don't see it, please review the instructions about the prerequisites for the Onion framework in the previous section.
make
sudo make install
sudo ldconfig
These commands are almost identical to the ones in the section above except that all the unused features of the Onion framework are disabled to limit the number of dependencies and other packages.
git clone https://github.com/davidmoreno/onion
cd onion
mkdir build
cd build
cmake -DONION_USE_PAM=false -DONION_USE_PNG=false -DONION_USE_JPEG=false -DONION_USE_XML2=false -DONION_USE_SYSTEMD=false -DONION_USE_SQLITE3=false -DONION_USE_REDIS=false -DONION_USE_GC=false -DONION_USE_TESTS=false -DONION_EXAMPLES=false -DONION_USE_BINDINGS_CPP=false ..
Before going ahead with the next steps, do make sure that the output from 'cmake' contains the line:
-- SSL support is compiled in.
If you don't see it, please review the instructions about the prerequisites for the Onion framework in the previous section.
make
sudo make install
sudo ldconfig
- edit the first line of
Makefileto point to the directory where you built ka9q-radio - run:
make
sudo make install
sudo make install-config (it will install rx888-web.conf in /etc/radio)
- make sure ka9q-radio is running using the configuration rx888-web:
sudo systemctl start radiod@rx888-web
systemctl status radiod@rx888-web
Address any problem with radiod before going to the next step
- start ka9q-web
ka9q-web
Finally open a browser and connect locally to http://localhost:8081 , or from a remote browser to http://<your computer name/IP>:8081
NOTE: to start ka9q-web on a different ka9q-radio control address, the command line option is '-m', for instance:
ka9q-web -m hf.local
(C) 2023-2024 John Melton G0ORX - Licensed under the GNU GPL V3 (see LICENSE)