Get started in 15 minutes
Create the first account on the server. Then open the app to create a channel and invite your team.
The Free edition supports up to 10 active accounts without a license key.
Before you start
- An
x86-64Linux server with root access. See Requirements. - A domain pointing to the server, such as
gadka.example.com. - The full TLS certificate chain and private key on the server, in separate PEM files.
- Port
6543open for TCP and UDP.
1. Install the server
- Get the server installer from the downloads page and copy it to the server.
- Run it as root. Replace
<wersja>with the version number in the downloaded filename.
chmod +x gadka-server-<wersja>-linux-amd64.run
sudo ./gadka-server-<wersja>-linux-amd64.run- Enter the domain. When asked for the certificate and key, enter the paths to your PEM files. Press Enter to accept the remaining defaults.
The installer finishes with Gotowe. Pracownicy wpisują w aplikacji domenę: gadka.example.com, confirming the domain to enter in the app. For a guide to each prompt, see Install the server from a .run file.
2. Create the workspace and owner account
sudo gadka --config /etc/gadka/gadka.yaml admin tenant-create --slug firma --name "Firma Sp. z o.o."
sudo gadka --config /etc/gadka/gadka.yaml admin user-create --tenant firma --email jan@example.com --name "Jan Kowalski" --role ownerAt the password: prompt, enter a password of at least 12 characters and press Enter.
3. Install the app and sign in
- Get the app for your operating system from the downloads page and install it.
- Under Server domain, enter your domain, such as
gadka.example.com. Under Workspace, enter the identifier from step 2, such asfirma. - Enter the email address and password from step 2 and click Sign in.
4. Set up a second authentication factor
You need a second authentication factor to invite people and use other administrative features.
- Click your avatar in the lower left and choose Security.
- Click Turn on two-step verification, enter your password, scan the QR code with your authenticator app and enter the code it shows. Save your recovery codes.
5. Create a channel and invite your first teammate
- Click Create, choose Channel, enter a name such as
projekt-xand click Create. - Click Create, choose Invite people, then Invite people. Enter their email address and click Create invitation.
- Click Copy link and send the link to your teammate.
- Ask them to install the app, click I have an invitation link on the login screen, paste the link and create an account.
Send your first message in the channel.