variables.md

Complete HamStack variable index

Generated by scripts/generate-variable-reference.py. Do not edit this file by hand.

This is the exhaustive index of hamstack_* variables currently declared by the tracked site example and role defaults. The hand-curated configuration reference and individual role READMEs explain the configuration model and higher-level behavior.

site/global

Variable	Default	Purpose
hamstack_cache_dir	/var/cache/hamstack	Directory for disposable HamStack caches.
hamstack_callsign	N0CALL	Default amateur-radio callsign for the deployment. Roles may override it when a service uses another callsign.
hamstack_config_dir	/etc/hamstack	Directory for HamStack-owned configuration and generated metadata.
hamstack_country_code	US	Two-letter country code used by roles that need regional defaults.
hamstack_data_dir	/var/lib/hamstack	Directory for persistent HamStack-owned data.
hamstack_event_name	``	Optional event or temporary deployment name shared by roles that display or log event context.
hamstack_grid_locator	``	Default Maidenhead grid locator for the deployment.
hamstack_latitude	null	Default station latitude in decimal degrees.
hamstack_locale	en_US.UTF-8	Default locale for managed hosts.
hamstack_log_dir	/var/log/hamstack	Directory for HamStack-owned logs when a role does not use an upstream-native log location.
hamstack_longitude	null	Default station longitude in decimal degrees.
hamstack_site_name	My HamStack	Human-readable name for this HamStack deployment.
hamstack_timezone	Etc/UTC	IANA timezone name for managed hosts.

common

Variable	Default	Purpose
hamstack_cache_dir	/var/cache/hamstack	Directory for disposable HamStack caches.
hamstack_callsign	N0CALL	Default amateur-radio callsign for the deployment. Roles may override it when a service uses another callsign.
hamstack_common_apt_cache_valid_time	3600	Seconds an existing apt cache is considered fresh on Debian-family systems.
hamstack_common_extra_packages	[]	Additional site- or host-specific packages to install with the baseline.
hamstack_common_manage_directories	true	Create the HamStack config/data/cache/log directories.
hamstack_common_manage_packages	true	Install and maintain the baseline package set.
hamstack_common_packages	[curl, git, htop, jq, rsync, tmux, unzip, vim, wget]	Baseline packages expected on HamStack-managed nodes.
hamstack_config_dir	/etc/hamstack	Directory for HamStack-owned configuration and generated metadata.
hamstack_country_code	US	Two-letter country code used by roles that need regional defaults.
hamstack_data_dir	/var/lib/hamstack	Directory for persistent HamStack-owned data.
hamstack_devices	{}	Registry of reusable hardware devices attached to this host. Device resources may be consumed by multiple roles.
hamstack_event_name	``	Optional event or temporary deployment name shared by roles that display or log event context.
hamstack_grid_locator	``	Default Maidenhead grid locator for the deployment.
hamstack_hostname	{{ inventory_hostname }}	Desired hostname when hostname management is enabled.
hamstack_latitude	null	Default station latitude in decimal degrees.
hamstack_locale	en_US.UTF-8	Default locale for managed hosts.
hamstack_log_dir	/var/log/hamstack	Directory for HamStack-owned logs when a role does not use an upstream-native log location.
hamstack_longitude	null	Default station longitude in decimal degrees.
hamstack_manage_hostname	false	Whether the common role should manage the operating-system hostname.
hamstack_manage_locale	false	Whether the common role should configure the system locale. Reserved for the common-role implementation.
hamstack_manage_timezone	true	Whether the common role should configure the system timezone.
hamstack_operator_user	``	Linux login/session account used by desktop-oriented HamStack roles such as FLDIGI, FLRIG, WSJT-X, and QSSTV. Required when a role manages per-user autostart or configuration.
hamstack_radios	{}	Registry of radios available to this host. Radios may refer to entries in hamstack_devices and be consumed by multiple roles.
hamstack_site_name	HamStack	Human-readable name for this HamStack deployment.
hamstack_timezone	Etc/UTC	IANA timezone name for managed hosts.

desktop/chirp

Variable	Default	Purpose
hamstack_chirp_appimage_checksum	``	Configuration value for chirp appimage checksum; see the desktop/chirp role README for operational context.
hamstack_chirp_appimage_src	``	Configuration value for chirp appimage src; see the desktop/chirp role README for operational context.
hamstack_chirp_appimage_url	``	Configuration value for chirp appimage url; see the desktop/chirp role README for operational context.
hamstack_chirp_cache_dir	{{ (hamstack_cache_dir | default('/var/cache/hamstack')) ~ '/chirp' }}	Configuration value for chirp cache dir; see the desktop/chirp role README for operational context.
hamstack_chirp_desktop_entry	true	Configuration value for chirp desktop entry; see the desktop/chirp role README for operational context.
hamstack_chirp_enabled	false	Enable the desktop/chirp role/capability.
hamstack_chirp_http_agent	Mozilla/5.0	Configuration value for chirp http agent; see the desktop/chirp role README for operational context.
hamstack_chirp_install_dir	/opt/hamstack/chirp	Configuration value for chirp install dir; see the desktop/chirp role README for operational context.
hamstack_chirp_install_method	appimage	Configuration value for chirp install method; see the desktop/chirp role README for operational context.
hamstack_chirp_serial_groups	[dialout]	Configuration value for chirp serial groups; see the desktop/chirp role README for operational context.
hamstack_chirp_user	{{ hamstack_operator_user | default('') }}	Configuration value for chirp user; see the desktop/chirp role README for operational context.
hamstack_chirp_version	20260904	Requested upstream software version.
hamstack_chirp_wheel_checksum	``	Configuration value for chirp wheel checksum; see the desktop/chirp role README for operational context.
hamstack_chirp_wheel_url	https://archive.chirpmyradio.com/chirp_next/next-{{ hamstack_chirp_version }}/chirp-{{ hamstack_chirp_versi...	Configuration value for chirp wheel url; see the desktop/chirp role README for operational context.

desktop/hamstack-controller

Variable	Default	Purpose
hamstack_controller_enabled	false	Enable the desktop/hamstack-controller role/capability.
hamstack_controller_extra_packages	[]	Configuration value for controller extra packages; see the desktop/hamstack-controller role README for operational context.
hamstack_controller_install_collections	true	Configuration value for controller install collections; see the desktop/hamstack-controller role README for operational context.
hamstack_controller_install_packages	true	Configuration value for controller install packages; see the desktop/hamstack-controller role README for operational context.
hamstack_controller_install_python_requirements	true	Configuration value for controller install python requirements; see the desktop/hamstack-controller role README for operational context.
hamstack_controller_packages	[openssh-client, python3, python3-venv, python3-pip, curl, jq, rsync, unzip]	Configuration value for controller packages; see the desktop/hamstack-controller role README for operational context.
hamstack_controller_repo_path	``	Configuration value for controller repo path; see the desktop/hamstack-controller role README for operational context.
hamstack_controller_user	{{ hamstack_operator_user | default('') }}	Configuration value for controller user; see the desktop/hamstack-controller role README for operational context.
hamstack_controller_venv_dir	``	Configuration value for controller venv dir; see the desktop/hamstack-controller role README for operational context.

desktop/hamstack-dev

