Configuration File

Configuration file

wfweb keeps its settings in an .ini file: ~/.config/wfweb/wfweb.conf on Linux, the platform equivalent on macOS and Windows, /data/wfweb/wfweb.conf in Docker. -s <file> points it elsewhere. You normally never edit it: it is created on first run and the web UI writes to it.

When to use -s

• Several instances, one per radio. Each needs its own file or they overwrite each other.
• Docker or systemd, where a fixed path such as /etc/wfweb/station.ini is easier to manage than a per-user location.
• Named profiles you switch between: home.ini, contest.ini, portable.ini.

wfweb -s ./my-profile.ini

writes a file with defaults on first run; configure from the web UI from then on.

-s does not take .rig files. Those are the CI-V dictionaries for each radio model, loaded automatically from the install's rigs/ directory for the rig wfweb detects.

Hand-writing a file

A fresh file may use a flat [Radio] section. wfweb reads it on the first run and moves it into a [Radios] array, which is what it reads from then on; after that, edit Radios\1\... rather than [Radio].

USB:

[General]
Manufacturer=0
WebServerPort=8080

[Radio]
RigCIVuInt=130
SerialPortRadio=auto
SerialPortBaud=115200

LAN:

[General]
Manufacturer=0

[LAN]
EnableLAN=true
IPAddress=192.168.1.100
ControlLANPort=50001
SerialLANPort=50002
AudioLANPort=50003
Username=admin
Password=

Leave SerialPortBaud out unless you need it: rigs with a slow CI-V port (19200 on the IC-7600 and others) are handled by the rig file and the auto-detect, and a hard-coded 115200 silently breaks them.

Keys

Key	Section	Description	Example
Manufacturer	[General] (or [Radio] on first run)	0 = Icom, 1 = Kenwood, 2 = Yaesu	0
WebServerPort	[General]	Web UI port; REST is the next port up; 0 disables the web server	8080
RigCIVuInt	[Radio] first run, then Radios\1	CI-V address, decimal; 0 = auto-detect	148
SerialPortRadio	[Radio] first run, then Radios\1	Serial port, or auto (first Icom found)	/dev/ttyUSB0
SerialPortBaud	[Radio] first run, then Radios\1	Baud rate	115200
AudioInput / AudioOutput	Radios\1	Server-side audio devices; default prefers a USB CODEC	hw:CARD=CODEC,DEV=0
EnableLAN, IPAddress, Username, Password, ControlLANPort, SerialLANPort, AudioLANPort	[LAN]	LAN rig (read only when EnableLAN=true)	see above
Callsign / Grid	[Station]	Station callsign and locator (also set from the gear dialog)	K1ABC / FN42
Macro1 … Macro10	[CW]	CW keyer macros, shared by every browser; [CALL] and [QSO] are filled in when sent	CQ CQ DE [CALL] [CALL] K
Logbook	[General]	ADIF logbook path; relative paths resolve next to the settings file	station.adi
SstvDir	[General]	SSTV gallery directory; relative paths resolve next to the settings file	sstv
Enabled / Target / Decodes	[RemoteLog]	Remote logging; see Logbook	true / 127.0.0.1:2237 / false

The LAN password is stored in the file as wfview stores it. Keep the file readable by the wfweb user only.