Standalone installation

This page shall help you start using Congatudo with a standalone installation.

Get the binary from the releases

Go to congatudo releases page to download valetudo-armv7 and named only ‘valetudo’

Prepare a valid configuration file

In your machine, get a valid valetudo config file in from here.

Once you have already downloaded it and named as valetudo_config.json, edit the implementation of the Congatudo robot to CecotecCongaRobot and teh embebed property aswell:

{
  "embedded": true,
  "robot": {
    "implementation": "CecotecCongaRobot",
    ...
}

Copy the binary and its configuration to your robot

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

After that, you are able to copy the binary to your Conga.

⚠️ 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 root@<robot-ip>
root@TinaLinux:~# mkdir /mnt/UDISK/valetudo
root@TinaLinux:~# exit
$> scp -oHostKeyAlgorithms=+ssh-rsa -oPubkeyAcceptedAlgorithms=+ssh-rsa ./build/armv7/valetudo root@<robot-ip>:</mnt/UDISK/valetudo/valetudo>
$> scp -oHostKeyAlgorithms=+ssh-rsa -oPubkeyAcceptedAlgorithms=+ssh-rsa ./default_config.json root@<robot-ip>:</mnt/UDISK/valetudo/valetudo_config.json>

Create a script file to export the enviroment variable and run the server at boot in your robot

$> ssh -oHostKeyAlgorithms=+ssh-rsa -oPubkeyAcceptedAlgorithms=+ssh-rsa root@<robot-ip>
root@TinaLinux:~# vi /etc/init.d/valetudo

Add this script:

#!/bin/sh /etc/rc.common                                                                                                    
# File: /etc/init.d/valetudo
# Usage help: /etc/init.d/valetudo
# Example: /etc/init.d/valetudo start
START=85
STOP=99                                     
USE_PROCD=1                                                                                                                
PROG=/mnt/UDISK/valetudo/valetudo
CONFIG=/mnt/UDISK/valetudo/valetudo_config.json                                     
start_service() {                     
  procd_open_instance                 
  procd_set_param env VALETUDO_CONFIG_PATH=$CONFIG
  procd_set_param command $PROG    

  procd_set_param respawn ${respawn_threshold:-3600} ${respawn_timeout:-10} ${respawn_retry:-5}
  procd_close_instance                
}                                                                                                                          
shutdown() {                                                                                                            
  echo shutdown                                                                                                   
}

Make the init script and the binary executable:

root@TinaLinux:~# chmod +x /etc/init.d/valetudo
root@TinaLinux:~# chmod +x /mnt/UDISK/valetudo/valetudo

Point your Conga robot to Congatudo Server

Edit the /etc/hosts file to redirect all 3irobotix network domains to 127.0.0.1:

root@TinaLinux:~# echo "127.0.0.1 cecotec.das.3irobotix.net cecotec.download.3irobotix.net cecotec.log.3irobotix.net cecotec.ota.3irobotix.net eu.das.3irobotics.net eu.log.3irobotics.net eu.ota.3irobotics.net cecotec-das.3irobotix.net cecotec-log.3irobotix.net cecotec-upgrade.3irobotix.net cecotec-download.3irobotix.net" >> /etc/hosts

Enable Congatudo server at boot and reboot the robot

root@TinaLinux:~# /etc/init.d/valetudo enable
root@TinaLinux:~# reboot now

Finally

🎉 After completing these steps, your Congatudo server should be accessible at http://robot-ip

Uninstall Congatudo

This will remove Congatudo, free the diskspace and re-enable the cloud interface in case of a standalone installation.

$> ssh -oHostKeyAlgorithms=+ssh-rsa -oPubkeyAcceptedAlgorithms=+ssh-rsa root@<robot-ip>
root@TinaLinux:~# /etc/init.d/valetudo stop
root@TinaLinux:~# rm /etc/init.d/valetudo /mnt/UDISK/valetudo/valetudo /mnt/UDISK/valetudo/valetudo_config.json  
root@TinaLinux:~# sed -i '/cecotec.das.3irobotix.net/d' /etc/hosts
root@TinaLinux:~# reboot now