Skip to content

Login and Authentication

ElyOS is a closed system accessible only to authenticated users. To access the system, you must have a valid user account. This guide covers different login methods, account creation, and security features that help protect your account.

The ElyOS authentication system ensures that:

  • Only authorized users can access the system
  • Each user has their own personalized environment
  • Data and settings are kept secure
  • The system can track user activities

ElyOS supports multiple login methods for your convenience.

Placeholder: Login screen with email/password fields, email code option, and Google login button The login screen with all available login methods

The most common login method using email address and password.

Steps:

  1. Open the ElyOS login page
  2. Enter your email address in the “Email address” field
  3. Enter your password in the “Password” field
  4. Click the “Login” button

Email OTP (one-time password) login is a passwordless authentication method.

Steps:

  1. Open the ElyOS login page
  2. Click the “Login with email code” link
  3. Enter your email address
  4. Click the “Send code” button
  5. Check your email account
  6. Enter the received one-time code
  7. Click the “Verify” button

If enabled by the administrator, you can also log in with your Google account.

Steps:

  1. Open the ElyOS login page
  2. Click the “Sign in with Google” button
  3. Select your Google account
  4. Grant ElyOS access
  5. You will be automatically logged into ElyOS

Note: If you log in with a Google account for the first time, a new ElyOS user account will be automatically created with your email address. This feature is not available in all installations.

Create a new user account with email verification.

Tip: If you log in with a Google account for the first time, you don’t need to register separately - your account will be created automatically.

Email/password registration steps:

  1. Open the ElyOS login page
  2. Click the “Don’t have an account? Register here” link
  3. Enter your full name
  4. Enter your email address
  5. Choose a strong password
  6. Confirm the password
  7. Click the “Create account” button
  8. Check your email account
  9. Click the verification link in the email
  10. After email confirmation, you can log in

Placeholder: Registration screen with email and password fields Registration form for account creation

If you forgot your password, you can easily reset it.

Steps:

  1. Open the ElyOS login page
  2. Click the “Forgot your password?” link
  3. Enter your email address
  4. Click the “Send password reset link” button
  5. Check your email account
  6. Click the reset link in the email
  7. Enter a new password
  8. Confirm the new password
  9. Click the “Reset password” button
  10. Log in with your new password

Placeholder: Password reset screen with email field and send button Sending password reset request with email address

Two-factor authentication adds an extra layer of security to your account. After logging in, you can enable this feature in the Settings application.

What does 2FA provide?

  • Extra protection for your account
  • Use of authenticator app (e.g., Google Authenticator, Authy)
  • Backup codes for emergencies

How does it work?

  1. After enabling, you must provide a 6-digit code at each login
  2. The code is generated by the authenticator app
  3. The code changes every 30 seconds

Placeholder: 2FA login screen with 6-digit code field Two-factor authentication verification at login

On the 2FA login screen, you have the option to enable “Trust this device for 30 days”.

What does this mean?

  • If you check this option, the system won’t ask for the 2FA code again on this device for 30 days
  • This is convenient if you regularly log in from your own secure device
  • After the 30-day period, you must provide the 2FA code again
  • Each device is managed separately - if you log in from multiple devices, you can mark each one separately

When to use it?

  • On your own computer or phone that only you use
  • In a secure environment where others cannot access the device

When NOT to use it?

  • On public or shared computers
  • On work devices that others may use
  • On devices that can be easily lost or stolen

When setting up 2FA, the system generates backup (recovery) codes for you.

Why are backup codes important?

  • If you lose or your authenticator device malfunctions, you can still log in with these codes
  • Each code can only be used once
  • You typically receive 10 backup codes

How to store them securely?

  • Save them in a secure place (password manager, encrypted file)
  • Print them and store in a secure location (safe, locked drawer)
  • Don’t store them on the same device where the authenticator app is
  • Never share backup codes with others

Using a backup code:

  1. On the 2FA login screen, click the “Use backup code” link
  2. Enter one of your unused backup codes
  3. The code becomes invalid after use
  4. After logging in, immediately set up a new authenticator device or generate new backup codes

Important: If you run out of backup codes, you can generate new ones anytime in Settings > Security. Generating new codes invalidates old, unused codes.

Detailed guide: A detailed description of setting up and managing 2FA can be found in the Settings documentation (coming soon).

ElyOS automatically preserves your session, so you don’t have to log in every time.

  • The system securely stores session information
  • You will be automatically logged in on your next visit
  • Session preservation works even after closing the browser

You can log out of the system at any time by clicking the “Logout” button in the Start Menu.

Steps:

  1. Click on your user profile in the taskbar
  2. Select the “Logout” option
  3. The system immediately logs you out and redirects to the login page

For security reasons, sessions expire after a certain time.

  • Sessions are valid for 7 days by default
  • The system automatically renews the session if you actively use it
  • After expiration, you must log in again
  • The timeout period is set by the administrator

Note: Inactivity-based automatic logout and pre-expiration warning features are currently under development.

For security reasons, ElyOS allows only one active session at a time.

  • You can only be logged in from one device or browser at a time
  • A new login automatically logs out previous sessions
  • This prevents parallel access and increases security
  • If you log in from another device, you will be automatically logged out on the previous device

After successful login, the ElyOS desktop environment appears. You are now ready to use the system.

  • Desktop: The main workspace where application windows appear
  • Taskbar: Located on the bottom (or top) bar with application buttons and system icons
  • Start Menu: Menu for launching applications
  • Desktop Shortcuts: Quick access to frequently used applications

Placeholder: Desktop environment at first launch with taskbar, start menu button, and shortcuts The ElyOS desktop environment at first launch

Now that you’re logged in, familiarize yourself with using the interface:

More information: Using the Interface

I didn’t receive the verification email. What should I do?

  • Check your spam/junk folder
  • Wait a few minutes, email delivery may take time
  • Try resending the verification email
  • Check if you entered your email address correctly

I lost my 2FA device. How can I log in?

  • Use the recovery codes you saved when setting up 2FA
  • If you don’t have recovery codes, contact the administrator

Why does the system automatically log me out?

  • This is the session timeout security feature
  • After prolonged inactivity, the system automatically logs you out
  • Simply log in again to continue