plinthHelp Deutsch

Signing in

All ways to sign in: Shopware, your own account, passkey and two-factor authentication, plus My account and signing out.

plinth has two sign-in pages on one account system. Most of the team signs in through Shopware. People with an account of their own sign in with username, password and a second factor. This page explains every method, your own account page and what to do when sign-in fails.

Where to find it

  • The sign-in page opens by itself when you are not signed in. Its address ends in /login.
  • A link at the bottom switches between the two pages: Sign in with your own account and Sign in through Shopware.
  • Your own account: Help and administration > My account, or the account menu at the top right > My account.
  • Signing out: account menu at the top right > Sign out.

What you need

  • For sign-in through Shopware: a Shopware admin account in the shop, and the sign-in through Shopware must be set up for that shop.
  • For your own account: a username and, the first time, an activation code. You get both in person from the one who created your account.
  • For two-factor authentication: an authenticator app (for example the one in your password manager) or a passkey (Touch ID, Windows Hello, security key).

How do I sign in through Shopware?

  1. Open the sign-in page. It shows Team sign-in through Shopware.
  2. Click Sign in with Shopware: followed by the name of your shop.
  3. Sign in to Shopware if you are asked to. Shopware's own two-factor authentication applies there.
  4. You are sent back to plinth and land on the start page.

You can also start from the Shopware administration: open plinth from the menu entry of the sign-in plugin. No Shopware password passes through plinth this way.

Note: If the shop allows it, the page also shows Sign in with Shopware password with the shop name. Open it, enter your Shopware Username and Password and click Sign in. This is a fallback for shops without the plugin.

How do I sign in with my own account?

  1. On the sign-in page click Sign in with your own account.
  2. Enter Username and Password and click Sign in.
  3. If your account has a second factor, the page Two-factor authentication opens. Choose one of these:
    • Confirm with a passkey
    • Code from the authenticator app: enter the 6-digit code.
    • Recovery code: enter one of your recovery codes if your phone is not at hand.
  4. Click Confirm.

How do I sign in with a passkey?

  1. On the page for your own account click Sign in with a passkey.
  2. Confirm with fingerprint, face or security key, as your device asks.

The button only appears when passkeys are available on this installation. You add a passkey under My account, see below.

How do I sign in with the company sign-in service?

If your company uses a central sign-in service, the sign-in page shows the button Sign in with catchIT account. Click it, sign in there, and you are sent back to plinth.

How do I activate a new account?

  1. On the page for your own account click Set up a new account with an activation code.
  2. Enter your Username and the Activation code and click Continue. The code is valid for 24 hours and works once.
  3. On the page Set up account choose a password. It needs at least 12 characters. A long phrase is easy to remember and secure.
  4. Set up the second factor. Scan the QR code with an authenticator app and enter the 6-digit code, or click Add passkey. If the second factor is marked required, you cannot skip it.
  5. Click Finish setup.
  6. The page Recovery codes appears. Print the codes or keep them in your password manager. They are shown only now. Click Continue.

How do I change my password or second factor?

This applies to accounts of your own. If you sign in through Shopware, you change your password in Shopware.

  1. Open Help and administration > My account.
  2. Go to the section Sign-in and two-factor authentication.
  3. To change the password, fill in Current password, New password and Repeat new password, then click Change password. Your other sessions are ended.
  4. To set up the authenticator app, enter your current password next to Authenticator app and click Set up. Scan the QR code, enter the code and click Confirm.
  5. To add a passkey, enter an optional Passkey name and your Current password, then click Add passkey.
  6. To get fresh recovery codes, enter your current password and click Generate new codes. The old codes stop working.

How do I change language, appearance or profile image?

  1. Open Help and administration > My account.
  2. Under Profile choose Language, Appearance and Density and click Save.
  3. Under Profile image choose a file and click Upload. PNG, JPEG or WebP, up to 2 MB.

How do I sign out, here or on other devices?

  1. To sign out here, open the account menu at the top right and click Sign out.
  2. To sign out another device, open My account and look at Signed-in devices. Click End next to a device, or End all others.

When does my session end by itself?

A session ends after a period without activity and, at the latest, after a fixed maximum time. By default this is 2 hours without activity and 12 hours in total; your installation may use other values. Then you see Sign-in required with the text Your session has expired. Sign in again. Unsaved input on that page is lost, so save before long breaks.

Common errors and fixes

Message Cause Fix
User name or password is wrong. Typing error, or the account does not exist. Check both. Forgot your password? Ask the person who set up your account for a new activation code.
Too many attempts. Try again in a minute. Several failed attempts in a row. The wait gets longer with each further failure. Wait, then try again. A person with Manage people can lift the lock with Clear lockout.
The code from the app is wrong. Check the time on your phone and try again. The clock of your phone is off, or the code has expired. Set the phone clock to automatic and enter a fresh code.
User name or activation code is wrong, expired or already used. The code is older than 24 hours or was used before. Ask for a new activation code.
This account is blocked. Someone blocked the account. Ask the person who manages access.
This account has expired. The end date of the account has passed. Ask for a new end date.
This account is not approved yet. An external account is waiting for a second person to approve it. Wait for the approval or remind your contact.
Your account is waiting for a role. Ask your team lead. You signed in through Shopware for the first time and have no role yet. Your team lead assigns a role under Access.
Sign-in through Shopware isn't set up yet. No shop has the Shopware sign-in switched on. A person with Set up Shopware sign-in sets it up. See Access.
First set up two-factor authentication in Shopware and sign in with it. The shop only accepts Shopware sign-ins with two-factor authentication. Set up two-factor authentication in your Shopware profile.
Shopware can't be reached right now. The shop does not answer. Try again in a moment.
The page was open too long. Reload it. The sign-in form is outdated. Reload the page and try again.
The password needs at least 12 characters. The new password is too short. Choose a longer password. Very common passwords and passwords that contain the username are refused too.
This browser does not support passkeys. The browser or device cannot use passkeys. Use the authenticator app or another browser.

See also