Enigma2 with PuTTY: Complete SSH Setup & Command Guide

Topic: Advanced Enigma2 Management | Difficulty: Intermediate | Tools: PuTTY (Windows)

Looking to unlock true power-user control of your Enigma2 receiver? SSH access via PuTTY gives you command-line mastery, letting you troubleshoot, automate, and configure your box in ways the GUI can't. This guide covers everything from your first connection to essential command examples.



📡 Part 1: Initial PuTTY Setup & Connection


Step 1: Enable SSH on Your Enigma2 Box

Before connecting, SSH must be active on your receiver:

  1. Go to MENU > Setup > System > Network
  2. Select Password & Security (or similar, varies by image)
  3. Ensure SSH or Enable SSH is set to Yes/Enabled
  4. Note your receiver's local IP address


Step 2: Configure PuTTY on Windows

  1. Download PuTTY from the official site (putty.org) - use the standalone .exe
  2. Launch PuTTY and enter connection details:
    • Host Name: Your receiver's IP (e.g., 192.168.1.100)
    • Port: 22
    • Connection Type: SSH
  3. Save your session for quick future access:
    • Enter a name (e.g., "My_Enigma2_Box")
    • Click Save



Step 3: First Login

  1. Click Open to start the connection
  2. Accept the security alert (first time only)
  3. At the login prompt, enter:


Code
login as: root
password: [password must first be setup on Enigma2 image to gain access]
  1. Note: Most images require a password to be setup first to gain access - Create password for FTP: OE-A images
  2. You should see a command prompt ending with ~# - you're in!


⚙️ Part 2: Essential Enigma2 SSH Commands (Cheat Sheet)

Save these commands for daily use. Most require root access (which you have).


System Control & Information

Code
reboot                           # Restart the entire receiver
init 4                           # Stop Enigma2 GUI (safe mode for edits)
init 3                           # Restart Enigma2 GUI
top                              # Live system resource monitor (Ctrl+C to exit)
df -h                            # Check disk space usage
free -m                          # Check RAM usage


File & Configuration Management

Code
cd /etc/enigma2                  # Navigate to main config directory
ls -la                           # List files with details
nano bouquets.tv                 # Edit channel list with nano editor
cp file.conf file.conf.backup    # Create backup before editing


Service Management

Code
/etc/init.d/enigma2 restart      # Restart Enigma2 service only
/etc/init.d/networking restart   # Restart network services


Package & Plugin Management (opkg)

Code
opkg update                      # Update available package list
opkg list-installed              # Show all installed plugins/packages
opkg install plugin-name         # Install a specific plugin
opkg remove plugin-name          # Remove a plugin


Logs & Troubleshooting

Code
tail -f /var/log/messages        # Monitor system logs in real-time
dmesg | tail -20                 # View last 20 kernel messages
ps aux | grep enigma2            # Check if Enigma2 process is running


🔐 Part 3: Security & Best Practices

⚠️ Important: With great power comes great responsibility. SSH access is essentially "root" control.

Change the Default Password (Immediately!)

Once logged in, run:


passwd


Then enter and confirm a strong new password.

Create an SSH Key Pair (Advanced/Secure)

For password-less, more secure login:

  1. Generate keys on your PC with PuTTYgen
  2. Upload the public key to /root/.ssh/authorized_keys on the receiver
  3. Disable password authentication in /etc/ssh/sshd_config (advanced)

Disable SSH When Not Needed

For long periods of non-use, go back to MENU > Setup > System > Network and disable SSH.



🚨 Part 4: Common Issues & Fixes

"Connection Refused" Error

• SSH is not enabled on the receiver (go back to Part 1, Step 1)

• Wrong IP address - double-check in your receiver's network settings

• Firewall blocking port 22

"Access Denied" / Login Failures

• Incorrect username (should be root)

• Password was changed and forgotten

• Try blank password if you never set one

Session Disconnects After Inactivity

In PuTTY, before connecting:

  1. Go to Connection
  2. Set "Seconds between keepalives" to 60
  3. This sends a small packet every minute to keep the connection alive



📂 Part 5: Useful File Paths to Know

PathPurpose
/etc/enigma2/All settings, bouquets, auto timers
/usr/lib/enigma2/python/Plugin installation directory
/media/hdd/movie/Default recording location
/tmp/Temporary files, upload .ipk files here for install
/var/log/System and Enigma2 logs


Pro Tip: Always run init 4 before editing critical files and init 3 after to restart the GUI cleanly.