Linux Agent Installation

Use this guide to control a Linux machine (Ubuntu/Debian/Mint) remotely. Note that X11 Display Server is required (Wayland support is experimental).

1. Quick Install

Run these commands in your terminal to download and install the agent automatically.

# 1. Download the installer
wget https://rederel.com/downloads/install_rederel.sh

# 2. Make it executable
chmod +x install_rederel.sh

# 3. Run as Root
sudo ./install_rederel.sh

2. Troubleshooting

Error: "/bin/bash^M: bad interpreter"

Symtoms

The script fails to run immediately. If you open it in VI, you see ^M at the end of every line.

Cause: The file has Windows Line Endings (CRLF) instead of Linux (LF). This happens if you saved the file on Windows before uploading.

The Fix: Run this command to strip the bad characters:

sed -i 's/\r$//' install_rederel.sh

Then try running the installer again.

Error: "Python 3.10+ is required"

Symtoms

Installer stops and says your Python version (e.g., 3.8) is too old.

Cause: You are running an older Linux distro (like Ubuntu 20.04). Rederel requires modern AsyncIO features found in Python 3.10 or newer.

The Fix: Install Python 3.12 side-by-side.

# 1. Add the Deadsnakes PPA
sudo add-apt-repository ppa:deadsnakes/ppa -y
sudo apt update

# 2. Install Python 3.12
sudo apt install python3.12 python3.12-venv python3.12-tk -y

# 3. Force the installer to use the new version
sed -i 's/python3/python3.12/g' install_rederel.sh

# 4. Run installer again
sudo ./install_rederel.sh

3. Usage

Once installed, you can start the agent from any terminal window:

rederel

A window will appear asking for your Registration Code (Get this from your Dashboard).