Documentation contents

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

PortProtocolListenerPurpose
6543TCPReverse proxyHTTPS for authentication, the API, files and WebSocket
6543UDPGadka serverQUIC connections from apps

If you selected a different port during installation, open that port in place of 6543.

Internal ports to keep closed

AddressPurpose
127.0.0.1:8080Gadka server behind the reverse proxy
127.0.0.1:9090Health and metrics endpoints without authentication: /healthz, /readyz, /metrics

Outbound server traffic

DestinationWhen it is used
hole.cert.pl:443When link checking is enabled (the default)
Identity provider (IdP)When you configure SSO
oauth2.googleapis.com, www.googleapis.comWhen you enable Google Calendar
login.microsoftonline.com, graph.microsoft.comWhen you enable the Microsoft 365 calendar
Allowlisted CalDAV serversWhen you enable CalDAV
Linked websitesWhen 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/udp

QUIC 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).