Robot setup

It is needed for the robot to know wich server it has to attend so then, it should be connected to your local network and point it to the Congatudo server. This is the purpose of the following steps

Connect the robot to your local network

First, you need to have your robot connected througth your wifi to get shell access. If you already have it, you can jumpthis section, otherwise, you can use the agnoc tool form your computer to establish the connection.

$> npm install -g @agnoc/cli 
$> agnoc wlan <wifissid> <pass>

Get root access in your Conga

⚠️ If you need to reset or recover the root password, refer to the root password recovery guide.

1. Check that you have SSH installed and working in your computer (Linux/MacOS by default, use Putty in Windows)
2. You have to find out the IP address of your Conga (see this guide on how to)

3. Open an SSH connection to your Conga. Replace 192.168.x.x with your Conga’s actual IP address:

   ⚠️ Important: Since OpenSSH 8.8 (released October 2021), the ssh-rsa algorithm is disabled by default due to security concerns. To connect to older robots that require ssh-rsa, you must explicitly enable it using the options below. Be aware that this method is less secure and should only be used if necessary.

    $> ssh -oHostKeyAlgorithms=+ssh-rsa -oPubkeyAcceptedAlgorithms=+ssh-rsa [email protected]
   

   and when you get the login prompt, type root and then the password depending on your model:

   • for 3090: 3irobotics¹
   • for 3x90, 4090 & 5490: @3I#sc$RD%xm^2S&²
4. You should see something like this:
5. Now, it would be a good practice to:
   • Change the password (to something non-default and secure 🙏)
   • Add certificates (ssh key-pair) to access via ssh without passwords

Choose your installation method

Now you need to choose how to install Congatudo on your server. You can use one of the following methods:

• Home Assistant Add-on: Recommended if you are running Home Assistant. This method provides seamless integration and easy updates.
• Docker: Suitable for most environments. Use this if you want a containerized setup.
• Standalone: For users who prefer manual installation and full control.

Follow the link for your preferred method to continue with the installation.

Notes

1. Model 3090 original password hash $1$ZnE1NgOT$oWafIj8xgsknzdJmRZM9N/ == 3irobotics ↩

2. Model 3x90 original password hash $1$trVg0hig$L.xDOM91z4d/.8FZRnr.h1 == @3I#sc$RD%xm^2S& ↩