First startup and owner account
A new server has no accounts. Create a workspace for your organization and an owner account before inviting your team.
Sign in to the server as an administrator. You need root access to create your company’s workspace and its first owner account. You can invite everyone else from the app.
Before you start
- A running Gadka server. See Install the server from a .run file.
- Root access to the server.
- A workspace identifier of your choice, using lowercase letters, digits and hyphens, e.g.
firma.
1. Create the workspace
sudo gadka --config /etc/gadka/gadka.yaml admin tenant-create --slug firma --name "Firma Sp. z o.o."Expected output:
tenant firma created (id …)Users enter the identifier from --slug in the Workspace field when signing in. The value of --name is the display name.
2. Create the owner account
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. Gadka rejects passwords found in data breaches. The password stays out of your shell history.
Expected output:
user jan@example.com created in firma (id …, role owner)3. Sign in
- Install the app for your operating system.
- Under Server domain, enter your domain, such as
gadka.example.com. Under Workspace, enter your workspace identifier, such asfirma. Enter the owner’s email address and password. - Click Sign in.
4. Set up a second authentication factor
You need to sign in with a second factor to manage members, invitations and licenses. Until you enable it, you’ll see Administration requires two-step verification.
- Click your avatar in the lower left and choose Security.
- Click Turn on two-step verification, enter your password, scan the QR code with an authenticator app and enter the code it generates.
- Save the recovery codes in a safe place.
If you change phones, set up verification on the new device.
Create a second owner account for someone who can cover for you. A workspace must always have at least one active owner, and users cannot reset a forgotten password themselves.
- Invitations
- Users and roles
- Installation code if you plan to have more than 10 accounts