For the complete documentation index, see llms.txt. This page is also available as Markdown.
Devices
The Devices tab shows every device signed into your account and lets you sign them out. This is also where you free up instances when you hit your limit.
The Devices tab: instance usage up top, sign-out controls, and your device list below.
Your instance usage
The bar at the top shows how many of your instances are in use, for example 1 of 2 desktop instances in use. The total reflects how many instances your subscription includes, and each instance is consumed by a device that is currently running and connected. It is strictly one instance per device: a machine runs one copy of Refract, and a second instance requires a second computer or server.
Click Refresh to force the list to reset and show the current state.
Each device in the list shows its name, operating system, bot version, IP address, whether it is active, and when it was last seen.
An active device: name, operating system, bot version, IP, and when it was last seen.
Sign devices out
You have four ways to sign devices out:
Click the X next to a single device.
Tick the checkboxes on the devices you want gone, then click Sign out selected.
Click Sign out inactive to sign out only the devices that are not currently active.
Click Sign out all to sign out everything at once.
Fix "Max Instance Limit Reached"
If the bot shows Max Instance Limit Reached when you log in, every instance on your subscription is already consumed by another device. Fix it from this page:
Running on a cloud server, like an AWS image? Stopping and starting a server can change its hardware and IP, so Refract may see it as a brand new device when it comes back up. The old session still counts against your limit, so sign out the stale device here and sign in again.
Sign out the devices you are not using. Sign out all is the quickest way if you only run one machine.
3
Log into the bot again
With an instance freed up, log back into the bot on the device you want to use.
If you keep hitting the limit because you genuinely run more machines than you have instances, you can add an instance from the Subscription page, up to the current cap.
