How to Set Up IPTV on Enigma2/Zgemma via Putty (2026)

Key Takeaways

• IPTV on Enigma2/Zgemma via Putty involves SSH access, plugin installation, and M3U playlist configuration
• The most reliable Enigma2 IPTV plugin is E2m3u2bouquet, which converts M3U lists into native channel bouquets
• Putty is the standard Windows SSH client for remote access to your Enigma2 box
• Your Enigma2 box and PC must be on the same network for SSH to work
• This setup is more technical than app-based IPTV but delivers a deeply integrated TV experience

---

Setting up IPTV on Enigma2 and Zgemma boxes via Putty is the most technically involved IPTV setup in this guide series — but it's also one of the most rewarding. Enigma2 is a full Linux-based operating system powering premium satellite receiver boxes like Zgemma, Vu+, and Dreambox. When IPTV is configured correctly on Enigma2, it integrates seamlessly into the native channel list — your IPTV channels appear alongside satellite channels, EPG works natively, and everything is controlled with your familiar satellite remote.

This guide uses E2m3u2bouquet as the IPTV plugin (the most trusted option) and Putty for SSH access. If you're new to SSH, don't be intimidated — we'll give you every command exactly as you need to enter it.

Before starting, have your IPTV provider's M3U URL ready. Check our top 5 IPTV providers in the USA if you need a provider that offers M3U format.

---

What You Need

• Zgemma or other Enigma2 receiver (H.2S, H.9S, i55, Star H2, or similar)
• Enigma2 image installed (OpenATV, OpenPLi, OpenViX, or similar)
• PC with Putty installed (download from putty.org)
• Both devices on the same local network
• IPTV subscription with an M3U URL
• Basic comfort with following technical instructions

---

Step 1: Find Your Enigma2 Box's IP Address

Your Enigma2 box needs to have an IP address on your local network to connect via SSH.

Method A — Using the Enigma2 Menu:

1. On your Enigma2 box, press the Menu button on the remote
2. Navigate to Setup → System → Network → Adapter Settings → LAN Adapter
3. Note the IP Address displayed (it will look like 192.168.1.XXX)

Method B — Using Your Router: Log in to your router's admin panel (usually 192.168.1.1) and look for connected devices. Find your Enigma2 box in the device list.

---

Step 2: Download and Install Putty

On your Windows PC, go to putty.org and download the Putty installer. Run the installer and complete the standard setup. Open Putty from the Start Menu.

(Mac users: macOS has a built-in SSH client. Open Terminal and use ssh root@192.168.1.XXX instead of Putty.)

---

Step 3: Connect to Your Enigma2 Box via SSH

In Putty:

1. In the Host Name field, enter your Enigma2 box's IP address (e.g., 192.168.1.100)
2. Set the Port to 22 (default SSH port)
3. Ensure Connection type is set to SSH
4. Click Open

A terminal window opens. You'll see a login prompt.

Enter the credentials:

