Asteroboard, Asterobot and your Dofus client can each run on a different machine. Before you split them up, it helps to know which part talks to which, and on what address.
Every connection
- Your browser → Asterobot (port 8080)
- Your browser → asteroboard.asterobot.net
- Your browser → asterobot.net
- Your Dofus client, in MITM mode → Asterobot (ports 8080, 5555, 5556)
- Your Dofus client, in MITM mode → Ankama's servers
- Asterobot → Ankama's servers
- Asterobot → asterobot.net
| From | To | Default address | What it carries |
|---|---|---|---|
| Your browser | Asterobot | 127.0.0.1:8080 |
Everything Asteroboard shows and does, and its live updates. |
| Your browser | asteroboard.asterobot.net | The internet | The Asteroboard page itself, and its new versions. |
| Your browser | asterobot.net | The internet | Your asterobot.net name and avatar, shown on the account button and the Account page. |
| Your Dofus client | Asterobot | 127.0.0.1:8080 |
MITM mode only. The connection settings Dofus fetches before it signs in. |
| Your Dofus client | Asterobot | 127.0.0.1:5555 |
MITM mode only. The sign-in, which Asterobot passes on to Ankama. |
| Your Dofus client | Asterobot | 127.0.0.1:5556 |
MITM mode only. The game session, which Asterobot passes on to the game server. |
| Your Dofus client | Ankama's servers | The internet | Everything else Dofus uses. Asterobot only changes where it signs in and where its game session goes. |
| Asterobot | Ankama's servers | The internet | Game downloads, Ankama sign-ins, and the game servers your bots play on. |
| Asterobot | asterobot.net | The internet | Your asterobot.net sign-in, marketplace downloads, the update check and announcements from the Asterobot team. |
In MITM mode, where a bot relays the game you play (man-in-the-middle), port 8080 has two jobs: it's Asteroboard's port, and it's where Dofus fetches its connection settings. That's why the line Asterobot writes in your Dofus folder uses the port of server.listenAddress (MITM mode).
What Asterobot accepts by default
127.0.0.1 is the address a computer uses to reach itself. Asterobot listens on it by default, for all three ports, so no other machine can connect: not a phone on your Wi-Fi, not another PC, not anything on the internet. Programs running on the same computer can, and so can the other people who use that computer.
The sign-in and session ports aren't even open most of the time. Asterobot opens them when a bot starts waiting for your game, and closes them once no bot is waiting.
There's no password and no HTTPS by default either. As long as only this computer can reach Asterobot's ports, neither is needed. Security explains what changes once other machines can reach Asterobot.
These settings decide all of it. They're on Server > Config, and each one takes effect when Asterobot restarts.
| Setting | Default | What it decides |
|---|---|---|
server.listenAddress |
127.0.0.1:8080 |
The address and port Asteroboard connects to, and Dofus fetches its connection settings from. |
server.tls |
Off | Whether that port speaks HTTPS instead of HTTP. |
server.basicAuth |
Empty | The user names and passwords that port asks for. Empty asks for none. |
botmanager.mitmBindHost |
127.0.0.1 |
The network interface the sign-in and session ports listen on. |
botmanager.mitmAdvertiseHost |
Empty | The address Dofus is told to connect to. Empty uses botmanager.mitmBindHost. |
botmanager.mitmSignInPort |
5555 |
The sign-in port. |
botmanager.mitmSessionPort |
5556 |
The session port. |
Settings reference describes each setting in full, and The Config page shows how to change one.
Important
MITM mode stops working while server.tls is on or server.basicAuth is set, even on the computer Asterobot runs on, as MITM mode explains. When you need MITM mode and access from another machine, use an SSH tunnel: see Asterobot on a remote machine.
How Asteroboard finds your Asterobot
Asteroboard is the same page for everybody, so each browser has to be told where its Asterobot is. It keeps that address as its Server URL, in the browser.
The quickest way to set it is to open Asterobot's own address in the browser. Asterobot shows no page there: it sends the browser on to https://asteroboard.asterobot.net, adding the address, the port and the scheme (http or https) the browser used to reach it. Asteroboard saves them as its Server URL, removes them from the address bar and connects.
So Asteroboard uses exactly the address you opened. Open http://127.0.0.1:8080 on the computer where Asterobot runs, and that browser uses 127.0.0.1. Open https://192.168.1.20:8080 on a phone, and the phone uses 192.168.1.20. Each browser keeps its own Server URL, and only one at a time.
You can also type the address in Preferences, under Server URL. See Preferences.
When a port is already in use
Port 8080. Asterobot stops right after starting, with An error occurred during the server's initialization process. Since Asterobot isn't running, Asteroboard can't change the setting for you: edit config.toml instead (Files and folders shows where it is). Add these lines, or change the value if a [server] section is already there:
[server]
listenAddress = "127.0.0.1:8081"Start Asterobot again and open http://127.0.0.1:8081. In MITM mode, the line Asterobot writes in your Dofus folder follows the new port by itself.
Ports 5555 and 5556. A bot can't start waiting, and Asteroboard shows Couldn't put the bot into waiting. On Server > Config, change botmanager.mitmSignInPort or botmanager.mitmSessionPort, keep the two values different, and restart Asterobot. See MITM mode.
Pick your setup
| What you want | Where to go |
|---|---|
| Use Asteroboard on a phone, a tablet or another computer at home | Asteroboard on another device |
| Run Asterobot on a server, or on a computer you don't sit at | Asterobot on a remote machine |
| Play Dofus on one computer while Asterobot runs on another | MITM across machines |
Whatever you choose, read Security first. Anyone who reaches Asterobot's port can do everything you do in Asteroboard.
Where to go next
- Security, before you open anything.