EdgeRouter - Add Debian Packages to EdgeOS


Readers will learn how to add other/custom Debian packages to EdgeOS using the Debian repositories.

Applicable to the latest EdgeOS firmware on all EdgeRouter models. Please see the Related Articles below for more information.
Device used in this article:

Add Debian Packages

Back to Top

There are size and compatibility limitations to which packages can be added to EdgeOS. Most small utility packages can be installed, but there are limitations that need to be considered:

  • Packages that require kernel features that are not supported by EdgeOS.
  • Packages that need more storage space than the router can offer.
  • Packages that use a lot of CPU or RAM resources.
  • Packages that are not compatible with BusyBox can cause issues with packages that rely on BusyBox.
  • Installed packages are lost on firmware upgrades. See this article for more information on preserving package changes through upgrades.
CLI: Access the command line interface (CLI). You can do this using the CLI button in the GUI or by using a program such as PuTTY.

1. Enter configuration mode.


2. Add a Debian repository.

set system package repository wheezy components 'main contrib non-free' 
set system package repository wheezy distribution wheezy
set system package repository wheezy url http://http.us.debian.org/debian
NOTE: This example uses the US repository. See this page for the worldwide Debian mirror list.

3. Commit the changes and save the configuration.

commit ; save

4. Update the local cache.

sudo apt-get update
ATTENTION: Do not use the apt-get upgrade command as it can break the customized Debian packages used in EdgeOS.

5. Search for the package you wish to install. In this example, the dnsutils utility is added to EdgeOS.

sudo apt-cache search dnsutils

6. Install the package.

sudo apt-get install dnsutils

7. Test out the newly installed package.

sudo dig @ google.com

Related Articles

Back to Top

Intro to Networking - How to Establish a Connection Using SSH

We're sorry to hear that!