Variable	Default	Purpose
hamstack_dev_enabled	false	Enable the desktop/hamstack-dev role/capability.
hamstack_dev_extra_packages	[]	Configuration value for dev extra packages; see the desktop/hamstack-dev role README for operational context.
hamstack_dev_install_collections	true	Configuration value for dev install collections; see the desktop/hamstack-dev role README for operational context.
hamstack_dev_install_packages	true	Configuration value for dev install packages; see the desktop/hamstack-dev role README for operational context.
hamstack_dev_install_python_requirements	true	Configuration value for dev install python requirements; see the desktop/hamstack-dev role README for operational context.
hamstack_dev_packages	[git, openssh-client, python3, python3-venv, python3-pip, python3-dev, build-essential, curl, jq, rsync, ...	Configuration value for dev packages; see the desktop/hamstack-dev role README for operational context.
hamstack_dev_repo_path	``	Configuration value for dev repo path; see the desktop/hamstack-dev role README for operational context.
hamstack_dev_user	{{ hamstack_operator_user | default('') }}	Configuration value for dev user; see the desktop/hamstack-dev role README for operational context.
hamstack_dev_venv_dir	``	Configuration value for dev venv dir; see the desktop/hamstack-dev role README for operational context.

desktop/kiosk

Variable	Default	Purpose
hamstack_kiosk_autostart	true	Enable/start the managed service or desktop autostart entry.
hamstack_kiosk_browser_args	[--kiosk, --no-first-run, --disable-session-crashed-bubble, --disable-infobars]	Configuration value for kiosk browser args; see the desktop/kiosk role README for operational context.
hamstack_kiosk_browser_binary	/usr/bin/chromium	Configuration value for kiosk browser binary; see the desktop/kiosk role README for operational context.
hamstack_kiosk_browser_package	chromium	Configuration value for kiosk browser package; see the desktop/kiosk role README for operational context.
hamstack_kiosk_disable_blanking	true	Configuration value for kiosk disable blanking; see the desktop/kiosk role README for operational context.
hamstack_kiosk_enabled	false	Enable the desktop/kiosk role/capability.
hamstack_kiosk_extra_packages	[]	Configuration value for kiosk extra packages; see the desktop/kiosk role README for operational context.
hamstack_kiosk_hide_cursor	true	Configuration value for kiosk hide cursor; see the desktop/kiosk role README for operational context.
hamstack_kiosk_output	``	Configuration value for kiosk output; see the desktop/kiosk role README for operational context.
hamstack_kiosk_rotation	normal	Configuration value for kiosk rotation; see the desktop/kiosk role README for operational context.
hamstack_kiosk_url	https://127.0.0.1/	Configuration value for kiosk url; see the desktop/kiosk role README for operational context.
hamstack_kiosk_user	{{ hamstack_operator_user | default('') }}	Configuration value for kiosk user; see the desktop/kiosk role README for operational context.

desktop/netlogger

Variable	Default	Purpose
hamstack_netlogger_cache_dir	{{ (hamstack_cache_dir | default('/var/cache/hamstack')) ~ '/netlogger' }}	Configuration value for netlogger cache dir; see the desktop/netlogger role README for operational context.
hamstack_netlogger_enabled	false	Enable the desktop/netlogger role/capability.
hamstack_netlogger_extra_packages	[]	Configuration value for netlogger extra packages; see the desktop/netlogger role README for operational context.
hamstack_netlogger_package_checksum	``	Configuration value for netlogger package checksum; see the desktop/netlogger role README for operational context.
hamstack_netlogger_package_filename	netlogger.deb	Configuration value for netlogger package filename; see the desktop/netlogger role README for operational context.
hamstack_netlogger_package_src	``	Configuration value for netlogger package src; see the desktop/netlogger role README for operational context.
hamstack_netlogger_package_url	``	Explicit upstream package URL override.
hamstack_netlogger_user	{{ hamstack_operator_user | default('') }}	Configuration value for netlogger user; see the desktop/netlogger role README for operational context.

digital/fldigi

Variable	Default	Purpose
hamstack_fldigi_autostart	false	Start FLDIGI automatically in the supported session/service model.
hamstack_fldigi_callsign	{{ hamstack_callsign | default('N0CALL') }}	Callsign presented to FLDIGI.
hamstack_fldigi_config_dir	``	Override the upstream/default FLDIGI configuration directory.
hamstack_fldigi_enabled	false	Enable management of FLDIGI on this host.
hamstack_fldigi_extra_settings	{}	Escape hatch for supported FLDIGI settings not yet promoted to first-class variables.
hamstack_fldigi_grid_locator	{{ hamstack_grid_locator | default('') }}	Grid locator presented to FLDIGI.
hamstack_fldigi_install	true	Allow the role to install FLDIGI using its supported installation method.
hamstack_fldigi_interface	``	Optional device in hamstack_devices used directly for audio/PTT when not fully described by the radio resource.
hamstack_fldigi_radio	``	Name of a radio in hamstack_radios.
hamstack_fldigi_rig_control	none	Rig-control integration: none, flrig, or a supported direct-control backend.
hamstack_fldigi_xmlrpc_bind	127.0.0.1	Address for FLDIGI XML-RPC when enabled by the implementation.
hamstack_fldigi_xmlrpc_port	null	FLDIGI XML-RPC port. null means use the supported upstream/default value.

digital/flrig

Variable	Default	Purpose
hamstack_flrig_autostart	false	Start FLRIG automatically in the supported session/service model.
hamstack_flrig_config_dir	``	Override the upstream/default FLRIG configuration directory.
hamstack_flrig_enabled	false	Enable management of FLRIG on this host.
hamstack_flrig_extra_settings	{}	Escape hatch for supported FLRIG settings not yet promoted to first-class variables.
hamstack_flrig_install	true	Allow the role to install FLRIG using its supported installation method.
hamstack_flrig_interface	``	Optional device in hamstack_devices used for CAT/PTT when not fully described by the radio resource.
hamstack_flrig_radio	``	Name of a radio in hamstack_radios.
hamstack_flrig_rig_model	``	Optional upstream rig-model override when the model cannot be derived from hamstack_radios.
hamstack_flrig_serial_baud	null	Optional serial-speed override for CAT control.
hamstack_flrig_xmlrpc_bind	127.0.0.1	Address for the FLRIG XML-RPC service.
hamstack_flrig_xmlrpc_port	null	FLRIG XML-RPC port. null means use the supported upstream/default value.

digital/ft8web

Variable	Default	Purpose
hamstack_ft8web_autostart	true	Enable/start the managed service or desktop autostart entry.
hamstack_ft8web_caddy_image	caddy:2-alpine	Container image used by this role.
hamstack_ft8web_data_dir	{{ (hamstack_data_dir | default('/var/lib/hamstack')) ~ '/ft8web' }}	Persistent data directory used by this role.
hamstack_ft8web_enabled	false	Enable the digital/ft8web role/capability.
hamstack_ft8web_https_bind	0.0.0.0	Configuration value for ft8web https bind; see the digital/ft8web role README for operational context.
hamstack_ft8web_https_port	8448	Network port used by this setting.
hamstack_ft8web_nginx_image	nginx:alpine	Container image used by this role.
hamstack_ft8web_refresh	true	Configuration value for ft8web refresh; see the digital/ft8web role README for operational context.
hamstack_ft8web_refresh_interval	6h	Configuration value for ft8web refresh interval; see the digital/ft8web role README for operational context.
hamstack_ft8web_source_url	https://ft8web.ok1cdj.com/	Configuration value for ft8web source url; see the digital/ft8web role README for operational context.
hamstack_ft8web_tls_extra_names	[]	Configuration value for ft8web tls extra names; see the digital/ft8web role README for operational context.
hamstack_ft8web_tls_host	{{ inventory_hostname }}	Configuration value for ft8web tls host; see the digital/ft8web role README for operational context.

digital/js8call

Variable	Default	Purpose
hamstack_js8call_aarch64_checksum	sha256:003b7e6f41abc702710051e648d3c673110fe31e8f275bbfa9508f560672b8a4	Configuration value for js8call aarch64 checksum; see the digital/js8call role README for operational context.
hamstack_js8call_aarch64_url	https://github.com/JS8Call-improved/JS8Call-improved/releases/download/v{{ hamstack_js8call_version }}/JS8C...	Configuration value for js8call aarch64 url; see the digital/js8call role README for operational context.
hamstack_js8call_autostart	false	Enable/start the managed service or desktop autostart entry.
hamstack_js8call_enabled	false	Enable the digital/js8call role/capability.
hamstack_js8call_extra_args	[]	Configuration value for js8call extra args; see the digital/js8call role README for operational context.
hamstack_js8call_install_dir	/opt/hamstack/js8call	Configuration value for js8call install dir; see the digital/js8call role README for operational context.
hamstack_js8call_require_checksum	true	Configuration value for js8call require checksum; see the digital/js8call role README for operational context.
hamstack_js8call_user	{{ hamstack_operator_user | default('') }}	Configuration value for js8call user; see the digital/js8call role README for operational context.
hamstack_js8call_version	3.0.3	Requested upstream software version.
hamstack_js8call_x86_64_checksum	sha256:3f89bd821f281c59a9384c08a3ad783ea3b9ac6abf319ce6c0d881c2ecc6e6cd	Configuration value for js8call x86 64 checksum; see the digital/js8call role README for operational context.
hamstack_js8call_x86_64_url	https://github.com/JS8Call-improved/JS8Call-improved/releases/download/v{{ hamstack_js8call_version }}/JS8C...	Configuration value for js8call x86 64 url; see the digital/js8call role README for operational context.

digital/multimon-ng

Variable	Default	Purpose
hamstack_multimon_ng_decoders	[POCSAG512, POCSAG1200, POCSAG2400]	Configuration value for multimon ng decoders; see the digital/multimon-ng role README for operational context.
hamstack_multimon_ng_enabled	false	Enable the digital/multimon-ng role/capability.
hamstack_multimon_ng_extra_args	[]	Configuration value for multimon ng extra args; see the digital/multimon-ng role README for operational context.
hamstack_multimon_ng_group	hamstack-multimon	Configuration value for multimon ng group; see the digital/multimon-ng role README for operational context.
hamstack_multimon_ng_input_type	raw	Configuration value for multimon ng input type; see the digital/multimon-ng role README for operational context.
hamstack_multimon_ng_install	true	Allow HamStack to install the upstream software.
hamstack_multimon_ng_manage_user	true	Configuration value for multimon ng manage user; see the digital/multimon-ng role README for operational context.
hamstack_multimon_ng_output_file	{{ (hamstack_log_dir | default('/var/log/hamstack')) ~ '/multimon-ng.log' }}	Configuration value for multimon ng output file; see the digital/multimon-ng role README for operational context.
hamstack_multimon_ng_service_enabled	false	Enable the digital/multimon-ng role/capability.
hamstack_multimon_ng_source_command	``	Configuration value for multimon ng source command; see the digital/multimon-ng role README for operational context.
hamstack_multimon_ng_user	hamstack-multimon	Configuration value for multimon ng user; see the digital/multimon-ng role README for operational context.
hamstack_multimon_ng_user_groups	[audio, plugdev]	Configuration value for multimon ng user groups; see the digital/multimon-ng role README for operational context.

digital/qsstv-runtime

Variable	Default	Purpose
hamstack_qsstv_binary	/opt/hamstack/qsstv/bin/qsstv	Configuration value for qsstv binary; see the digital/qsstv-runtime role README for operational context.
hamstack_qsstv_build_dir	/var/cache/hamstack/qsstv-build	Configuration value for qsstv build dir; see the digital/qsstv-runtime role README for operational context.
hamstack_qsstv_build_jobs	2	Configuration value for qsstv build jobs; see the digital/qsstv-runtime role README for operational context.
hamstack_qsstv_install_prefix	/opt/hamstack/qsstv	Configuration value for qsstv install prefix; see the digital/qsstv-runtime role README for operational context.
hamstack_qsstv_launcher	/usr/local/bin/qsstv	Configuration value for qsstv launcher; see the digital/qsstv-runtime role README for operational context.
hamstack_qsstv_remove_distro_package	true	Configuration value for qsstv remove distro package; see the digital/qsstv-runtime role README for operational context.
hamstack_qsstv_source_dir	/opt/hamstack/qsstv-source	Configuration value for qsstv source dir; see the digital/qsstv-runtime role README for operational context.
hamstack_qsstv_source_ref	main	Configuration value for qsstv source ref; see the digital/qsstv-runtime role README for operational context.
hamstack_qsstv_source_repo	https://github.com/HamRadioVillage/QSSTV.git	Configuration value for qsstv source repo; see the digital/qsstv-runtime role README for operational context.
hamstack_qsstv_update_source	true	Configuration value for qsstv update source; see the digital/qsstv-runtime role README for operational context.

digital/selfie_station

Variable	Default	Purpose
hamstack_selfie_station_autostart	true	Start the Selfie Station service automatically.
hamstack_selfie_station_callsign	{{ hamstack_callsign | default('N0CALL') }}	Callsign rendered into the Selfie Station output/overlay.
hamstack_selfie_station_camera_device	``	Camera from hamstack_devices.
hamstack_selfie_station_camera_height	1232	Camera still-capture height.
hamstack_selfie_station_camera_width	1640	Camera still-capture width.
hamstack_selfie_station_cw_enabled	true	Prefix SSTV audio with the software-generated CW station identifier.
hamstack_selfie_station_cw_tone_hz	700.0	CW identifier tone frequency.
hamstack_selfie_station_cw_wpm	15	CW identifier speed in words per minute.
hamstack_selfie_station_data_dir	{{ (hamstack_data_dir | default('/var/lib/hamstack')) ~ '/selfie_station' }}	Root for photos, generated SSTV images, and WAV files.
hamstack_selfie_station_enabled	false	Enable the SSTV Selfie Station workflow.
hamstack_selfie_station_event_name	{{ hamstack_event_name | default('') }}	Event name rendered into the output/overlay when desired.
hamstack_selfie_station_extra_settings	{}	Selfie Station settings not yet promoted to first-class variables.
hamstack_selfie_station_group	hamstack-selfie	Primary group of the service account.
hamstack_selfie_station_image_dir	{{ (hamstack_data_dir | default('/var/lib/hamstack')) ~ '/selfie_station' }}	Directory for captured/generated images.
hamstack_selfie_station_install_dir	/opt/hamstack/selfie_station	Application deployment directory.
hamstack_selfie_station_interface	``	Device from hamstack_devices used for audio/PTT when needed.
hamstack_selfie_station_manage_user	true	Create the service account/group as a nologin system user.
hamstack_selfie_station_overlay_template	de {{ hamstack_callsign | default('N0CALL') }}	Text/template used to build the image overlay.
hamstack_selfie_station_ptt_lead_seconds	0.3	Delay after keying PTT before audio playback.
hamstack_selfie_station_ptt_tail_seconds	0.2	Delay after playback before unkeying PTT.
hamstack_selfie_station_radio	``	Radio from hamstack_radios used for the transmit handoff when local.
hamstack_selfie_station_sample_rate	48000	Generated/transmitted audio sample rate.
hamstack_selfie_station_sstv_mode	``	SSTV mode used for transmission. Empty means use the supported application/default configuration.
hamstack_selfie_station_sstv_target	local	Target SSTV endpoint or integration mode, such as local or a named future remote endpoint.
hamstack_selfie_station_transmit_enabled	false	Allow the workflow to key the configured interface and transmit generated SSTV audio. New deployments begin in dry-run mode.
hamstack_selfie_station_trigger_device	``	Trigger/HID device from hamstack_devices.
hamstack_selfie_station_trigger_fallback_device	/dev/input/by-id/usb-PCsensor_FootSwitch-event-kbd	Fallback foot-pedal event device when no HID endpoint is supplied.
hamstack_selfie_station_trigger_key	KEY_B	Linux input-event key emitted by the trigger device.
hamstack_selfie_station_user	hamstack-selfie	Dedicated unprivileged Linux account that runs the headless Selfie Station service. Do not reuse the Ansible automation account.
hamstack_selfie_station_user_groups	[audio, dialout, video, input]	Supplementary groups granting camera, audio, AIOC serial, and trigger-device access.
hamstack_selfie_station_venv_dir	/opt/hamstack/selfie_station/venv	Python virtual environment used by the service.

digital/sstv-rx

Variable	Default	Purpose
hamstack_sstv_rx_backend	qsstv	SSTV decoder/display backend. The supported backend is the HRV QSSTV build.
hamstack_sstv_rx_blacklist_dvb	false	Optionally blacklist DVB RTL2832 drivers on a dedicated SDR appliance.
hamstack_sstv_rx_callsign	{{ hamstack_callsign | default('N0CALL') }}	Station callsign available to the SSTV workflow.
hamstack_sstv_rx_enabled	false	Enable the receive-only SSTV appliance.
hamstack_sstv_rx_extra_settings	{}	Reserved SSTV RX settings not yet promoted to first-class variables.
hamstack_sstv_rx_frequency_mhz	null	Initial GQRX receive frequency. Required when the role is enabled; later operator QSY state is preserved.
hamstack_sstv_rx_gqrx_autostart	true	Autostart GQRX in the selected desktop session.
hamstack_sstv_rx_gqrx_demod	Narrow FM	Initial GQRX demodulation mode.
hamstack_sstv_rx_gqrx_device	rtl=0	GQRX device string used when seeding a new appliance profile.
hamstack_sstv_rx_gqrx_sample_rate	2400000	Initial GQRX SDR sample rate.
hamstack_sstv_rx_image_dir	{{ (hamstack_data_dir | default('/var/lib/hamstack')) ~ '/sstv-rx' }}	Directory used for received SSTV images.
hamstack_sstv_rx_install	true	Install GQRX, RTL-SDR tooling, PulseAudio client tools, VOLK tools, and the shared HRV QSSTV runtime.
hamstack_sstv_rx_pulse_sink	hamstack_sstv	Named Pulse/PipeWire-Pulse sink used to route GQRX audio into QSSTV.
hamstack_sstv_rx_qsstv_autostart	true	Autostart QSSTV in the selected desktop session.
hamstack_sstv_rx_sdr_backend	gqrx	SDR receiver/tuner backend. The current appliance implementation uses GQRX.
hamstack_sstv_rx_user	{{ hamstack_operator_user | default('') }}	Desktop account that runs GQRX and QSSTV.

digital/sstv-workstation

Variable	Default	Purpose
hamstack_sstv_workstation_autostart	true	Autostart QSSTV in the selected desktop session.
hamstack_sstv_workstation_backend	qsstv	SSTV application backend. The supported backend is QSSTV.
hamstack_sstv_workstation_callsign	{{ hamstack_callsign | default('N0CALL') }}	Workstation callsign.
hamstack_sstv_workstation_default_mode	``	Default SSTV mode; empty leaves application behavior unchanged.
hamstack_sstv_workstation_enabled	false	Enable the interactive SSTV workstation.
hamstack_sstv_workstation_extra_settings	{}	Reserved workstation settings not yet promoted to first-class variables.
hamstack_sstv_workstation_image_dir	{{ (hamstack_data_dir | default('/var/lib/hamstack')) ~ '/sstv-workstation' }}	Workstation SSTV image directory.
hamstack_sstv_workstation_install	true	Build/install the shared HamRadioVillage QSSTV runtime.
hamstack_sstv_workstation_interface	``	Device from hamstack_devices; reserved for audio/PTT integration.
hamstack_sstv_workstation_radio	``	Radio from hamstack_radios; reserved for live radio/PTT integration.
hamstack_sstv_workstation_receive_enabled	true	Describe/enable the workstation receive workflow.
hamstack_sstv_workstation_receive_frequency_mhz	null	Receive-frequency metadata for the station.
hamstack_sstv_workstation_transmit_enabled	false	Describe/enable the transmit workflow; disabled by default.
hamstack_sstv_workstation_transmit_frequency_mhz	null	Transmit-frequency metadata for the station.
hamstack_sstv_workstation_user	{{ hamstack_operator_user | default('') }}	Desktop account that runs QSSTV.

digital/unipager

Variable	Default	Purpose
hamstack_unipager_autostart	false	Enable/start the managed service or desktop autostart entry.
hamstack_unipager_enabled	false	Enable the digital/unipager role/capability.
hamstack_unipager_install	true	Allow HamStack to install the upstream software.
hamstack_unipager_repo_key_url	https://hampager.de/debian/rwth-afu.key	Configuration value for unipager repo key url; see the digital/unipager role README for operational context.
hamstack_unipager_repo_suite	unipager	Configuration value for unipager repo suite; see the digital/unipager role README for operational context.
hamstack_unipager_repo_url	https://hampager.de/debian	Configuration value for unipager repo url; see the digital/unipager role README for operational context.
hamstack_unipager_service	unipager	Configuration value for unipager service; see the digital/unipager role README for operational context.
hamstack_unipager_web_port	8073	Network port used by this setting.
hamstack_unipager_websocket_port	8055	Network port used by this setting.

digital/wsjtx

Variable	Default	Purpose
hamstack_wsjtx_autostart	false	Start WSJT-X automatically in the supported session/service model.
hamstack_wsjtx_callsign	{{ hamstack_callsign | default('N0CALL') }}	Callsign presented to WSJT-X.
hamstack_wsjtx_config_dir	``	Override the upstream/default WSJT-X configuration directory.
hamstack_wsjtx_enabled	false	Enable management of WSJT-X on this host.
hamstack_wsjtx_extra_settings	{}	Escape hatch for supported WSJT-X settings not yet promoted to first-class variables.
hamstack_wsjtx_grid_locator	{{ hamstack_grid_locator | default('') }}	Grid locator presented to WSJT-X.
hamstack_wsjtx_install	true	Allow the role to install WSJT-X using its supported installation method.
hamstack_wsjtx_interface	``	Optional device in hamstack_devices used directly for audio/CAT/PTT.
hamstack_wsjtx_radio	``	Name of a radio in hamstack_radios.
hamstack_wsjtx_rig_control	flrig	Rig-control backend: flrig, direct, hamlib, or none as supported.
hamstack_wsjtx_udp_server_address	127.0.0.1	UDP destination used for WSJT-X status/decode messages.
hamstack_wsjtx_udp_server_port	2237	UDP port used for WSJT-X status/decode messages.

infrastructure/netboot

Variable	Default	Purpose
hamstack_netboot_autostart	true	Enable/start the managed service or desktop autostart entry.
hamstack_netboot_bind_address	0.0.0.0	Address on which the managed service binds.
hamstack_netboot_container_name	hamstack-netboot	Container name managed by this role.
hamstack_netboot_data_dir	{{ (hamstack_data_dir | default('/var/lib/hamstack')) ~ '/netboot' }}	Persistent data directory used by this role.
hamstack_netboot_enabled	false	Enable the infrastructure/netboot role/capability.
hamstack_netboot_entries	[]	Configuration value for netboot entries; see the infrastructure/netboot role README for operational context.
hamstack_netboot_http_port	8089	Network port used by this setting.
hamstack_netboot_image	nginx:alpine	Container image used by this role.
hamstack_netboot_menu_title	HamStack Netboot	Configuration value for netboot menu title; see the infrastructure/netboot role README for operational context.

infrastructure/technitium-dns

Variable	Default	Purpose
hamstack_technitium_dns_auto_address	``	Configuration value for technitium dns auto address; see the infrastructure/technitium-dns role README for operational context.
hamstack_technitium_dns_auto_service_records	true	Configuration value for technitium dns auto service records; see the infrastructure/technitium-dns role README for operational context.
hamstack_technitium_dns_autostart	true	Enable/start the managed service or desktop autostart entry.
hamstack_technitium_dns_bind_address	0.0.0.0	Address on which the managed service binds.
hamstack_technitium_dns_bootstrap_zone	true	Configuration value for technitium dns bootstrap zone; see the infrastructure/technitium-dns role README for operational context.
hamstack_technitium_dns_container_name	hamstack-technitium-dns	Container name managed by this role.
hamstack_technitium_dns_data_dir	{{ (hamstack_data_dir | default('/var/lib/hamstack')) ~ '/technitium-dns' }}	Persistent data directory used by this role.
hamstack_technitium_dns_default_ttl	300	Configuration value for technitium dns default ttl; see the infrastructure/technitium-dns role README for operational context.
hamstack_technitium_dns_default_zone	hamstack.home.arpa	Configuration value for technitium dns default zone; see the infrastructure/technitium-dns role README for operational context.
hamstack_technitium_dns_domain	dns.hamstack.home.arpa	Configuration value for technitium dns domain; see the infrastructure/technitium-dns role README for operational context.
hamstack_technitium_dns_enabled	false	Enable the infrastructure/technitium-dns role/capability.
hamstack_technitium_dns_extra_env	{}	Configuration value for technitium dns extra env; see the infrastructure/technitium-dns role README for operational context.
hamstack_technitium_dns_forwarder_protocol	Udp	Configuration value for technitium dns forwarder protocol; see the infrastructure/technitium-dns role README for operational context.
hamstack_technitium_dns_forwarders	[]	Configuration value for technitium dns forwarders; see the infrastructure/technitium-dns role README for operational context.
hamstack_technitium_dns_https_port	8447	Network port used by this setting.
hamstack_technitium_dns_image	technitium/dns-server:latest	Container image used by this role.
hamstack_technitium_dns_manage_zonefile	true	Configuration value for technitium dns manage zonefile; see the infrastructure/technitium-dns role README for operational context.
hamstack_technitium_dns_port	53	Network port used by this setting.
hamstack_technitium_dns_records	[]	Configuration value for technitium dns records; see the infrastructure/technitium-dns role README for operational context.
hamstack_technitium_dns_recursion	AllowOnlyForPrivateNetworks	Configuration value for technitium dns recursion; see the infrastructure/technitium-dns role README for operational context.
hamstack_technitium_dns_web_bind	0.0.0.0	Configuration value for technitium dns web bind; see the infrastructure/technitium-dns role README for operational context.
hamstack_technitium_dns_zonefile_dir	{{ hamstack_technitium_dns_data_dir }}/zonefiles	Configuration value for technitium dns zonefile dir; see the infrastructure/technitium-dns role README for operational context.
hamstack_technitium_dns_zonefile_path	{{ hamstack_technitium_dns_zonefile_dir }}/{{ hamstack_technitium_dns_default_zone }}.zone	Configuration value for technitium dns zonefile path; see the infrastructure/technitium-dns role README for operational context.

network/44connect

Variable	Default	Purpose
hamstack_44connect_address	``	Address assigned by 44Net Connect.
hamstack_44connect_allowed_ips	[44.0.0.0/9, 44.128.0.0/10]	Default split-tunnel WireGuard AllowedIPs.
hamstack_44connect_autostart	true	Enable/start wg-quick@<interface>.
hamstack_44connect_dns_servers	[]	Optional DNS entries from the tunnel config.
hamstack_44connect_enabled	false	Enable 44Net Connect on this host.
hamstack_44connect_extra_settings	{}	Reserved pass-through/extension settings not otherwise modeled.
hamstack_44connect_full_tunnel_allowed_ips	[0.0.0.0/0]	AllowedIPs used when split tunnel is explicitly disabled.
hamstack_44connect_interface_name	ham44	WireGuard interface/config name.
hamstack_44connect_mechanism	wireguard	Connection backend; the supported backend is WireGuard.
hamstack_44connect_mtu	null	Optional MTU from the downloaded tunnel.
hamstack_44connect_peer_endpoint	``	Peer endpoint in host:port form.
hamstack_44connect_peer_public_key	``	44Net Connect peer public key.
hamstack_44connect_persistent_keepalive	25	WireGuard PersistentKeepalive.
hamstack_44connect_preshared_key	{{ vault_hamstack_44connect_preshared_key | default('') }}	Optional WireGuard preshared key.
hamstack_44connect_private_key	{{ vault_hamstack_44connect_private_key | default('') }}	Runtime private key, normally sourced from Vault.
hamstack_44connect_restart_on_change	true	Restart an active tunnel when its config changes.
hamstack_44connect_routes	[]	Additional AllowedIPs/routes appended by the deployment.
hamstack_44connect_split_tunnel	true	Route only 44Net traffic through the tunnel.

network/aredn

Variable	Default	Purpose
hamstack_aredn_cache_dir	{{ (hamstack_cache_dir | default('/var/cache/hamstack')) ~ '/aredn' }}	Configuration value for aredn cache dir; see the network/aredn role README for operational context.
hamstack_aredn_enabled	false	Enable the network/aredn role/capability.
hamstack_aredn_gatus_enabled	true	Enable the network/aredn role/capability.
hamstack_aredn_include_link_info	true	Configuration value for aredn include link info; see the network/aredn role README for operational context.
hamstack_aredn_include_lqm	false	Configuration value for aredn include lqm; see the network/aredn role README for operational context.
hamstack_aredn_include_services	true	Configuration value for aredn include services; see the network/aredn role README for operational context.
hamstack_aredn_nodes	[]	Configuration value for aredn nodes; see the network/aredn role README for operational context.
hamstack_aredn_poll_enabled	true	Enable the network/aredn role/capability.
hamstack_aredn_poll_interval	2min	Configuration value for aredn poll interval; see the network/aredn role README for operational context.
hamstack_aredn_request_timeout	10	Configuration value for aredn request timeout; see the network/aredn role README for operational context.

network/openwrt

Variable	Default	Purpose
hamstack_network_apply_changes	true	Configuration value for network apply changes; see the network/openwrt role README for operational context.
hamstack_network_dns_servers	[]	Configuration value for network dns servers; see the network/openwrt role README for operational context.
hamstack_network_extra_settings	{}	Reserved pass-through/extension settings not otherwise modeled.
hamstack_network_firewall_zones	[]	OpenWrt simple firewall-zone definitions; RouterOS firewall remains a native-path configuration surface.
hamstack_network_hostname	``	Desired platform hostname.
hamstack_network_lans	[]	Common interface/address definitions; OpenWrt also consumes optional DHCP settings.
hamstack_network_model	``	Human-readable model.
hamstack_network_routes	[]	Static routes translated by both supported network backends.
hamstack_network_vendor	``	Vendor/family metadata such as glinet or mikrotik.
hamstack_network_wifi	[]	OpenWrt SSID/security definitions; RouterOS currently uses native-path escape hatches for Wi-Fi.
hamstack_openwrt_enabled	false	Enable the network/openwrt role/capability.
hamstack_role_target	network_device	Configuration value for role target; see the network/openwrt role README for operational context.

network/routeros

Variable	Default	Purpose
hamstack_network_dns_servers	[]	Configuration value for network dns servers; see the network/routeros role README for operational context.
hamstack_network_extra_settings	{}	Reserved pass-through/extension settings not otherwise modeled.
hamstack_network_firewall_zones	[]	OpenWrt simple firewall-zone definitions; RouterOS firewall remains a native-path configuration surface.
hamstack_network_hostname	``	Desired platform hostname.
hamstack_network_lans	[]	Common interface/address definitions; OpenWrt also consumes optional DHCP settings.
hamstack_network_model	``	Human-readable model.
hamstack_network_routes	[]	Static routes translated by both supported network backends.
hamstack_network_vendor	``	Vendor/family metadata such as glinet or mikrotik.
hamstack_network_wifi	[]	OpenWrt SSID/security definitions; RouterOS currently uses native-path escape hatches for Wi-Fi.
hamstack_role_target	network_device	Configuration value for role target; see the network/routeros role README for operational context.
hamstack_routeros_api_password	{{ ansible_password | default(vault_hamstack_routeros_password | default('')) }}	Configuration value for routeros api password; see the network/routeros role README for operational context.
hamstack_routeros_api_port	8729	Network port used by this setting.
hamstack_routeros_api_tls	true	Configuration value for routeros api tls; see the network/routeros role README for operational context.
hamstack_routeros_api_username	{{ ansible_user | default('admin') }}	Configuration value for routeros api username; see the network/routeros role README for operational context.
hamstack_routeros_api_validate_certs	true	Configuration value for routeros api validate certs; see the network/routeros role README for operational context.
hamstack_routeros_enabled	false	Enable the network/routeros role/capability.
hamstack_routeros_native_paths	[]	Configuration value for routeros native paths; see the network/routeros role README for operational context.

packet/aprs

Variable	Default	Purpose
hamstack_aprs_autostart	true	Enable/start the managed service or desktop autostart entry.
hamstack_aprs_backend	graywolf	APRS backend; the supported backend is Graywolf.
hamstack_aprs_beacon_comment	``	Desired beacon comment.
hamstack_aprs_beacon_enabled	false	Request managed position beaconing; guarded until identity-safe live CRUD behavior is validated.
hamstack_aprs_beacon_interval_seconds	1800	Desired beacon interval.
hamstack_aprs_beacon_latitude	{{ hamstack_latitude | default(none) }}	Latitude used by this role when location is required.
hamstack_aprs_beacon_longitude	{{ hamstack_longitude | default(none) }}	Longitude used by this role when location is required.
hamstack_aprs_beacon_send_path	rf	rf, both, or is_only.
hamstack_aprs_beacon_symbol	-	Configuration value for aprs beacon symbol; see the packet/aprs role README for operational context.
hamstack_aprs_beacon_symbol_table	/	Configuration value for aprs beacon symbol table; see the packet/aprs role README for operational context.
hamstack_aprs_beacon_use_gps	false	Use live GPS for the future managed beacon.
hamstack_aprs_callsign	{{ hamstack_callsign | default('N0CALL') }}	Base station callsign.
hamstack_aprs_digipeater_callsign	``	Optional separate digi callsign.
hamstack_aprs_digipeater_dedupe_window_seconds	30	Graywolf duplicate suppression window.
hamstack_aprs_digipeater_enabled	false	Enable Graywolf digipeater behavior.
hamstack_aprs_digipeater_rules	[]	Reserved managed rule set; guarded until identity-safe live CRUD behavior is validated.
hamstack_aprs_enabled	false	Enable APRS profile management.
hamstack_aprs_extra_settings	{}	Reserved pass-through/extension settings not otherwise modeled.
hamstack_aprs_frequency_mhz	null	Configuration value for aprs frequency mhz; see the packet/aprs role README for operational context.
hamstack_aprs_graywolf_api_url	{{ hamstack_graywolf_api_url | default('http://127.0.0.1:8080/api') }}	Graywolf management API base.
hamstack_aprs_graywolf_channel_id	null	Existing Graywolf RF channel ID.
hamstack_aprs_graywolf_manage_first_user	true	Configuration value for aprs graywolf manage first user; see the packet/aprs role README for operational context.
hamstack_aprs_graywolf_password	{{ hamstack_graywolf_password | default( vault_hamstack_graywolf_password | default(vault...	Configuration value for aprs graywolf password; see the packet/aprs role README for operational context.
hamstack_aprs_graywolf_username	{{ hamstack_graywolf_username | default('hamstack') }}	Configuration value for aprs graywolf username; see the packet/aprs role README for operational context.
hamstack_aprs_igate_enabled	false	Enable Graywolf APRS-IS iGate.
hamstack_aprs_igate_is_to_rf	false	Gate APRS-IS traffic back to RF; conservative default is off.
hamstack_aprs_igate_is_tx_via	``	Configuration value for aprs igate is tx via; see the packet/aprs role README for operational context.
hamstack_aprs_igate_port	14580	APRS-IS port.
hamstack_aprs_igate_rf_to_is	true	Gate received RF packets to APRS-IS when iGate is enabled.
hamstack_aprs_igate_server	rotate.aprs2.net	APRS-IS server.
hamstack_aprs_igate_server_filter	``	APRS-IS server-side filter.
hamstack_aprs_igate_tx_channel	null	Graywolf TX channel used for IS→RF.
hamstack_aprs_install	false	Allow HamStack to install the upstream software.
hamstack_aprs_interface	``	Configuration value for aprs interface; see the packet/aprs role README for operational context.
hamstack_aprs_path	[WIDE1-1]	Originated RF path reserved for beacon/rule work.
hamstack_aprs_radio	``	Configuration value for aprs radio; see the packet/aprs role README for operational context.
hamstack_aprs_simulation_mode	true	Keep Graywolf TX muted while validating a demo configuration.
hamstack_aprs_ssid	0	APRS SSID 0-15.

packet/enigma-bbs

Variable	Default	Purpose
hamstack_enigma_bbs_autostart	true	Enable/start the managed service or desktop autostart entry.
hamstack_enigma_bbs_caddy_image	caddy:2-alpine	Container image used by this role.
hamstack_enigma_bbs_config_dir	{{ (hamstack_config_dir | default('/etc/hamstack')) ~ '/enigma-bbs' }}	Configuration directory used by this role.
hamstack_enigma_bbs_container_name	hamstack-enigma-bbs	Container name managed by this role.
hamstack_enigma_bbs_data_dir	{{ (hamstack_data_dir | default('/var/lib/hamstack')) ~ '/enigma-bbs' }}	Persistent DB/log/filebase/mail/Caddy data.
hamstack_enigma_bbs_description	HamStack ENiGMA½ conference BBS	Board description.
hamstack_enigma_bbs_enabled	false	Enable ENiGMA BBS.
hamstack_enigma_bbs_extra_settings	{}	Reserved pass-through/extension settings not otherwise modeled.
hamstack_enigma_bbs_https_bind	0.0.0.0	Configuration value for enigma bbs https bind; see the packet/enigma-bbs role README for operational context.
hamstack_enigma_bbs_https_port	8445	Published Caddy HTTPS/WSS port.
hamstack_enigma_bbs_image	enigmabbs/enigma-bbs:latest	Official ENiGMA container image.
hamstack_enigma_bbs_install	true	Allow HamStack to install the upstream software.
hamstack_enigma_bbs_kiss_host	127.0.0.1	Configuration value for enigma bbs kiss host; see the packet/enigma-bbs role README for operational context.
hamstack_enigma_bbs_kiss_port	null	Network port used by this setting.
hamstack_enigma_bbs_packet_transport	none	Supported deployment is IP-only; a future value may represent Graywolf/KISS shim integration.
hamstack_enigma_bbs_ssh_bind	0.0.0.0	Configuration value for enigma bbs ssh bind; see the packet/enigma-bbs role README for operational context.
hamstack_enigma_bbs_ssh_port	8889	Published SSH port.
hamstack_enigma_bbs_sysop_callsign	{{ hamstack_callsign | default('N0CALL') }}	Callsign used by this role.
hamstack_enigma_bbs_system_name	{{ (hamstack_site_name | default('HamStack')) ~ ' BBS' }}	Board name.
hamstack_enigma_bbs_telnet_bind	0.0.0.0	Configuration value for enigma bbs telnet bind; see the packet/enigma-bbs role README for operational context.
hamstack_enigma_bbs_telnet_port	8888	Published Telnet port.
hamstack_enigma_bbs_tls_host	{{ inventory_hostname }}	Name/IP for Caddy internal certificate.
hamstack_enigma_bbs_websocket_internal_port	8890	Container-private plaintext WS port.

packet/graywolf

Variable	Default	Purpose
hamstack_graywolf_agw	{enabled: false, listen_address: 127.0.0.1, port: 8000, callsigns: '{{ hamstack_graywolf_callsign }}'}	Global AGWPE listener configuration.
hamstack_graywolf_api_url	http://127.0.0.1:8080/api	Graywolf management API base.
hamstack_graywolf_audio_devices	[]	Named input/output audio devices managed through Graywolf's API.
hamstack_graywolf_autostart	true	Enable/start the Graywolf systemd service.
hamstack_graywolf_callsign	{{ hamstack_callsign | default('N0CALL') }}	Station-wide Graywolf identity.
hamstack_graywolf_channels	[]	Named radio/modem channels, optional PTT, and optional KISS endpoints.
hamstack_graywolf_config_path	``	Configuration value for graywolf config path; see the packet/graywolf role README for operational context.
hamstack_graywolf_enabled	false	Enable Graywolf management on this host.
hamstack_graywolf_extra_settings	{}	Reserved settings not yet promoted to first-class variables.
hamstack_graywolf_install	true	Install the supported upstream Debian package.
hamstack_graywolf_manage_api	false	Converge Graywolf operational state through its REST API.
hamstack_graywolf_manage_first_user	true	Create the first Graywolf management user on an unconfigured node.
hamstack_graywolf_manage_station	true	Converge Graywolf's station callsign.
hamstack_graywolf_package_checksum	``	Optional sha256:<digest> verified before the package is installed.
hamstack_graywolf_package_url	``	Optional direct .deb URL (HTTPS), bypassing release discovery.
hamstack_graywolf_password	{{ vault_hamstack_graywolf_password | default(vault_hamstack_aprs_graywolf_password | default('')) }}	Management password; prefer vault_hamstack_graywolf_password.
hamstack_graywolf_username	hamstack	Management account used by automation.
hamstack_graywolf_version	latest	Release to install, or a pinned upstream version.

packet/linbpq

Variable	Default	Purpose
hamstack_linbpq_anonymous_enabled	false	Enable the packet/linbpq role/capability.
hamstack_linbpq_anonymous_password	pass	Configuration value for linbpq anonymous password; see the packet/linbpq role README for operational context.
hamstack_linbpq_anonymous_username	ANON	Configuration value for linbpq anonymous username; see the packet/linbpq role README for operational context.
hamstack_linbpq_applications	[]	Configuration value for linbpq applications; see the packet/linbpq role README for operational context.
hamstack_linbpq_autostart	true	Enable/start the managed service or desktop autostart entry.
hamstack_linbpq_bbs_alias	BBS	BBS alias.
hamstack_linbpq_bbs_application_command	BBS	Configuration value for linbpq bbs application command; see the packet/linbpq role README for operational context.
hamstack_linbpq_bbs_application_number	1	Configuration value for linbpq bbs application number; see the packet/linbpq role README for operational context.
hamstack_linbpq_bbs_application_quality	255	Configuration value for linbpq bbs application quality; see the packet/linbpq role README for operational context.
hamstack_linbpq_bbs_callsign	``	BBS application callsign.
hamstack_linbpq_bbs_enabled	true	Enable LinMail/BBS application.
hamstack_linbpq_bbs_ssid	null	Configuration value for linbpq bbs ssid; see the packet/linbpq role README for operational context.
hamstack_linbpq_beacon_interval	10	Configuration value for linbpq beacon interval; see the packet/linbpq role README for operational context.
hamstack_linbpq_beacon_text	``	Configuration value for linbpq beacon text; see the packet/linbpq role README for operational context.
hamstack_linbpq_binary_checksum	``	Optional sha256:<digest> of the binary, verified on download.
hamstack_linbpq_binary_path	/opt/linbpq/linbpq	Executable path.
hamstack_linbpq_binary_url	``	Compatible upstream binary URL (HTTPS) when install is enabled.
hamstack_linbpq_callsign_base	{{ hamstack_callsign | default('N0CALL') }}	Configuration value for linbpq callsign base; see the packet/linbpq role README for operational context.
hamstack_linbpq_config_path	{{ hamstack_linbpq_data_dir }}/bpq32.cfg	Configuration value for linbpq config path; see the packet/linbpq role README for operational context.
hamstack_linbpq_connect_text	``	Configuration value for linbpq connect text; see the packet/linbpq role README for operational context.
hamstack_linbpq_data_dir	{{ (hamstack_data_dir | default('/var/lib/hamstack')) ~ '/linbpq' }}	Persistent data directory used by this role.
hamstack_linbpq_disconnect_on_close	false	Configuration value for linbpq disconnect on close; see the packet/linbpq role README for operational context.
hamstack_linbpq_enabled	false	Enable LinBPQ node/BBS.
hamstack_linbpq_extra_settings	{}	Reserved pass-through/extension settings not otherwise modeled.
hamstack_linbpq_fbb_port	8011	FBB/transparent service port.
hamstack_linbpq_full_connect_text	true	Configuration value for linbpq full connect text; see the packet/linbpq role README for operational context.
hamstack_linbpq_id_interval	9	Configuration value for linbpq id interval; see the packet/linbpq role README for operational context.
hamstack_linbpq_id_message	``	Configuration value for linbpq id message; see the packet/linbpq role README for operational context.
hamstack_linbpq_info_message	``	Configuration value for linbpq info message; see the packet/linbpq role README for operational context.
hamstack_linbpq_install	false	Download an operator-selected upstream binary.
hamstack_linbpq_install_dir	/opt/linbpq	Configuration value for linbpq install dir; see the packet/linbpq role README for operational context.
hamstack_linbpq_ip_service_id	Telnet and Web Services	Configuration value for linbpq ip service id; see the packet/linbpq role README for operational context.
hamstack_linbpq_ip_service_portnum	20	Configuration value for linbpq ip service portnum; see the packet/linbpq role README for operational context.
hamstack_linbpq_ip_service_quality	0	Configuration value for linbpq ip service quality; see the packet/linbpq role README for operational context.
hamstack_linbpq_ipv4_enabled	true	Enable the packet/linbpq role/capability.
hamstack_linbpq_ipv6_enabled	false	Enable the packet/linbpq role/capability.
hamstack_linbpq_kiss_options	NOPARAMS	Configuration value for linbpq kiss options; see the packet/linbpq role README for operational context.
hamstack_linbpq_locator	{{ hamstack_grid_locator | default('') }}	Configuration value for linbpq locator; see the packet/linbpq role README for operational context.
hamstack_linbpq_login_prompt	callsign:	Configuration value for linbpq login prompt; see the packet/linbpq role README for operational context.
hamstack_linbpq_max_sessions	32	Configuration value for linbpq max sessions; see the packet/linbpq role README for operational context.
hamstack_linbpq_node_alias	``	NET/ROM node alias.
hamstack_linbpq_node_callsign	``	Node callsign.
hamstack_linbpq_node_options	{OBSINIT: 6, OBSMIN: 4, NODESINTERVAL: 30, L3TIMETOLIVE: 20, L4RETRIES: 3, L4TIMEOUT: 60, L4DELAY: 10, L4...	BPQ node/routing/timer settings.
hamstack_linbpq_node_ssid	null	Configuration value for linbpq node ssid; see the packet/linbpq role README for operational context.
hamstack_linbpq_password_prompt	password:	Configuration value for linbpq password prompt; see the packet/linbpq role README for operational context.
hamstack_linbpq_port_defaults	{kiss_host: 127.0.0.1, channel: A, fulldup: 0, quality: 192, persist: 64, slottime: 100, txdelay: 300, tx...	Configuration value for linbpq port defaults; see the packet/linbpq role README for operational context.
hamstack_linbpq_ports	[]	KISS-over-TCP RF ports, normally pointed at Graywolf loopback endpoints.
hamstack_linbpq_raw_config_append	``	Configuration value for linbpq raw config append; see the packet/linbpq role README for operational context.
hamstack_linbpq_secure_telnet	true	Configuration value for linbpq secure telnet; see the packet/linbpq role README for operational context.
hamstack_linbpq_service_user	linbpq	Configuration value for linbpq service user; see the packet/linbpq role README for operational context.
hamstack_linbpq_telnet_ctext	``	Configuration value for linbpq telnet ctext; see the packet/linbpq role README for operational context.
hamstack_linbpq_telnet_enabled	false	Enable Telnet/FBB service port.
hamstack_linbpq_telnet_logging	true	Configuration value for linbpq telnet logging; see the packet/linbpq role README for operational context.
hamstack_linbpq_telnet_port	8010	User Telnet port.
hamstack_linbpq_telnet_users	{{ vault_hamstack_linbpq_telnet_users | default([]) }}	SYSOP/user records rendered into BPQ config.
hamstack_linbpq_web_enabled	true	Enable the packet/linbpq role/capability.
hamstack_linbpq_web_port	8080	Web management port.

packet/winlink

Variable	Default	Purpose
hamstack_winlink_agwpe_addr	localhost:8000	Configuration value for winlink agwpe addr; see the packet/winlink role README for operational context.
hamstack_winlink_agwpe_radio_port	0	Network port used by this setting.
hamstack_winlink_ardop_addr	localhost:8515	Configuration value for winlink ardop addr; see the packet/winlink role README for operational context.
hamstack_winlink_ardop_ptt_control	false	Configuration value for winlink ardop ptt control; see the packet/winlink role README for operational context.
hamstack_winlink_ardop_rig	``	Configuration value for winlink ardop rig; see the packet/winlink role README for operational context.
hamstack_winlink_ax25_engine	linux	Configuration value for winlink ax25 engine; see the packet/winlink role README for operational context.
hamstack_winlink_ax25_port	wl2k	Network port used by this setting.
hamstack_winlink_callsign	{{ hamstack_callsign | default('N0CALL') }}	Callsign used by this role.
hamstack_winlink_connect_aliases	{telnet: 'telnet://{mycall}:CMSTelnet@cms.winlink.org:8772/wl2k'}	Configuration value for winlink connect aliases; see the packet/winlink role README for operational context.
hamstack_winlink_data_dir	{{ (hamstack_data_dir | default('/var/lib/hamstack')) ~ '/winlink' }}	Persistent data directory used by this role.
hamstack_winlink_enabled	false	Enable the packet/winlink role/capability.
hamstack_winlink_extra_config	{}	Configuration value for winlink extra config; see the packet/winlink role README for operational context.
hamstack_winlink_gatus_enabled	false	Enable the packet/winlink role/capability.
hamstack_winlink_gpsd_addr	localhost:2947	Configuration value for winlink gpsd addr; see the packet/winlink role README for operational context.
hamstack_winlink_gpsd_allow_forms	false	Configuration value for winlink gpsd allow forms; see the packet/winlink role README for operational context.
hamstack_winlink_gpsd_enable_http	false	Configuration value for winlink gpsd enable http; see the packet/winlink role README for operational context.
hamstack_winlink_group	hamstack-winlink	Configuration value for winlink group; see the packet/winlink role README for operational context.
hamstack_winlink_hamlib_rigs	{}	Configuration value for winlink hamlib rigs; see the packet/winlink role README for operational context.
hamstack_winlink_http_bind	127.0.0.1	Configuration value for winlink http bind; see the packet/winlink role README for operational context.
hamstack_winlink_http_port	8081	Network port used by this setting.
hamstack_winlink_listen	[]	Configuration value for winlink listen; see the packet/winlink role README for operational context.
hamstack_winlink_locator	{{ hamstack_grid_locator | default('') }}	Configuration value for winlink locator; see the packet/winlink role README for operational context.
hamstack_winlink_manage_user	true	Configuration value for winlink manage user; see the packet/winlink role README for operational context.
hamstack_winlink_motd	[HamStack Pat Winlink client]	Configuration value for winlink motd; see the packet/winlink role README for operational context.
hamstack_winlink_package_cache_dir	{{ (hamstack_cache_dir | default('/var/cache/hamstack')) ~ '/packages' }}	Configuration value for winlink package cache dir; see the packet/winlink role README for operational context.
hamstack_winlink_package_checksums	{amd64: 'sha256:3dec3c2f0802707e7789c6752e955f141365e14923cc5c6331ddb8af48663d32', arm64: 'sha256:15f19a5...	Configuration value for winlink package checksums; see the packet/winlink role README for operational context.
hamstack_winlink_require_checksum	true	Configuration value for winlink require checksum; see the packet/winlink role README for operational context.
hamstack_winlink_serial_tnc_baud	9600	Configuration value for winlink serial tnc baud; see the packet/winlink role README for operational context.
hamstack_winlink_serial_tnc_hbaud	1200	Configuration value for winlink serial tnc hbaud; see the packet/winlink role README for operational context.
hamstack_winlink_serial_tnc_path	/dev/ttyUSB0	Configuration value for winlink serial tnc path; see the packet/winlink role README for operational context.
hamstack_winlink_serial_tnc_type	kenwood	Configuration value for winlink serial tnc type; see the packet/winlink role README for operational context.
hamstack_winlink_service_codes	[PUBLIC]	Configuration value for winlink service codes; see the packet/winlink role README for operational context.
hamstack_winlink_service_enabled	true	Enable the packet/winlink role/capability.
hamstack_winlink_transports	[telnet]	Configuration value for winlink transports; see the packet/winlink role README for operational context.
hamstack_winlink_user	hamstack-winlink	Configuration value for winlink user; see the packet/winlink role README for operational context.
hamstack_winlink_varafm_addr	localhost:8300	Configuration value for winlink varafm addr; see the packet/winlink role README for operational context.
hamstack_winlink_varahf_addr	localhost:8300	Configuration value for winlink varahf addr; see the packet/winlink role README for operational context.
hamstack_winlink_varahf_bandwidth	2300	Configuration value for winlink varahf bandwidth; see the packet/winlink role README for operational context.
hamstack_winlink_version	1.0.0	Requested upstream software version.
hamstack_winlink_version_reporting_disabled	false	Configuration value for winlink version reporting disabled; see the packet/winlink role README for operational context.

services/blur-deck

Variable	Default	Purpose
hamstack_blur_deck_autostart	true	Enable/start the managed service or desktop autostart entry.
hamstack_blur_deck_dlna_friendly_name	HamStack Blur Deck	Configuration value for blur deck dlna friendly name; see the services/blur-deck role README for operational context.
hamstack_blur_deck_enabled	false	Enable the services/blur-deck role/capability.
hamstack_blur_deck_extra_config	{}	Configuration value for blur deck extra config; see the services/blur-deck role README for operational context.
hamstack_blur_deck_inotify	true	Configuration value for blur deck inotify; see the services/blur-deck role README for operational context.
hamstack_blur_deck_media_dir	{{ (hamstack_data_dir | default('/var/lib/hamstack')) ~ '/blur-deck' }}	Configuration value for blur deck media dir; see the services/blur-deck role README for operational context.
hamstack_blur_deck_media_filename	blurdeck.mp4	Configuration value for blur deck media filename; see the services/blur-deck role README for operational context.
hamstack_blur_deck_media_source	``	Configuration value for blur deck media source; see the services/blur-deck role README for operational context.
hamstack_blur_deck_network_interfaces	[]	Configuration value for blur deck network interfaces; see the services/blur-deck role README for operational context.

services/cloudlog

Variable	Default	Purpose
hamstack_cloudlog_autostart	true	Enable/start the managed service or desktop autostart entry.
hamstack_cloudlog_database_name	cloudlog	Configuration value for cloudlog database name; see the services/cloudlog role README for operational context.
hamstack_cloudlog_database_user	cloudlog	Configuration value for cloudlog database user; see the services/cloudlog role README for operational context.
hamstack_cloudlog_enabled	false	Enable the services/cloudlog role/capability.
hamstack_cloudlog_https_bind	0.0.0.0	Configuration value for cloudlog https bind; see the services/cloudlog role README for operational context.
hamstack_cloudlog_https_port	8452	Network port used by this setting.
hamstack_cloudlog_install_dir	/opt/cloudlog	Configuration value for cloudlog install dir; see the services/cloudlog role README for operational context.
hamstack_cloudlog_source_ref	master	Configuration value for cloudlog source ref; see the services/cloudlog role README for operational context.
hamstack_cloudlog_source_repo	https://github.com/magicbug/Cloudlog.git	Configuration value for cloudlog source repo; see the services/cloudlog role README for operational context.
hamstack_cloudlog_tls_common_name	{{ inventory_hostname }}	Configuration value for cloudlog tls common name; see the services/cloudlog role README for operational context.

services/conham-display

Variable	Default	Purpose
hamstack_conham_autostart	true	Enable/start the managed service or desktop autostart entry.
hamstack_conham_caddy_image	caddy:2-alpine	Container image used by this role.
hamstack_conham_data_dir	{{ (hamstack_data_dir | default('/var/lib/hamstack')) ~ '/conham-display' }}	Persistent data directory used by this role.
hamstack_conham_display_enabled	false	Enable the services/conham-display role/capability.
hamstack_conham_event_path	/dc	Configuration value for conham event path; see the services/conham-display role README for operational context.
hamstack_conham_https_bind	0.0.0.0	Configuration value for conham https bind; see the services/conham-display role README for operational context.
hamstack_conham_https_port	8446	Network port used by this setting.
hamstack_conham_refresh_minutes	15	Configuration value for conham refresh minutes; see the services/conham-display role README for operational context.
hamstack_conham_source_mode	mirror	Configuration value for conham source mode; see the services/conham-display role README for operational context.
hamstack_conham_source_url	https://conham.radio/	Configuration value for conham source url; see the services/conham-display role README for operational context.
hamstack_conham_tls_host	{{ inventory_hostname }}	Configuration value for conham tls host; see the services/conham-display role README for operational context.

services/dcdash

Variable	Default	Purpose
hamstack_dcdash_admin_username	admin	Configuration value for dcdash admin username; see the services/dcdash role README for operational context.
hamstack_dcdash_autostart	true	Enable/start the managed service or desktop autostart entry.
hamstack_dcdash_backup_dir	{{ hamstack_dcdash_install_dir }}/backups	Configuration value for dcdash backup dir; see the services/dcdash role README for operational context.
hamstack_dcdash_bind_address	0.0.0.0	Address on which the managed service binds.
hamstack_dcdash_cert_file	{{ hamstack_dcdash_install_dir }}/certs/cert.pem	Configuration value for dcdash cert file; see the services/dcdash role README for operational context.
hamstack_dcdash_db_path	{{ hamstack_dcdash_install_dir }}/scoreboard.db	Configuration value for dcdash db path; see the services/dcdash role README for operational context.
hamstack_dcdash_enabled	false	Enable the services/dcdash role/capability.
hamstack_dcdash_extra_environment	{}	Configuration value for dcdash extra environment; see the services/dcdash role README for operational context.
hamstack_dcdash_group	dcdash	Configuration value for dcdash group; see the services/dcdash role README for operational context.
hamstack_dcdash_install_dir	/opt/dcdash	Configuration value for dcdash install dir; see the services/dcdash role README for operational context.
hamstack_dcdash_key_file	{{ hamstack_dcdash_install_dir }}/certs/key.pem	Configuration value for dcdash key file; see the services/dcdash role README for operational context.
hamstack_dcdash_max_fox_rule_points	null	Configuration value for dcdash max fox rule points; see the services/dcdash role README for operational context.
hamstack_dcdash_port	8450	Network port used by this setting.
hamstack_dcdash_proxy_hops	1	Configuration value for dcdash proxy hops; see the services/dcdash role README for operational context.
hamstack_dcdash_reports_dir	{{ hamstack_dcdash_install_dir }}/reports	Configuration value for dcdash reports dir; see the services/dcdash role README for operational context.
hamstack_dcdash_reverse_proxy	false	Configuration value for dcdash reverse proxy; see the services/dcdash role README for operational context.
hamstack_dcdash_source_mode	git	Configuration value for dcdash source mode; see the services/dcdash role README for operational context.
hamstack_dcdash_source_ref	main	Configuration value for dcdash source ref; see the services/dcdash role README for operational context.
hamstack_dcdash_source_repo	``	Configuration value for dcdash source repo; see the services/dcdash role README for operational context.
hamstack_dcdash_user	dcdash	Configuration value for dcdash user; see the services/dcdash role README for operational context.

services/gatus

Variable	Default	Purpose
hamstack_gatus_auto_node_checks	true	Configuration value for gatus auto node checks; see the services/gatus role README for operational context.
hamstack_gatus_auto_service_checks	true	Configuration value for gatus auto service checks; see the services/gatus role README for operational context.
hamstack_gatus_autostart	true	Enable/start the managed service or desktop autostart entry.
hamstack_gatus_caddy_image	caddy:2-alpine	Container image used by this role.
hamstack_gatus_container_name	hamstack-gatus	Container name managed by this role.
hamstack_gatus_data_dir	{{ (hamstack_data_dir | default('/var/lib/hamstack')) ~ '/gatus' }}	Persistent data directory used by this role.
hamstack_gatus_enabled	false	Enable the services/gatus role/capability.
hamstack_gatus_endpoints	[]	Configuration value for gatus endpoints; see the services/gatus role README for operational context.
hamstack_gatus_extra_config	{}	Configuration value for gatus extra config; see the services/gatus role README for operational context.
hamstack_gatus_https_bind	0.0.0.0	Configuration value for gatus https bind; see the services/gatus role README for operational context.
hamstack_gatus_https_port	8443	Network port used by this setting.
hamstack_gatus_image	ghcr.io/twin/gatus:stable	Container image used by this role.
hamstack_gatus_include_self_check	true	Configuration value for gatus include self check; see the services/gatus role README for operational context.
hamstack_gatus_interval	30s	Configuration value for gatus interval; see the services/gatus role README for operational context.
hamstack_gatus_loopback_http_port	18080	Network port used by this setting.
hamstack_gatus_storage	sqlite	Configuration value for gatus storage; see the services/gatus role README for operational context.
hamstack_gatus_tls_host	{{ inventory_hostname }}	Configuration value for gatus tls host; see the services/gatus role README for operational context.

services/gps-time

Variable	Default	Purpose
hamstack_gps_time_allow_networks	[]	LANs allowed to query chronyd. Empty means localhost only.
hamstack_gps_time_device	``	GPS entry in hamstack_devices with endpoints.serial.
hamstack_gps_time_enabled	false	Enable GNSS-backed time service.
hamstack_gps_time_expose_location	false	Configuration value for gps time expose location; see the services/gps-time role README for operational context.
hamstack_gps_time_extra_settings	{}	Reserved pass-through/extension settings not otherwise modeled.
hamstack_gps_time_gpsd_enabled	true	Enable the services/gps-time role/capability.
hamstack_gps_time_makestep	true	Configuration value for gps time makestep; see the services/gps-time role README for operational context.
hamstack_gps_time_nmea_delay_seconds	0.1	NMEA serial delay estimate.
hamstack_gps_time_nmea_offset_seconds	0.5	NMEA timing offset for non-PPS timing.
hamstack_gps_time_nmea_refid	NMEA	Configuration value for gps time nmea refid; see the services/gps-time role README for operational context.
hamstack_gps_time_pps_device	``	PPS device override; otherwise use endpoints.pps.
hamstack_gps_time_pps_enabled	false	Use the receiver's PPS timing source.
hamstack_gps_time_pps_refid	PPS	Configuration value for gps time pps refid; see the services/gps-time role README for operational context.
hamstack_gps_time_refclock_mode	auto	auto, sock, or shm. Auto prefers gpsd SOCK for PPS and SHM for non-PPS compatibility.
hamstack_gps_time_refid	GPS	Chrony refclock identifier.
hamstack_gps_time_rtcsync	true	Configuration value for gps time rtcsync; see the services/gps-time role README for operational context.
hamstack_gps_time_time_sync_enabled	true	Enable the services/gps-time role/capability.
hamstack_gps_time_time_sync_provider	chrony	Configuration value for gps time time sync provider; see the services/gps-time role README for operational context.

services/meshtastic-dashboard

Variable	Default	Purpose
hamstack_meshtastic_dashboard_autostart	true	Enable/start the managed service or desktop autostart entry.
hamstack_meshtastic_dashboard_caddy_image	caddy:2-alpine	Container image used by this role.
hamstack_meshtastic_dashboard_container_name	hamstack-meshtastic-web	Container name managed by this role.
hamstack_meshtastic_dashboard_data_dir	{{ (hamstack_data_dir | default('/var/lib/hamstack')) ~ '/meshtastic-web' }}	Persistent data directory used by this role.
hamstack_meshtastic_dashboard_enabled	false	Enable the services/meshtastic-dashboard role/capability.
hamstack_meshtastic_dashboard_https_bind	0.0.0.0	Configuration value for meshtastic dashboard https bind; see the services/meshtastic-dashboard role README for operational context.
hamstack_meshtastic_dashboard_https_port	8451	Network port used by this setting.
hamstack_meshtastic_dashboard_image	ghcr.io/meshtastic/web:latest	Container image used by this role.
hamstack_meshtastic_dashboard_tls_host	{{ inventory_hostname }}	Configuration value for meshtastic dashboard tls host; see the services/meshtastic-dashboard role README for operational context.

services/wavelog

Variable	Default	Purpose
hamstack_wavelog_autostart	true	Enable/start the managed service or desktop autostart entry.
hamstack_wavelog_caddy_image	caddy:2-alpine	Container image used by this role.
hamstack_wavelog_data_dir	{{ (hamstack_data_dir | default('/var/lib/hamstack')) ~ '/wavelog' }}	Persistent data directory used by this role.
hamstack_wavelog_database_name	wavelog	Configuration value for wavelog database name; see the services/wavelog role README for operational context.
hamstack_wavelog_database_user	wavelog	Configuration value for wavelog database user; see the services/wavelog role README for operational context.
hamstack_wavelog_db_image	mariadb:11.8	Container image used by this role.
hamstack_wavelog_disable_cron	false	Configuration value for wavelog disable cron; see the services/wavelog role README for operational context.
hamstack_wavelog_enabled	false	Enable the services/wavelog role/capability.
hamstack_wavelog_environment	{}	Configuration value for wavelog environment; see the services/wavelog role README for operational context.
hamstack_wavelog_https_bind	0.0.0.0	Configuration value for wavelog https bind; see the services/wavelog role README for operational context.
hamstack_wavelog_https_port	8453	Network port used by this setting.
hamstack_wavelog_image	ghcr.io/wavelog/wavelog:latest	Container image used by this role.
hamstack_wavelog_tls_host	{{ inventory_hostname }}	Configuration value for wavelog tls host; see the services/wavelog role README for operational context.

visual/gridtracker

Variable	Default	Purpose
hamstack_gridtracker_autostart	false	Add XDG autostart for the operator user.
hamstack_gridtracker_base_url	https://download2.gridtracker.org	Configuration value for gridtracker base url; see the visual/gridtracker role README for operational context.
hamstack_gridtracker_callsign	{{ hamstack_callsign | default('N0CALL') }}	Callsign used by this role.
hamstack_gridtracker_config_dir	``	Configuration directory used by this role.
hamstack_gridtracker_download_page	https://gridtracker.org/index.php/downloads/gridtracker-downloads	Configuration value for gridtracker download page; see the visual/gridtracker role README for operational context.
hamstack_gridtracker_enabled	false	Enable GridTracker2.
hamstack_gridtracker_executable	/usr/bin/gridtracker2	Configuration value for gridtracker executable; see the visual/gridtracker role README for operational context.
hamstack_gridtracker_extra_settings	{}	Reserved pass-through/extension settings not otherwise modeled.
hamstack_gridtracker_grid_locator	{{ hamstack_grid_locator | default('') }}	Maidenhead grid locator used by this role.
hamstack_gridtracker_install	true	Install a Debian package.
hamstack_gridtracker_logging_backend	``	Configuration value for gridtracker logging backend; see the visual/gridtracker role README for operational context.
hamstack_gridtracker_logging_url	``	Configuration value for gridtracker logging url; see the visual/gridtracker role README for operational context.
hamstack_gridtracker_package_checksum	``	Optional sha256:<digest> verified before the package is installed.
hamstack_gridtracker_package_url	``	Explicit package override (HTTPS).
hamstack_gridtracker_version	2.260925.2	Tested default or another pinned upstream version.
hamstack_gridtracker_wsjtx_host	127.0.0.1	Reserved WSJT-X input host setting.
hamstack_gridtracker_wsjtx_port	2237	Reserved WSJT-X UDP port.

visual/openhamclock

Variable	Default	Purpose
hamstack_openhamclock_autostart	true	Enable/start the managed service or desktop autostart entry.
hamstack_openhamclock_caddy_image	caddy:2-alpine	TLS sidecar.
hamstack_openhamclock_callsign	{{ hamstack_callsign | default('N0CALL') }}	Callsign used by this role.
hamstack_openhamclock_container_name	hamstack-openhamclock	Container name managed by this role.
hamstack_openhamclock_data_dir	{{ (hamstack_data_dir | default('/var/lib/hamstack')) ~ '/openhamclock' }}	Persistent data directory used by this role.
hamstack_openhamclock_enabled	false	Enable OpenHamClock LAN service.
hamstack_openhamclock_environment	{}	Supported upstream container environment overrides.
hamstack_openhamclock_extra_settings	{}	Reserved pass-through/extension settings not otherwise modeled.
hamstack_openhamclock_grid_locator	{{ hamstack_grid_locator | default('') }}	Maidenhead grid locator used by this role.
hamstack_openhamclock_https_bind	0.0.0.0	Configuration value for openhamclock https bind; see the visual/openhamclock role README for operational context.
hamstack_openhamclock_https_port	8449	Only host-published application port.
hamstack_openhamclock_image	ghcr.io/accius/openhamclock:latest	Upstream application container.
hamstack_openhamclock_install	true	Allow HamStack to install the upstream software.
hamstack_openhamclock_latitude	{{ hamstack_latitude | default(none) }}	Latitude used by this role when location is required.
hamstack_openhamclock_longitude	{{ hamstack_longitude | default(none) }}	Longitude used by this role when location is required.
hamstack_openhamclock_tls_host	{{ inventory_hostname }}	Name/IP on Caddy internal certificate.

visual/openwebrx

Variable	Default	Purpose
hamstack_openwebrx_autostart	true	Enable/start the managed service or desktop autostart entry.
hamstack_openwebrx_caddy_image	caddy:2-alpine	Container image used by this role.
hamstack_openwebrx_callsign	{{ hamstack_callsign | default('N0CALL') }}	Callsign used by this role.
hamstack_openwebrx_container_name	hamstack-openwebrx	Container name managed by this role.
hamstack_openwebrx_data_dir	{{ (hamstack_data_dir | default('/var/lib/hamstack')) ~ '/openwebrx' }}	Persistent settings/Caddy data.
hamstack_openwebrx_device_mappings	[]	Explicit Docker SDR device mappings.
hamstack_openwebrx_enabled	false	Enable OpenWebRX LAN service.
hamstack_openwebrx_extra_settings	{}	Reserved pass-through/extension settings not otherwise modeled.
hamstack_openwebrx_grid_locator	{{ hamstack_grid_locator | default('') }}	Maidenhead grid locator used by this role.
hamstack_openwebrx_https_bind	0.0.0.0	Configuration value for openwebrx https bind; see the visual/openwebrx role README for operational context.
hamstack_openwebrx_https_port	8444	Only host-published application port.
hamstack_openwebrx_image	jketterl/openwebrx:stable	OpenWebRX container image.
hamstack_openwebrx_install	true	Allow HamStack to install the upstream software.
hamstack_openwebrx_receiver_device	``	Configuration value for openwebrx receiver device; see the visual/openwebrx role README for operational context.
hamstack_openwebrx_receiver_profiles	[]	Configuration value for openwebrx receiver profiles; see the visual/openwebrx role README for operational context.
hamstack_openwebrx_tls_host	{{ inventory_hostname }}	Name/IP on Caddy internal certificate.

voice/allstar

Variable	Default	Purpose
hamstack_allstar_allmon3_config	/etc/allmon3/allmon3.ini	Configuration value for allstar allmon3 config; see the voice/allstar role README for operational context.
hamstack_allstar_allmon3_manage	true	Configuration value for allstar allmon3 manage; see the voice/allstar role README for operational context.
hamstack_allstar_allmon3_service	allmon3	Configuration value for allstar allmon3 service; see the voice/allstar role README for operational context.
hamstack_allstar_autostart	true	Enable/start the managed service or desktop autostart entry.
hamstack_allstar_callsign	{{ hamstack_callsign | default('N0CALL') }}	Callsign used by this role.
hamstack_allstar_channel_driver	simpleusb	Configuration value for allstar channel driver; see the voice/allstar role README for operational context.
hamstack_allstar_config_dir	/etc/asterisk	Configuration directory used by this role.
hamstack_allstar_config_group	asterisk	Configuration value for allstar config group; see the voice/allstar role README for operational context.
hamstack_allstar_config_owner	asterisk	Configuration value for allstar config owner; see the voice/allstar role README for operational context.
hamstack_allstar_default_node_number	1999	Configuration value for allstar default node number; see the voice/allstar role README for operational context.
hamstack_allstar_duplex	null	Configuration value for allstar duplex; see the voice/allstar role README for operational context.
hamstack_allstar_enabled	false	Enable the voice/allstar role/capability.
hamstack_allstar_extra_settings	{}	Reserved pass-through/extension settings not otherwise modeled.
hamstack_allstar_id_recording	|i{{ hamstack_allstar_callsign }}	Configuration value for allstar id recording; see the voice/allstar role README for operational context.
hamstack_allstar_interface	``	Configuration value for allstar interface; see the voice/allstar role README for operational context.
hamstack_allstar_node_description	``	Configuration value for allstar node description; see the voice/allstar role README for operational context.
hamstack_allstar_node_location	{{ hamstack_grid_locator | default('') }}	Configuration value for allstar node location; see the voice/allstar role README for operational context.
hamstack_allstar_node_name	{{ inventory_hostname }}	Configuration value for allstar node name; see the voice/allstar role README for operational context.
hamstack_allstar_node_number	null	Configuration value for allstar node number; see the voice/allstar role README for operational context.
hamstack_allstar_radio	``	Configuration value for allstar radio; see the voice/allstar role README for operational context.
hamstack_allstar_register	false	Configuration value for allstar register; see the voice/allstar role README for operational context.
hamstack_allstar_registration_host	register.allstarlink.org	Configuration value for allstar registration host; see the voice/allstar role README for operational context.
hamstack_allstar_restart_on_change	true	Configuration value for allstar restart on change; see the voice/allstar role README for operational context.
hamstack_allstar_sa818_apply	true	Configuration value for allstar sa818 apply; see the voice/allstar role README for operational context.
hamstack_allstar_sa818_band	UHF	Configuration value for allstar sa818 band; see the voice/allstar role README for operational context.
hamstack_allstar_sa818_bandwidth	Wide	Configuration value for allstar sa818 bandwidth; see the voice/allstar role README for operational context.
hamstack_allstar_sa818_config	/etc/sa818.conf	Configuration value for allstar sa818 config; see the voice/allstar role README for operational context.
hamstack_allstar_sa818_ctcss_rx	None	Configuration value for allstar sa818 ctcss rx; see the voice/allstar role README for operational context.
hamstack_allstar_sa818_ctcss_tx	None	Configuration value for allstar sa818 ctcss tx; see the voice/allstar role README for operational context.
hamstack_allstar_sa818_dcs_rx	None	Configuration value for allstar sa818 dcs rx; see the voice/allstar role README for operational context.
hamstack_allstar_sa818_dcs_tx	None	Configuration value for allstar sa818 dcs tx; see the voice/allstar role README for operational context.
hamstack_allstar_sa818_emphasis	Disabled	Configuration value for allstar sa818 emphasis; see the voice/allstar role README for operational context.
hamstack_allstar_sa818_enabled	false	Enable the voice/allstar role/capability.
hamstack_allstar_sa818_high_pass	Disabled	Configuration value for allstar sa818 high pass; see the voice/allstar role README for operational context.
hamstack_allstar_sa818_low_pass	Disabled	Configuration value for allstar sa818 low pass; see the voice/allstar role README for operational context.
hamstack_allstar_sa818_port	``	Network port used by this setting.
hamstack_allstar_sa818_rx_frequency	null	Configuration value for allstar sa818 rx frequency; see the voice/allstar role README for operational context.
hamstack_allstar_sa818_speed	``	Configuration value for allstar sa818 speed; see the voice/allstar role README for operational context.
hamstack_allstar_sa818_squelch	1	Configuration value for allstar sa818 squelch; see the voice/allstar role README for operational context.
hamstack_allstar_sa818_tail_tone	Closed	Configuration value for allstar sa818 tail tone; see the voice/allstar role README for operational context.
hamstack_allstar_sa818_tone	None	Configuration value for allstar sa818 tone; see the voice/allstar role README for operational context.
hamstack_allstar_sa818_tx_frequency	{{ hamstack_allstar_sa818_rx_frequency }}	Configuration value for allstar sa818 tx frequency; see the voice/allstar role README for operational context.
hamstack_allstar_sa818_volume	1	Configuration value for allstar sa818 volume; see the voice/allstar role README for operational context.
hamstack_allstar_service	asterisk	Configuration value for allstar service; see the voice/allstar role README for operational context.
hamstack_allstar_simpleusb_carrierfrom	usbinvert	Configuration value for allstar simpleusb carrierfrom; see the voice/allstar role README for operational context.
hamstack_allstar_simpleusb_ctcssfrom	no	Configuration value for allstar simpleusb ctcssfrom; see the voice/allstar role README for operational context.
hamstack_allstar_simpleusb_deemphasis	no	Configuration value for allstar simpleusb deemphasis; see the voice/allstar role README for operational context.
hamstack_allstar_simpleusb_devstr	``	Configuration value for allstar simpleusb devstr; see the voice/allstar role README for operational context.
hamstack_allstar_simpleusb_eeprom	0	Configuration value for allstar simpleusb eeprom; see the voice/allstar role README for operational context.
hamstack_allstar_simpleusb_invertptt	no	Configuration value for allstar simpleusb invertptt; see the voice/allstar role README for operational context.
hamstack_allstar_simpleusb_preemphasis	no	Configuration value for allstar simpleusb preemphasis; see the voice/allstar role README for operational context.
hamstack_allstar_simpleusb_rxboost	no	Configuration value for allstar simpleusb rxboost; see the voice/allstar role README for operational context.
hamstack_allstar_simpleusb_rxmixerset	null	Configuration value for allstar simpleusb rxmixerset; see the voice/allstar role README for operational context.
hamstack_allstar_simpleusb_settings	{}	Configuration value for allstar simpleusb settings; see the voice/allstar role README for operational context.
hamstack_allstar_simpleusb_txmixaset	null	Configuration value for allstar simpleusb txmixaset; see the voice/allstar role README for operational context.
hamstack_allstar_simpleusb_txmixbset	null	Configuration value for allstar simpleusb txmixbset; see the voice/allstar role README for operational context.
hamstack_allstar_usbradio_settings	{}	Configuration value for allstar usbradio settings; see the voice/allstar role README for operational context.

voice/wpsd

Variable	Default	Purpose
hamstack_wpsd_callsign	{{ hamstack_callsign | default('N0CALL') }}	Callsign used by this role.
hamstack_wpsd_config_backups	false	Configuration value for wpsd config backups; see the voice/wpsd role README for operational context.
hamstack_wpsd_config_path	/etc/mmdvmhost	Configuration value for wpsd config path; see the voice/wpsd role README for operational context.
hamstack_wpsd_dashboard_config_path	/etc/WPSD-Dashboard-Config.ini	Configuration value for wpsd dashboard config path; see the voice/wpsd role README for operational context.
hamstack_wpsd_dashboard_extra_settings	{}	Reserved pass-through/extension settings not otherwise modeled.
hamstack_wpsd_dashboard_language	``	Configuration value for wpsd dashboard language; see the voice/wpsd role README for operational context.
hamstack_wpsd_description	HamStack managed WPSD node	Configuration value for wpsd description; see the voice/wpsd role README for operational context.
hamstack_wpsd_display	none	Configuration value for wpsd display; see the voice/wpsd role README for operational context.
hamstack_wpsd_dmr_custom_network_address	``	Configuration value for wpsd dmr custom network address; see the voice/wpsd role README for operational context.
hamstack_wpsd_dmr_custom_network_auto_rewrites	false	Configuration value for wpsd dmr custom network auto rewrites; see the voice/wpsd role README for operational context.
hamstack_wpsd_dmr_custom_network_exclusive	true	Configuration value for wpsd dmr custom network exclusive; see the voice/wpsd role README for operational context.
hamstack_wpsd_dmr_custom_network_id	{{ hamstack_wpsd_dmr_id }}	Configuration value for wpsd dmr custom network id; see the voice/wpsd role README for operational context.
hamstack_wpsd_dmr_custom_network_location	false	Configuration value for wpsd dmr custom network location; see the voice/wpsd role README for operational context.
hamstack_wpsd_dmr_custom_network_name	``	Configuration value for wpsd dmr custom network name; see the voice/wpsd role README for operational context.
hamstack_wpsd_dmr_custom_network_options	``	Configuration value for wpsd dmr custom network options; see the voice/wpsd role README for operational context.
hamstack_wpsd_dmr_custom_network_port	62030	Network port used by this setting.
hamstack_wpsd_dmr_custom_network_rules	[]	Configuration value for wpsd dmr custom network rules; see the voice/wpsd role README for operational context.
hamstack_wpsd_dmr_id	null	Configuration value for wpsd dmr id; see the voice/wpsd role README for operational context.
hamstack_wpsd_dmrgateway_config_path	/etc/dmrgateway	Configuration value for wpsd dmrgateway config path; see the voice/wpsd role README for operational context.
hamstack_wpsd_duplex	false	Configuration value for wpsd duplex; see the voice/wpsd role README for operational context.
hamstack_wpsd_enabled	false	Enable the voice/wpsd role/capability.
hamstack_wpsd_frequency_mhz	null	Configuration value for wpsd frequency mhz; see the voice/wpsd role README for operational context.
hamstack_wpsd_grid_locator	{{ hamstack_grid_locator | default('') }}	Maidenhead grid locator used by this role.
hamstack_wpsd_hotspot_name	{{ inventory_hostname }}	Configuration value for wpsd hotspot name; see the voice/wpsd role README for operational context.
hamstack_wpsd_interface	``	Configuration value for wpsd interface; see the voice/wpsd role README for operational context.
hamstack_wpsd_latitude	{{ hamstack_latitude | default(none) }}	Latitude used by this role when location is required.
hamstack_wpsd_location	{{ hamstack_wpsd_grid_locator }}	Configuration value for wpsd location; see the voice/wpsd role README for operational context.
hamstack_wpsd_longitude	{{ hamstack_longitude | default(none) }}	Longitude used by this role when location is required.
hamstack_wpsd_manage_dmr_custom_network	false	Configuration value for wpsd manage dmr custom network; see the voice/wpsd role README for operational context.
hamstack_wpsd_manage_modes	true	Configuration value for wpsd manage modes; see the voice/wpsd role README for operational context.
hamstack_wpsd_mmdvmhost_extra	[]	Configuration value for wpsd mmdvmhost extra; see the voice/wpsd role README for operational context.
hamstack_wpsd_modem	``	Configuration value for wpsd modem; see the voice/wpsd role README for operational context.
hamstack_wpsd_modem_config_path	/etc/dstar-radio.mmdvmhost	Configuration value for wpsd modem config path; see the voice/wpsd role README for operational context.
hamstack_wpsd_modes	[]	Configuration value for wpsd modes; see the voice/wpsd role README for operational context.
hamstack_wpsd_nxdn_id	null	Configuration value for wpsd nxdn id; see the voice/wpsd role README for operational context.
hamstack_wpsd_oled_brightness	0	Configuration value for wpsd oled brightness; see the voice/wpsd role README for operational context.
hamstack_wpsd_oled_cast	false	Configuration value for wpsd oled cast; see the voice/wpsd role README for operational context.
hamstack_wpsd_oled_invert	false	Configuration value for wpsd oled invert; see the voice/wpsd role README for operational context.
hamstack_wpsd_oled_rotate	false	Configuration value for wpsd oled rotate; see the voice/wpsd role README for operational context.
hamstack_wpsd_oled_screensaver	true	Configuration value for wpsd oled screensaver; see the voice/wpsd role README for operational context.
hamstack_wpsd_oled_scroll	false	Configuration value for wpsd oled scroll; see the voice/wpsd role README for operational context.
hamstack_wpsd_oled_type	3	Configuration value for wpsd oled type; see the voice/wpsd role README for operational context.
hamstack_wpsd_restart_on_change	true	Configuration value for wpsd restart on change; see the voice/wpsd role README for operational context.
hamstack_wpsd_rx_frequency_mhz	{{ hamstack_wpsd_frequency_mhz }}	Configuration value for wpsd rx frequency mhz; see the voice/wpsd role README for operational context.
hamstack_wpsd_rx_offset_hz	null	Configuration value for wpsd rx offset hz; see the voice/wpsd role README for operational context.
hamstack_wpsd_timezone	{{ hamstack_timezone | default('UTC') }}	Configuration value for wpsd timezone; see the voice/wpsd role README for operational context.
hamstack_wpsd_tx_frequency_mhz	{{ hamstack_wpsd_frequency_mhz }}	Configuration value for wpsd tx frequency mhz; see the voice/wpsd role README for operational context.
hamstack_wpsd_tx_offset_hz	null	Configuration value for wpsd tx offset hz; see the voice/wpsd role README for operational context.
hamstack_wpsd_url	``	Configuration value for wpsd url; see the voice/wpsd role README for operational context.