events-server-web keeps the latest state of every building in memory (read from the map-chunk-entity topic, like the resource patches) and serves them per area. The web map draws the icons at their real size onto canvas tiles, so large bases stay fast, and shows each building's name, status and health on hover. Ghosts are ignored, and buildings are removed when they're mined. The icons belong to Wube and the mod authors, so they aren't in the repo. export_building_icons.py builds them from a Factorio client's --dump-data/--dump-prototype-locale/--dump-icon-sprites output, and the web-map nginx serves them from a mounted volume. Also label single-well oil fields "1 well". Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
4.5 KiB
Running Kafkatorio
Building the project
Requirements
- Docker
- Docker Compose
- Java 11
Kafkatorio uses Gradle to build the project, and Docker Compose to create images.
./gradlew build- build and test the project./gradlew runKafkatorio- run locally (if Docker is running, a Kafka instance will start)./gradlew dockerComposeBuild- build, test, and create Kafkatorio Docker images
Server set up
See ./kafkatorio-platform/docker-compose.yml for a complete example
-
Copy the kafkatorio-platform directory to your computer
-
Rename
example.secret.kafkatorio-config.ymlto.secret.kafkatorio-config.ymlIn it, define both
- a JWT secret password (a long alphanumeric string is best, you won't need to type this password manually)
- a Factorio server, with a short-ID and a description.
-
Rename
example.envto.env -
Create a JWT for your Factorio server, by going to https://jwt.io/
- In 'PAYLOAD: DATA', set
subto your Factorio server's short ID.
({ "sub": "<your server short ID>", "iat": ... }iat, 'issued-at-time', should update automatically to be the current time.) - Replace
your-256-bit-secretwith your JWT secret password
Copy the 'Encoded' token (it should start with
ey).In the
.envfile, setKAFKATORIO_TOKENto equal the token. - In 'PAYLOAD: DATA', set
-
In
kafkatorio-platform, start the docker containersdocker-compose up -d; docker-compose logs -f
Unraid set up
This runs the Kafkatorio services on the same Unraid server as the Factorio server. The Docker
syslog log driver runs in the Docker daemon on the host, so the syslog port only needs to listen
on 127.0.0.1, and Kafka isn't exposed at all.
-
Install the Compose Manager plugin (or Compose Manager Plus) from the Apps tab.
-
Build the images locally, and copy them to Unraid (no registry needed):
./gradlew dockerComposeBuild docker save $(docker images --format '{{.Repository}}:{{.Tag}}' | grep dev.adamko.kafkatorio) \ | gzip | ssh root@<unraid> 'gunzip | docker load' -
On Unraid, create
/mnt/user/appdata/kafkatorio-platform/containing.secret.kafkatorio-config.yml(see above)config/kafka-server.properties(copy from ./kafkatorio-platform/config)config/cluster_id- a fixed Kafka cluster ID, so the Kafka data survives image rebuilds. Generate one withdocker run --rm --entrypoint ./bin/kafka-storage.sh <kafka-kraft image> random-uuid.
-
Create a Compose Manager stack, with the Unraid
docker-compose.yml, andexample.envas its.env. Start the stack. -
Edit the Factorio container, enable 'Advanced View', and set 'Extra Parameters' to
--log-driver=syslog --log-opt syslog-address=tcp://127.0.0.1:12035 --log-opt syslog-format=rfc5424 --log-opt mode=non-blocking --log-opt tag=<KAFKATORIO_TOKEN>Docker won't start a container if its TCP syslog server isn't reachable, so on the Docker tab give the Factorio container an autostart 'wait' of ~30 seconds, so the Kafkatorio services start first.
-
The web map is on port
12081. It also proxies/kafkatorio/to the events server, so a reverse proxy (e.g. Nginx Proxy Manager) only needs to forward to that one port - make sure WebSocket support is enabled. -
In Factorio, run
/kafkatorio prototypesand then/kafkatorio chunks 10to send the existing map. -
Optional: building icons. The web map's 'Building icons' layer uses icons and building sizes exported from a Factorio client that has the same mods as the server (they're not in this repo, since they belong to Wube and the mod authors). With the game closed, run
factorio --dump-data factorio --dump-prototype-locale SteamAppId=427520 factorio --dump-icon-sprites # SteamAppId stops Steam relaunching the game python3 docs/kafkatorio-platform/building-icons/export_building_icons.py ~/.factorio/script-output ./icons scp -r ./icons root@<unraid>:/mnt/user/appdata/kafkatorio-platform/Re-export them when the mods change.