Skip to main content

Getting started

This page walks you through signing up, creating an organisation, and opening your first project. It should take less than five minutes from a clean browser.

1. Sign up​

Open app.knx-clarity.com and click Anmelden / Sign in. The authenticator supports:

  • Email + password (the default for beta)
  • Google single sign-on
KNX Clarity sign-in dialog with the KNX Clarity logo, email and password fields, a Google sign-in button, and a 'Create account' link underneath.

When you sign up with email and password, KNX Clarity sends a verification code to your inbox. Enter it within 10 minutes; if the code expires, click Resend code.

Password policy

For the public beta we require passwords that are at least 12 characters long and contain upper-case, lower-case, numeric, and symbol characters. You can enable MFA from Settings → Security after your first sign-in — we recommend it for admin accounts.

2. Create your organisation​

Every project in KNX Clarity belongs to an organisation. An organisation is the unit of billing, auditing, and member management. You will probably only ever need one, unless you work for a holding company with multiple legal entities.

On first sign-in the app shows the "Set up your organisation" prompt. Give the org a name (usually your company name), optionally a description, and click Create organisation.

Setup organisation prompt with a text input labelled 'Organisation name', an optional description text area, and a primary 'Create organisation' button.

The account that creates the organisation automatically becomes its owner with the admin member role. You can change this later on the Team page.

3. Create your first project​

Once the organisation is ready you land on the Dashboard. The fastest way to get something on screen is to create a project:

  1. In the sidebar, click Projects.
  2. Click New project in the top-right.
  3. Fill in at least the Name; the other fields (customer, building name, description, address) are optional and can be edited later.
  4. Click Create.
Create-project dialog showing fields for project name, customer (dropdown), building name, building address, and description, with Cancel and Create buttons.

You now have an empty project. The next thing to do is upload an ETS export so the rest of the platform has something to work with — jump to ETS files.

4. Invite your team (optional)​

If you're going to be the only person using the platform, you can skip this step. Otherwise, head to Team → Invite member. See Team for role semantics and invitation flow.

Troubleshooting​

  • I never received my verification code. Check spam. If it really didn't arrive, click Back to sign in, click Forgot password, and request a new code — the address is valid, the message just got lost.
  • I see "No organisation yet" even after creating one. This usually means the session didn't pick up your new membership. Sign out from the avatar dropdown and back in.
  • Sign-in works but the dashboard is blank. Open the browser console — most beta blockers surface there as a clear error you can paste into a GitHub issue or the in-app feedback form.