Personal tools

User Guide

From UntangleWiki

Jump to: navigation, search

The Untangle User Guide


Getting Started

If you have not already installed Untangle, read the Installation Guide.

The Administration Interface

The Administration Interface is the main interface used to configure Untangle. A welcome message is displayed upon the first visit to the administration interface. It will make a suggestion about the suggested applications that may be useful for your network. You can follow the welcome screen suggestion or just close the welcome screen and install the applications manually.

Untangle's web GUI with trial applications installed

Untangle's administration can be divided into two main parts, the Navigation Pane on the left and virtual Racks on the right.

The Navigation Pane contains two tabs - Apps and Config, detailed below. The Apps tab on the left-hand side is used to learn more about applications and install applications into the "virtual rack." The Config tab contains several sections to configure the Untangle server's settings.

Applications are installed into one or more virtual Racks on the right hand side, and filter the traffic passing through the Untangle server. Each application has a faceplate with a Settings button to configure it, current status information and a power button to toggle it on or off.

Across the top there is a dropdown menu to switch to different Racks or use the Session Viewer and Host Viewer, as well as readouts for network speed statistics, a count of open sessions, CPU, memory, and disk information.

If you see an alert icon near the top of the web GUI, hover over it for more information - these are Administrative Alerts designed to help you keep your Untangle healthy.

Tip: Using Mozilla Firefox or Google Chrome browsers is recommended for administration.


Applications are little plugins that add functionality to your Untangle server - just like apps on an iPhone or Android device. They can be installed using the buttons in the Apps tab on the left hand side. Each application has a different task like protecting your network or controlling what happens on your network.

To install an application, click on icon on the left hand side. Once installed the application's settings can be configured by clicking on the Settings button. The power button can be used to turn the application on or off. Applications install with the suggested configuration which is the default settings and on/enabled in most cases. An application that is off/disabled will not process any network traffic.

The Help button will take you directly to that applications documentation.

The faceplate of the application (the virtual appliance) often contains graphs and statistics. Clicking on the graph will open the Session Viewer for that application and clicking on the statistics will allow you to configure which statistics are displayed.

After clicking Settings, you will be presented with tabs for different sections, as well as typical buttons marked OK, Cancel and Apply. They work just like you think they do. On the left hand side there is a Remove button which will remove the application from the rack. Untangle offers two types of Applications:

There are two types of Applications:

  • Filter Applications All the Applications above the Services pane in the interface can have one instance per virtual rack.
  • Service Applications All the Applications below the Services pane are global and exist in all virtual racks.

Many networks only need one virtual rack which means all traffic gets processed by the same apps and same configuration, but multiple racks/policies are possible for bigger networks. For more information about running multiple racks check out the Policy Manager application.

To learn more about each application use the links below.

Filter Applications

Web Filter Web Filter Lite Virus Blocker Virus Blocker Lite Spam Blocker Spam Blocker Lite
Phish Blocker Web Cache Bandwidth Control Application Control Application Control Lite HTTPS Inspector
Captive Portal Firewall Intrusion Prevention Ad Blocker

Service Applications

Reports Policy
OpenVPN Configuration

Network Configuration

Network configuration and common configuration scenarios are describe in the Network Configuration documentation.

Event Log

Event Logs are present through many much of the UI to allow administrators to visualize what the Untangle and applications are doing. Event Logs are described in the Event Log documentation.


This is an list of all settings available under the Config tab in the Administration UI.


The Network configuration contains all the settings to control how your Untangle server routes and handles network traffic. Properly configuring network settings is critical for proper operation.

The Network Configuration documentation documents how networking in Untangle functions and is commonly configured.


Administration controls the administration-related functionality of the Untangle server.


Email contains all the email-related configuration of the Untangle server.

Local Directory

Local Directory stores a list of users that can be used by the applications.


Upgrade allows the server to upgrade and contains upgrade-related settings


System contains settings related to the server


About contains system information