Asterobot works with one asterobot.net account at a time, and the account button at the bottom of the sidebar shows which. Signing in for the first time is explained in Sign in with asterobot.net.
The sign-in belongs to Asterobot
The asterobot.net sign-in is stored in Asterobot, not in your browser. Every Asteroboard connected to the same Asterobot, on any device, shows the same account, and signing out from one of them signs Asterobot out for all of them.
It also works the other way round: being signed in to asterobot.net in your browser doesn't sign Asterobot in. Asterobot needs its own sign-in, which you give it once by confirming a code on the website.
The account button
The account button sits at the bottom of Asteroboard's sidebar. Once Asterobot is signed in, it shows your asterobot.net avatar and name, and a click opens a menu:
| Menu item | What it does |
|---|---|
| Account | Opens the Account page, described below. It's the only way to reach that page: it isn't listed in the sidebar. |
| Online Profile | Opens your profile on asterobot.net in a new tab. It only appears once Asteroboard has loaded your profile. |
| Log out | Disconnects Asterobot from your account. See Disconnect Asterobot. |
The other states of the button, Sign in and the pending sign-in, are explained in Sign in with asterobot.net.
The Account page
The page shows your avatar and your member name at the top, with your member title under the name when you have one. A card below lists the details asterobot.net gives about your account:
| Row | What it shows |
|---|---|
| The email address of your asterobot.net account. | |
| Joined | The date you joined asterobot.net. |
| Primary group | Your main member group on asterobot.net, as a badge. |
A row only appears when asterobot.net returns a value for it. Under the cards, View on asterobot.net opens your profile on the website in a new tab, and Disconnect signs Asterobot out.
When the page says Not signed in
Asteroboard loads these details straight from asterobot.net, in your browser, using Asterobot's sign-in. So the device you open Asteroboard on needs to reach asterobot.net too.
The page shows Not signed in, with "Sign in from the sidebar to see your asterobot.net account here.", in two cases:
- Asterobot really isn't signed in. The account button then reads Sign in: click it and follow Sign in with asterobot.net.
- Asterobot is signed in, but Asteroboard couldn't load your details from asterobot.net, for example because this device has no internet access or the website is down. The account button then reads Signed in, without your avatar or name.
In the second case, Asteroboard tries again each time it reconnects to Asterobot, and when you reload the page. If it keeps failing, check whether asterobot.net is up on its status page, as Messages and updates explains.
Disconnect Asterobot
- Click Disconnect on the Account page, or open the account button's menu and click Log out. Both do the same thing.
- Your browser asks: "This disconnects Asterobot from your asterobot.net account. You'll need to sign in again to reconnect. Continue?" Confirm.
Asterobot forgets its sign-in and the account button reads Sign in again, with a red dot. If something goes wrong, Asteroboard shows Couldn't disconnect and nothing changes.
Behind the scenes, Asterobot empties the website.token setting and turns on website.signedOut, both in config.toml. The second one is what keeps it signed out: Asterobot doesn't start a new sign-in by itself afterwards, not even when it restarts.
Asterobot uses its sign-in to add bots and to download packages from the marketplace, so sign in again before you do either. If Asterobot starts while it's signed out, it also skips every saved bot, as Disconnect, delete and restart explains. Your bots stay saved and come back at the next start once Asterobot is signed in again.
Sign back in
Click Sign in on the account button. Asterobot asks asterobot.net for a new code, opens the link in a browser tab on the computer where it runs, and the account button opens the same link. Confirm the code as described in Sign in with asterobot.net.
Switch to another asterobot.net account
- Disconnect Asterobot as described above.
- In your browser, make sure you're signed in to asterobot.net with the account you want Asterobot to use. Sign out of the website first if it's still on the other account.
- Click Sign in on the account button and confirm the new code.
The code is confirmed for whichever account your browser is signed in with on asterobot.net at that moment. Check the name on the account button once it's done.
Keep the sign-in private
The sign-in Asterobot stores in website.token gives access to your asterobot.net account. Never share it, or the config.toml file that holds it. Getting help lists everything that must stay private.