# Reference

Language-neutral surfaces for talking to the controller and the swarm, plus
fixes for common snags.

```{toctree}
:hidden:
rest
mqtt
configuration
troubleshooting
/api
```

- [REST / WebSocket API](rest.md) - the controller's HTTP + WebSocket surface.
- [MQTT](mqtt.md) - topic vocabulary for non-Python integrations.
- [Configuration](configuration.md) - the single `dotbot` config file:
  discovery, precedence, sections, and testbeds.
- [Troubleshooting](troubleshooting.md) - fixes for the rough edges (e.g. the
  Firefox web-UI workaround).
- The autogenerated **Python API** reference is in the sidebar.
