Overview
This document provides networking details that ensure your Tailos robot can successfully connect to Tailos services.
Benefits
While your robot can vacuum spaces without the need to connect the internet, doing so will provide the following benefits:
- Data Collection - Your robot transmits data about its cleaning performance each time it is being used. Transmission of this data allows Tailos and your team to know just how much and how well Rosie has cleaned.
- Notifications - Your robot must be connected to the internet to transmit data and is necessary for SMS notifications for you and your team.
- Software Updates - We routinely enhance your robot’s software and can deliver these improvements over-the-air. Staying connected to the internet ensures your robot will keep up-to-date with the latest software improvements.
- Diagnostics - Our team of experts is constantly monitoring your robot’s diagnostic data. Doing so allows us to reach out to your team proactively to ensure your robot is always in top shape.
Requirements
Network security is critical for robot operations at your facility. Below you will find the minimum requirements for secure access of your robots to your network.
Secure Network Access
Robots must be able to connect to a local WiFi network at your property. While this may be a pre-existing network, we recommend creating a separate isolated network for maximum security.
If using a pre-existing network, captive portals are commonly used to secure your facility’s WiFi networks. Since this requires interaction to authenticate, this approach prevents robot access to the network. Instead, we recommend allow-listing (also known as whitelisting) based on each device’s MAC address to ensure secure access to your WiFi network.
MAC addresses can be retrieved through either of the following methods:
From the Rosie Interface.
- Power on your robot.
- From the home menu, tap on the Settings Icon on the top left.
- Tap on “About Rosie.”
From the Robots page on Tailos Connect.
- Sign in to Tailos Connect at app.tailos.io
- The home page is the list of your Robots. Click on the three dots menu on the desired robot to view its information.
Ports
The following ports are necessary to reach our services.
Port Number |
Protocol |
Use |
---|---|---|
443 |
TCP |
HTTPS - Used to send telemetry to Tailos and get software updates. |
8443 |
TCP |
HTTPS alternative - Used for software updates. |
53 |
UDP |
DNS resolution. |
123 |
UDP |
Network Time Protocol |
DNS
Cloudflare (1.1.1.1) is the primary DNS server used by Tailos robot. Google DNS (8.8.8.8) is used as secondary DNS server. Ensure that your network does not block these DNS servers.
Endpoints
The robot will need to reach the following API endpoints to correctly transmit all data and get updates.
Tailos Service Endpoints
-
https://tailos.io and all subdomains of https://tailos.io (e.g. https://api.tailos.io)
- https://maidbot.io and all subdomains of https://maidbot.io (e.g. https://api.maidbot.io)
Third-party Endpoints
-
https://foundries.io and all subdomains of https://foundries.io (e.g. https://api.foundries.io)
- storage.googleapis.com
- time[1234].google.com
- time.cloudflare.com
- s3.amazonaws.com
For additional details on our third-party endpoints, please visit: Foundries.io Device Network Access.
Verification
We provide a public script will verify connectivity with Tailos and related third-party endpoints.
You can run this on a machine connected to the same network as Tailos robots to ensure the network is configured correctly for endpoint access. Note that robots may still not be able to connect to Tailos services if other network configurations are invalid (e.g. if a robot is not allow-listed for WLAN access).
Use
You can copy and paste any of these commands to run in a terminal on your local machine.
On Unix (Linux or macOS)
Using curl:
bash <(curl -s https://gist.githubusercontent.com/nckswt/c6e5543642a45e2c04fd5b40355464a5/raw)
Using wget:
bash <(wget -qO- https://gist.githubusercontent.com/nckswt/c6e5543642a45e2c04fd5b40355464a5/raw)
On Windows (using Git Bash or Windows Subsystem for Linux (WSL))
You can use the same commands as above in Git Bash or WSL like so:
wsl bash -c "$(curl -fsSL https://gist.githubusercontent.com/nckswt/c6e5543642a45e2c04fd5b40355464a5/raw)"
Additional Help
For additional help, please contact Tailos Support.
Call/Text: +1 (833) 824-5670
Email: support@tailos.com