Skip to content

Getting started

This page covers your first steps as a user of an openkoutsi instance. It assumes someone has already deployed openkoutsi to a server — if you are setting up the server itself, see the deployment guide in the main project repository instead.

Accessing your instance

Open the address of your openkoutsi instance in a web browser (for example, the URL your administrator gave you). openkoutsi works on both desktop and mobile.

First-run setup

The very first time an openkoutsi instance is opened, it shows a setup wizard that creates the first administrator account. If you are the person standing up the instance, complete this wizard to create your admin login. There are no teams — one deployment is a single instance shared by its users.

If the instance is already set up, you will see the normal login page instead.

Getting an account

How you get an account depends on how the instance is configured.

By invitation (always available):

  1. An administrator issues you an invitation.
  2. You open the invite link and create your account with it.

By self-serve sign-up (only if the administrator has enabled it):

  1. On the login page, choose Sign up and register with your email address.
  2. Open the verification link we email you to confirm your address and activate your account.

If you don't see a sign-up option, the instance is invite-only — ask an administrator for an invitation.

Once your account exists, you log in from the instance's login page. Your training data is entirely your own — each user has a private database, and no one else (not even an administrator) sees your activities or plans.

Roles

There are two roles. Most people are a user, who owns and manages their own profile and training data. An instance administrator can additionally manage users, issue invitations, and edit instance-wide settings (such as the optional AI configuration).

Your athlete profile

Once you are in, set up your athlete profile (such as your FTP and heart-rate / power zones). These values are used to analyse your activities and to build training plans. Many of them can also be synced automatically from a connected provider — see Activities & sync.

Next step

With your profile in place, bring in some rides. Continue to Activities & sync.