Documentation contents

What is Gadka?

Your team’s conversations take place on your organization’s server. People connect through the Gadka app.

Teams use Gadka to talk in channels, threads and direct messages. They can share files, search messages, create polls, set reminders and use their calendars. You host the server in your own environment.

Components

ComponentWhat it doesWhere it runs
ServerA single gadka executable with a databaseYour Linux server or virtual machine
Reverse proxyThe bundled gadka-caddy executable handles HTTPSThe same server
AppsDesktop clients for macOS, Linux and WindowsTeam members’ computers

The app connects to one domain on one port, 6543 by default. It first tries QUIC over UDP for speed. If the network blocks UDP, the app switches to WebSocket over TCP automatically.

Accounts, invitations and notifications

  • A workspace is your company’s space on the server. Users enter its short identifier, such as firma, when they sign in.
  • Create the first owner account by running a command on the server. Invite everyone else from the app using a link.
  • Gadka does not send email. Share the invitation link yourself using any channel. This also works on networks without internet access.
  • The app delivers notifications while it is running. Gadka does not use external push notification services.
  • Desktop apps update automatically. Update the server manually when a new version becomes available.
  • Without a license key, Gadka runs in the Free edition with up to 10 active accounts.

Default outbound server connection

By default, the server downloads CERT Polska’s warning list every 5 minutes to block links to phishing sites. Use the link safety settings to specify your own copy or disable the check.