Asteroboard can't connect

Asteroboard has nothing to show on its own: every bot, setting and game version on its pages comes from your Asterobot. When the two can't talk, pages stay empty and nothing you click goes through. The causes below start with the most common.

How to tell

Asteroboard tries to reconnect by itself, once a second, for as long as the page is open. It shows Server disconnected once when it loses Asterobot, not at every attempt, and Server connected once it's back. You don't need to reload the page.

To check right now, open Preferences, go to the Server section and click Test connection. It sends one request to the address in Server URL:

• Server reachable, with a line such as "Round-trip latency: 12ms": Asterobot answered. If the badge didn't say Connected yet, Asteroboard reconnects at once.
• Server unreachable: nothing answered at that address. Read on.

Asterobot isn't running

This is the most common cause. Asterobot stops when its terminal window is closed, when someone clicks Shutdown server, when Ctrl+C is pressed in its terminal, or when the computer restarts. Asteroboard can't start it again.

1. Go to the computer where Asterobot runs and look for its terminal window.
2. If there's none, start Asterobot again as First launch shows.
3. Wait for Server listening in the terminal. Asteroboard connects by itself and shows Server connected.

Your bots come back disconnected, and nothing reconnects or plays on its own. See Disconnect, delete and restart.

An error occurred during the server's initialization process

Asterobot prints this and stops a moment after starting: it couldn't listen on its address. The rest of the line starts with failed to make server listen:, followed by the reason your system gave.

Two things can mislead you. The terminal shows Server listening right before the error, because Asterobot prints that line before it tries. And your browser may still open http://127.0.0.1:8080, which then shows whatever already uses that port: if it's another copy of Asterobot, you land on an Asteroboard connected to that other copy.

The usual causes:

• Another copy of Asterobot is already running, in another terminal window, in a terminal multiplexer such as tmux, or as a service. Use that one, or stop it before starting a new one.
• Another program uses port 8080. Give Asterobot another port, as below.
• server.listenAddress names an address this computer doesn't have, for example a network address that changed since you set it. Set it back to 127.0.0.1:8080, or to the current address.

Since Asterobot isn't running, change the setting in config.toml with a text editor. Files and folders shows where the file is.

1. Open config.toml.

2. Add these lines, or change the value if a [server] section is already there:

   [server]
   listenAddress = "127.0.0.1:8081"

3. Save the file and start Asterobot again.

4. Open http://127.0.0.1:8081 in your browser, so Asteroboard picks up the new address.

In MITM mode, the line Asterobot writes in your Dofus folder follows the new port by itself. How the parts connect also covers the two MITM ports.

The Server URL points somewhere else

Asterobot runs, its terminal shows Server listening, and Asteroboard still stays disconnected. Asteroboard connects to the address saved as its Server URL in the browser you use, and that address doesn't lead to your Asterobot. It happens after you change server.listenAddress, when the browser still holds the address of another Asterobot, such as a remote one or an SSH tunnel on another port, or after a typo.

1. On the computer where Asterobot runs, open http://127.0.0.1:8080 in the browser, with the port of server.listenAddress if you changed it. Asterobot sends you on to Asteroboard, which replaces its Server URL with that address.
2. From another device, or to type the address yourself, open Preferences, type it in Server URL with the scheme, the address and the port, such as http://127.0.0.1:8080, and press Enter.
3. Click Test connection.

Each browser keeps its own Server URL, one at a time. Preferences explains the field.

The address opens, but Asteroboard stays disconnected

This is almost always HTTPS or a password, set with server.tls and server.basicAuth. Asteroboard's own requests can't show a certificate warning or a password prompt, so they fail without a word until the browser has accepted both on a page you opened yourself.

From a phone or another computer

By default, Asterobot only accepts connections from the computer it runs on, so another device can't reach it at all. Opening it to your network takes a few settings and a restart: Asteroboard on another device walks through them, and Asterobot on a remote machine covers a server.

When you've done that and it still doesn't connect, check these:

• The address starts with https://. Browsers don't let the Asteroboard page, which is HTTPS, send plain http:// requests to another device. Only the device the browser runs on is allowed, which is why http://127.0.0.1:8080 works there and nowhere else. The other way around it is an SSH tunnel.
• Asterobot was restarted after you changed server.listenAddress, server.tls or server.basicAuth. None of them applies before.
• server.listenAddress no longer starts with 127.0.0.1, an address no other device can reach.
• The firewall of the computer running Asterobot accepts incoming TCP connections on the port.
• Your browser's permission. Some browsers ask whether asteroboard.asterobot.net can access devices on your local network. Allow it.
• The SSH tunnel is still open, if you use one. When it closes, Asteroboard shows Server disconnected, and connects again by itself once the tunnel is back.

Asteroboard itself doesn't load

Asteroboard's page comes from https://asteroboard.asterobot.net. The first time you open it in a browser, that browser needs an internet connection. After that, Asteroboard opens without one, as long as it can reach Asterobot.

Still stuck

• Read Asterobot's terminal. Server > Console only receives lines while Asteroboard is connected, so the terminal is the only place that shows what happened before.
• Ask on the forum or on Discord, with your Asterobot version, the address you use and the last lines of the terminal. Getting help lists what to include and what never to share.

Where to go next

• How the parts connect
• Preferences
• Status and console