• Login as: root
• Password: dreambox (default on most Enigma2 images — check your image documentation if this doesn't work)

Once logged in, you'll see a command prompt like root@dreambox:~#.

---

Step 4: Update Your Enigma2 Package List

Before installing any plugin, update the package manager to ensure you get the latest versions:

opkg update

This may take 30–60 seconds. You'll see a series of feed download messages.

---

Step 5: Install E2m3u2bouquet Plugin

E2m3u2bouquet is the most popular and reliable Enigma2 IPTV plugin. Install it with:

opkg install enigma2-plugin-extensions-e2m3u2bouquet

If this returns an error because the package isn't found in your feed, use the alternative pip-based installation:

wget -q "https://github.com/m3u2bouquet/e2m3u2bouquet/archive/master.tar.gz" -O /tmp/e2m3u2bouquet.tar.gz
tar -xzf /tmp/e2m3u2bouquet.tar.gz -C /tmp/
cp -r /tmp/e2m3u2bouquet-master/* /usr/lib/enigma2/python/Plugins/Extensions/

---

Step 6: Restart the Enigma2 Interface

After installation, restart the Enigma2 frontend to load the new plugin:

killall -9 enigma2

Your Enigma2 box will restart its software interface (the TV screen will go black briefly then reload). This is normal.

---

Step 7: Configure E2m3u2bouquet with Your M3U URL

After the restart, access the E2m3u2bouquet settings on your Enigma2 box:

1. Press the Menu button on your remote
2. Navigate to Plugins (or press the Plugin button if your remote has one)
3. Find and open E2m3u2bouquet
4. The plugin's configuration screen opens

In the configuration:

• M3U Provider URL: Enter your IPTV subscription M3U URL
• EPG Provider URL: Enter your XMLTV EPG URL (from your provider)
• Auto update interval: Set to your preference (e.g., 24 hours)
• Number of bouquets: Choose how to organize channels (by group, by category, etc.)
• Map to EPG: Enable this for automatic EPG matching

Select Run Setup and the plugin will download your M3U, parse the channel list, and create native Enigma2 bouquets.

---

Step 8: Verify Bouquet Creation

After the setup completes, your Enigma2 channel list will include new bouquets (groups) containing all your IPTV channels. On your remote, use the Bouquet +/- buttons to navigate between channel groups, or press the Bouquet button to see all available bouquets.

Your IPTV channels should now appear in the channel list alongside any satellite channels you have.

---

SSH Command Reference Table

| Command | Purpose | |---|---| | opkg update | Update package list | | opkg install [package] | Install a package | | killall -9 enigma2 | Restart Enigma2 interface | | opkg list-installed | List all installed packages | | df -h | Check disk space | | reboot | Reboot the entire device | | cat /etc/image-version | Check current Enigma2 image version | | opkg remove [package] | Uninstall a package | | ls /media/hdd/ | List files on USB storage | | wget [URL] -O [filename] | Download a file |

---

Step 9: Configure EPG on Enigma2

For the best EPG (TV guide) experience on Enigma2:

1. In E2m3u2bouquet settings, ensure EPG Provider URL is filled with your XMLTV feed
2. In your Enigma2 menu, go to Setup → Service Searching → AutoBouquets Maker (if available) or EPG Settings
3. Enable Download EPG after channel scan
4. Set EPG refresh to daily

Your program guide will then populate automatically, showing what's on each channel now and in the upcoming hours/days.

Pro Tip: On OpenATV and OpenPLi images, the EPG import can be automated by adding a cron job. Connect via Putty and run: echo "0 4 * * * python /usr/lib/enigma2/python/Plugins/Extensions/E2m3u2bouquet/e2m3u2bouquet.py -m yourm3uurl" >> /etc/crontab — this updates your IPTV bouquets daily at 4 AM automatically.

---

Step 10: Test Your Setup

Return to your Enigma2 TV interface and navigate to your newly created IPTV bouquets. Select a channel and press OK to start streaming. The channel should play within a few seconds.

Test multiple channels across different categories (sports, news, entertainment) to verify your full subscription is working.

---

Troubleshooting Enigma2 IPTV

SSH connection refused (Putty shows "Connection refused"):

• Verify the IP address is correct
• Ensure the Enigma2 box is fully booted
• SSH may not be enabled — check your Enigma2 image documentation for enabling SSH

E2m3u2bouquet plugin not found in opkg:

• Your Enigma2 image may use a different repository
• Try adding the E2m3u2bouquet repository manually, or use the wget installation method from Step 5

Bouquets created but channels show "Service unavailable":

• Your M3U URL may have expired or changed — get an updated URL from your provider
• The stream format may not be compatible with your box — contact your provider

EPG not matching channels:

• EPG mapping relies on channel names matching EPG IDs
• In E2m3u2bouquet settings, try enabling "Auto EPG Mapping"
• Manually map channels that don't auto-match

For general streaming quality issues, see our IPTV buffering fix guide.

---

Conclusion

Setting up IPTV on Enigma2 via Putty is the most technically demanding setup in our guide series, but the result is deeply integrated IPTV that feels completely native to your Enigma2 environment. Your IPTV channels become first-class citizens in your channel list, EPG works across all of them, and you navigate everything with the same remote you use for satellite TV.

For users who want a simpler IPTV setup without SSH, see our Fire Stick IPTV guide or our Smart TV setup guide. And for understanding M3U playlists in depth, our M3U playlist guide is the perfect companion resource.