Single active session
For security and auditability, each CXGear user may have only one active session at a time. That means the same account cannot stay signed in on many devices without control — if you sign in somewhere new, the previous session ends.
This page explains what you will see, why it happens, and how to get back to work quickly.
Why one session?
Section titled “Why one session?”Shared passwords and “always logged in on every laptop” make it hard to know who is acting in the system. A single active session:
- Limits account sharing across desks
- Makes who is online accurate for admins
- Fits compliance expectations (one controlled login trail per person)
Sessions last up to about 12 hours of activity. After that, or if someone else takes over the account, you sign in again.
Sign in normally
Section titled “Sign in normally”- Open the app URL.
- Enter email and password.
- Click Sign in.
If no other session is active, you land in the app immediately.
src/assets/screenshots/03-login.pngSame device auto-replace
Section titled “Same device auto-replace”Sometimes the database still holds a “ghost” session even though you are not really signed in — for example after:
- An API restart
- Closing the browser without Sign out
- A crash or network drop
If you sign in again from the same browser and network (same device label and IP, including localhost when developing), CXGear treats that as the same machine and replaces the old session automatically. You should not need an extra confirmation step.
Typical labels look like “Chrome on macOS” or “Edge on Windows.”
Different device — Continue here
Section titled “Different device — Continue here”If another device still has a fresh session, login stops with a clear message. You will see details such as:
- Previous device label (for example “Chrome on Windows”)
- IP address when available
- When that session started
Click Continue here (end previous session) — or submit Sign in again after that message appears — to take over. The other device is signed out and will see a session-replaced message if it tries to keep working.
src/assets/screenshots/11-session-replace.pngUse this when you intentionally move from office PC to laptop, or when a colleague left a shared account open (prefer personal accounts instead).
Session expired while working
Section titled “Session expired while working”If your session ends while you are in the app, CXGear sends you to login with a message such as:
Your session has expired. Please sign in again.
Other messages you may see:
| Message theme | What it usually means |
|---|---|
| Session expired | Timeout or token no longer valid |
| Signed out / revoked | You signed out, or an admin action ended the session |
| Signed in from a different device | Someone used Continue here on another machine |
You do not need to clear cookies manually. Sign in again with the same email and password.
Sign out the right way
Section titled “Sign out the right way”Use the account menu → Sign out. That revokes your sessions so they should not block the next login or leave a ghost row behind.
If you only close the tab, a session may remain until it expires or is replaced.
Success looks like
Section titled “Success looks like”- You sign in once and work without unexpected logouts
- Moving to a new device shows Continue here, then works on the new device only
- After a restart on the same machine, login succeeds without a conflict prompt
- Admins see accurate online status on Manage users
Common problems
Section titled “Common problems”| Symptom | Likely cause | What to do |
|---|---|---|
| Keep getting “previous session” on the same PC | Browser or IP changed (VPN, different browser) | Use Continue here once |
| Kicked out while working | Someone else signed in with your account | Change password; use personal accounts |
| Cannot sign in after restart | Ghost session on a different network | Use Continue here |
| Message says session expired | Idle past TTL, or session was revoked | Sign in again |