Documentation contents

Requirements

Use a Linux machine with systemd, at least 1 vCPU, 2 GB of RAM and 20 GB of SSD storage.

Server

ComponentRequirement
Operating systemx86-64 (amd64) Linux with systemd
Minimum resources1 vCPU, 2 GB RAM and 20 GB of SSD storage
System toolsopenssl
PermissionsRoot access during installation
DatabaseSQLite (included by default) or your own PostgreSQL or MySQL server

The installer includes the Gadka server and HTTPS reverse proxy. It downloads nothing from the internet.

Domain and certificate

  • A domain such as gadka.example.com with an A or AAAA record pointing to the server.
  • A TLS certificate for that domain. You need the full certificate chain and the private key in separate PEM files.

You obtain and renew the certificate yourself through your company’s certificate authority or a public one. See Domain and HTTPS.

Ports

PortProtocolDirectionPurpose
6543TCPInboundHTTPS for authentication, the API and WebSocket connections
6543UDPInboundFast QUIC connections from apps
443TCPOutbound to hole.cert.plCERT Polska’s warning list (you can change the source or disable the check)

If you change port 6543 during installation, open the new port in your firewall.

Desktop computers

Operating systemRequirement
macOSVersion 12 or later on Apple Silicon or Intel
Linuxx86-64 or arm64, Debian 12 or newer or an equivalent distribution (glibc 2.36 or later), and a working keyring such as GNOME Keyring
WindowsSystem architecture: 64 bits

Get the apps from the downloads page.

Browsers

The web app runs in Chrome, Edge and other browsers based on Chromium, as well as Safari and Firefox. The server installer does not include the web app.