Firewall and ports
By default, apps connect to port 6543 over TCP or UDP. Ports 8080 and 9090 are for local connections.
Gadka uses the same public port number for TCP and UDP. Its other listeners are local and must stay inaccessible from outside the server.
Inbound traffic
| Port | Protocol | Listener | Purpose |
|---|---|---|---|
6543 | TCP | Reverse proxy | HTTPS for authentication, the API, files and WebSocket |
6543 | UDP | Gadka server | QUIC connections from apps |
If you selected a different port during installation, open that port in place of 6543.
Internal ports to keep closed
| Address | Purpose |
|---|---|
127.0.0.1:8080 | Gadka server behind the reverse proxy |
127.0.0.1:9090 | Health and metrics endpoints without authentication: /healthz, /readyz, /metrics |
Outbound server traffic
| Destination | When it is used |
|---|---|
hole.cert.pl:443 | When link checking is enabled (the default) |
| Identity provider (IdP) | When you configure SSO |
oauth2.googleapis.com, www.googleapis.com | When you enable Google Calendar |
login.microsoftonline.com, graph.microsoft.com | When you enable the Microsoft 365 calendar |
| Allowlisted CalDAV servers | When you enable CalDAV |
| Linked websites | When you enable link previews |
The server can run without internet access. Point it to your own copy of CERT Polska’s warning list or disable the check. See Link previews and safety.
Firewall rules for ufw
sudo ufw allow 6543/tcp
sudo ufw allow 6543/udpQUIC on networks that block UDP
The app tries QUIC over UDP first because it is faster and handles network changes better. If the network blocks UDP, the app automatically switches to WebSocket over TCP on the same port. Gadka works with only TCP port 6543 open, but opening both protocols lets the app use the faster connection.
Gadka services run without root privileges, so choose a port above 1023. With the default port of 6543, users only need to enter the domain in the app.
Desktop computers
Team members’ computers need access to gadka.example.com on port 6543 over TCP and preferably UDP as well. Desktop apps also check for updates at gadka.lemric.com, which redirects package downloads to GitHub (TCP port 443).