Technical Union · Ackfield

Ackfield-Receive for Windows

Install the office MQTT server and dashboard with a guided setup wizard. Download one .exe, choose a folder, sign in with your vendor token — the wizard handles Docker, MQTT, and firewall. No PowerShell on your side.

Download setup wizard (v1.0.0)AckfieldInstall-…-setup.exe · Windows 10/11Advanced: download zip kit instead Field phones: download Ackfield-Send for Android

Before you start

Windows 10 or 11 on the office computer
Docker Desktop installed and running
License key from Technical Union (ACKF-…)
Username and token from Technical Union — you enter these on the wizard Sign in page

Docker Desktop must be installed and running before you open the setup wizard.

Network & security

Fixed LAN IP
Set a DHCP reservation or static IP on the office PC so its address (e.g. 192.168.1.50) stays the same after every reboot. Ackfield-Send phones need a stable office address on your Wi‑Fi.
Encrypted MQTT (port 8883)
If you use TLS, make sure antivirus or security software is not blocking port 8883 or intercepting local TLS traffic (SSL inspection). Exclude the office PC or MQTT ports from SSL scanning if connections fail.

Installation wizard

Run AckfieldInstall-…-setup.exe (Run as administrator if Windows asks). The wizard walks you through the steps below.

Welcome — Click Next to begin.
Install folder — Choose where to install (default C:\AckfieldInstall is fine).
Sign in — Use the username and token provided by your vendor. These download Ackfield-Receive — they are not your Windows password. You can paste into the token field.
Installing — The wizard creates MQTT folders, signs in to the container registry, starts Mosquitto and Ackfield-Receive, and opens LAN firewall ports (3000, 1883, 8883). Wait until it finishes.
Finished — Open the URL shown at the end (e.g. http://192.168.1.50:3000).
In the browser — Complete office setup:
- Connection → License — accept EULA, enter license key, Activate
- Connection — save broker settings; generate a pairing code for Ackfield-Send phones
- Users — add MQTT users → Apply to broker

What the wizard runs automatically

Step	Action
MQTT	Creates C:\mqtt\config and C:\mqtt\data from the kit template
Docker	Signs in with your token and starts Mosquitto + Ackfield-Receive
Firewall	Opens LAN ports 3000, 1883, 8883

Manual install & maintenance (optional)

Zip kit: unzip AckfieldInstall, then double-click Install Ackfield.cmd as administrator.

Initialize MQTT folders:

powershell -ExecutionPolicy Bypass -File scripts\init-mqtt-config.ps1

Confirm .env.docker has MQTT_CONFIG_DIR=C:/mqtt and ACKFIELD_RECEIVE_IMAGE set (pre-filled in the kit), then:

docker login ghcr.io
docker compose -f docker-compose.customer.yml --env-file .env.docker up -d
docker ps

Firewall (Administrator):

powershell -ExecutionPolicy Bypass -File scripts\allow-lan-ports.ps1

Stop or restart (from the install folder):

powershell -ExecutionPolicy Bypass -File .\install-office.ps1 -Stop
powershell -ExecutionPolicy Bypass -File .\install-office.ps1 -Restart

Troubleshooting

Problem	What to check
Docker not running	Start Docker Desktop and run the setup wizard again
`pull access denied`	Re-run the setup wizard and enter username + token on the Sign in page
Wizard failed mid-install	Open the install folder (e.g. C:\AckfieldInstall), check install-log.txt, ensure Docker is running, then double-click Install Ackfield.cmd
Mosquitto exits	docker logs mosquitto — check TLS certs if port 8883 is enabled; confirm antivirus is not blocking 8883
TLS / encrypted MQTT fails	Antivirus SSL inspection may block port 8883 — add an exclusion for the office PC or disable SSL scanning for local MQTT
Phone cannot connect	Re-run the wizard as administrator; on Connection generate a pairing code; on the phone use office PC address + code; use LAN IP (not localhost); confirm DHCP reservation or static IP
License fails	Internet access to key.tu.biz; one install per license key