Skip to main content

Viewing Global Deployments

Published on:
.
7 min read

The Global Deployments page in Zenconsole is a centralized dashboard that provides a complete overview of your organization’s network deployments. It allows administrators to see all gateways and endpoints in one place, presented in both map and list formats.

Global Deployments feature is especially valuable for organizations that have multiple locations, remote users, or distributed infrastructures. By consolidating visibility into a single interface, the Global Deployment View enhances control, efficiency, and security.

tip

Global Deployment View is only available for SSE and higher editions.

Benefits of Global Deployments View​

Understanding the benefits of the Global Deployment View is essential for organizations that want to improve visibility, simplify operations, and strengthen the security of their network infrastructure. By consolidating information into a single dashboard, administrators gain valuable insights and can act faster to maintain a healthy and secure environment.

  • Unified Visibility: With the Global Deployment View, you can gain a complete picture of your entire network at a glance. Instead of logging into multiple devices, the Global Deployment View brings everything together in one place. Administrators can quickly understand the current status of all gateways and endpoints.

  • Operational Efficiency: With centralized control, you can manage your deployments more effectively and save time on routine tasks. Adding new gateways or endpoints requires only a few clicks. Updates and monitoring can be performed without switching between different systems.

  • Real-Time Monitoring: With live insights into device activity and health, you can stay informed about the status of your network at all times. The Last Seen status helps identify inactive devices. Map and list views make it easy to spot issues and act immediately.

  • Simplified Troubleshooting: By identifying and resolving issues faster, you can reduce downtime and improve the reliability of your network. Offline gateways or outdated engine versions are visible at a glance. It helps administrators quickly isolate and fix potential problems.

  • Enhanced Security: Keep your organization safe by ensuring only secure connections are part of your deployment. This minimizes the risk of unsecured or unauthorized devices accessing the network.

Accessing Global Deployments View​

The Global Deployments View is built to be user-friendly and intuitive. By following the steps below, you can quickly access the page, explore its features, and manage your deployments with ease.

  1. Open your browser and navigate to Zenconsole.

  2. Enter your username and password.

  3. Once logged in, the left-hand sidebar will display the navigation menu.

  4. Click Global Deployments on the left-hand sidebar.

  5. The menu will expand to show the following sub-options:

    • Gateways & Endpoints
    • Devices on Gateways

    Figure 1. Global Deployments Menu

tip

Think of this menu as your “control tower” for managing your organization's networks.

Once you have accessed the Global Deployment View, you can perform several key actions that help you monitor, manage, and expand your secure network.

  • Explore Gateways & Endpoints: You may view all gateways and endpoints in a unified list, filter by type, and check details like engine version, location, and last seen status.
  • Explore Devices on Gateways: You may view which user devices are connected through each gateway and check their online/offline status.
  • Use the Map and Statistics Panel: You may gain quick visual insights into where your deployments are located and how many devices are online.
  • Add New Devices: You may easily register new gateways or endpoints to expand your secure network.

These actions cover the core functionality of the Global Deployment View, giving you complete visibility and control over your organization’s secure networks.

Exploring Gateways & Endpoints​

This section provides an overview of all gateways and endpoints in your organization. It is the central place where you can review all registered devices and their current status in one table.

To view all gateways and endpoints in your organization, click Gateways & Endpoints in the left navigation. At the top of the table, you will notice three tabs that are shared below.

  • All: Displays all gateways and endpoints together in a single list.
  • Gateways: Filters the list to show only gateway devices.
  • Endpoints: Filters the list to show only endpoint devices.
tip

The All tab provides a quick overview, while the Gateways and Endpoints tabs allow you to focus on specific device types.

Figure 2. Gateways & Endpoints

Management Bar​

The Management Bar sits directly above the instance table. From left to right, you will see the following buttons.

  • Search
  • Rows‑per‑page selector (e.g., “10”)
  • Download
  • Refresh

Figure 3. Management Bar

Searching Zenarmor Instances​

You can find the Search field with a magnifying glass icon on the left side of the Management Bar. The search function allows you to quickly find specific gateways or endpoints by using keywords such as the instance name, user email, and location. The table will instantly update to show only matching entries.

You can follow these steps to search for Zenarmor instances.

  1. Click into the Search field on the Management bar at the head of the Global Deployment View page.
  2. Type a keyword (e.g., Lab-OPNsense-VM, [email protected]).
  3. The list will automatically filter in real time as you type. You may clear the search by deleting the text to return to the full list.

Figure 4. Searching Instances

tip

Combine the search with the category tabs (All / Gateways / Endpoints) to narrow the scope. If you don’t see expected results, check that filters are cleared and the correct tab is selected.

Listing Zenarmor Instances (Rows per page)​

You can control how many instances are shown on a single page by using the rows-per-page selector, which is located right next to the Search field on the Management Bar. It is represented by a stack icon and a number (for example, 10).

You can follow these steps to list Zenarmor instances.

  1. Click the rows‑per‑page selector.

  2. Choose the number of rows for the Zenarmor instances list. This will be automatically applied to your view. Available options are as follows:

    • 10
    • 20
    • 50
    • 100
    • All

Figure 5. Listing Instances

Exporting Zenarmor Instances​

You can export the currently displayed list of instances, including any active filters and the visible columns, by using the Download button with a download icon on the right side of the Management Bar.

You can follow these steps to export Zenarmor instances.

  1. Navigate to the Global Deployment View page on Zenconsole.

  2. Click Download on the management bar. This will open a drop-down menu.

  3. Click CSV to export your Zenarmor instances list into a CSV file. This will open a dialog box.

    Figure 6. Exporting Instances

  4. You may rename the CSV file or browse on your local disk and then click the Save button.

    Figure 7. Saving the CSV File

tip

The export reflects exactly what is currently displayed, so make sure to refine the list using the category tabs (All / Gateways / Endpoints) or the search field before exporting.

Refreshing the Instance List​

You can refresh the Zenarmor instances table on Global Deployment View page at any time to retrieve the latest data from Zenconsole by using the Refresh button with a circular arrow icon at the end of the Management Bar.

After adding a new Gateway/Endpoint or when you expect status changes (e.g., Last Seen timestamps), you may click the Refresh button on the management bar to reload the Zenarmor instances table.

tip

If the list still looks outdated after refreshing, make sure you are on the correct tenant and category tab, and check your network connection before trying again.

Viewing the Instance List​

The Zenarmor instance list on the Global Deployment View page displays important details for each instance. Each row in the table represents a single instance. The following columns provide key details:

  • Instance Name: Identifier of the instance(e.g., cp-1, Lab-OPNsense-VM).
  • User Email: Linked account for that instance.
  • Engine Version: Zenarmor software version running.
  • Location: Geographical placement of the instance.
  • Overlay Networks: Configured private secure networks (if any).
  • Devices: Number of connected instances under a gateway.
  • Last Seen: Time elapsed since the last detection of the Zenarmor instance.
  • Actions: Quick actions you can perform on this instance (explained below).

Sorting Instance List​

You can click any column header (for example, User Email or Location) to sort the list based on that property, either ascending or descending.

Figure 8. Instance List

Filtering Instance List​

Hangi field lere gore nasil Filter/exclude yapildigini aciklayalim.

The Zenarmor Instance List on the Global Deployment View page allows you to filter or exclude instances to narrow down the displayed results. This feature helps administrators quickly locate specific gateways or endpoints.

You can follow these steps to filter Zenarmor instances.

  1. Navigate to the Global Deployment View page on Zenconsole.

  2. To apply a filter, click on the value inside one of the filterable columns. A small menu will appear with two options:

    • Filter: Click this option to show only the rows that match the selected value.
    • Exclude: Click this option to hide all rows that match the selected value.
    tip

    Filtering is available for the following fields.

    • User Email: Filter instances by the email address associated with the instance.
    • Engine Version: Filter instances by the running software version.
    • Location: Filter instances by the geographical location of the instance.

  3. You can add additional filters from different fields (e.g., filter by Engine Version and then by Location). This helps narrow down results more precisely.

    Figure 9. Filtering Instances

  4. All applied filters and exclusions are displayed at the top of the Instance List. Each filter is shown as a tag, indicating whether it is an inclusion (=) or exclusion (≠). To clear all filters at once, either manually remove each tag with the “×” icon or click the Refresh button on the top-right corner.

    Figure 10. All Applied Filters

Actions​

Each instance row has a three-dot menu under the Actions column. Available options differ slightly depending on whether the instance is a Gateway or an Endpoint.

Triggering Update​

This action forces an immediate policy update on the selected gateway or endpoint instance.
Normally, Zenconsole applies policy updates periodically, but this option ensures that any critical policy changes are pushed right away, overriding the usual schedule.

You can follow these steps to trigger an update.

  1. Locate the instance you want to update in the instance list.

  2. At the end of that row, find the Actions column.

  3. Click the (Actions) button with … icon for the desired instance.

  4. Select Trigger Update from the dropdown menu.

    Figure 11. Triggering Update

  5. A confirmation window titled Trigger Immediate Policy Update will appear.

    Figure 12. Trigger Immediate Policy Update

  6. Click Start Immediate Policy Update to begin.

  7. Once the request is sent, a green confirmation message appears stating: "Policy update request sent. All instances will receive the policy update shortly. This may take a while. You can close this window safely."

Use this feature after making important configuration or policy changes to ensure they are applied to all devices without delay.

Accessing Device Management (Gateways Only)​

This action opens the Device Management view for the selected gateway.
It allows you to see all user devices connected through that gateway, monitor their status, and manage device identification settings.

You can follow these steps to access the device management.

  1. Locate the gateway instance you want to manage in the instance list.

  2. Click the (Actions) button with … icon to open the context menu.

  3. Select Manage Devices from the dropdown menu.

    Figure 13. Manage Devices

  4. The Device Management page will open, listing all devices associated with the selected gateway.

For detailed information about how device identification works and how to configure it, see the official documentation: Device Identification Overview.

Accessing Firewall Settings (Gateways Only)​

This action opens the Firewall Settings page for the selected gateway instance. It allows you to configure security policies, adjust filtering rules, and manage other firewall-related settings specific to that gateway.

You can follow these steps to access the firewall settings.

  1. Click the Actions button with … icon to open the context menu.

  2. Select Settings from the dropdown menu.

    Figure 14. Settings

  3. The Firewall Settings page will open, where you can review and update security configurations for the selected gateway.

Use this section whenever you need to change firewall rules or security policies applied to a specific gateway.

Updating Endpoint Slug (Endpoints Only)​

This option allows you to change the slug (name/identifier) of an endpoint instance. Slugs are used to uniquely identify endpoints within the console, making them easier to recognize.

You can follow these steps to update an endpoint slug.

  1. Click the Actions button with the … icon on the right side of that row.

  2. Select Edit Slug from the dropdown menu.

    Figure 15. Edit Slug

  3. In the Change Slug pop-up window, enter the new name/slug for the endpoint.

    Figure 16. Change Slug Pop-up

  4. Click Change to apply the update.

tip

Use clear and descriptive slugs (e.g., cp-1, sales-laptop, branch-office) to make it easier to track endpoints.

Removing an Endpoint (Endpoints Only)​

This option allows you to remove an endpoint instance from your organization. Once removed, the endpoint will no longer appear in the list or be managed by your tenant.

You can follow these steps to remove an endpoint.

  1. Click the Actions button with the … icon on the right side of that row.

  2. Select Remove from the dropdown menu.

    Figure 17. Removing an Endpoint

  3. In the Warning confirmation dialog, review the endpoint details.

    Figure 18. Warning Pop-up

  4. Click Remove to finalize the deletion.

note

Removing an endpoint cannot be undone. You will need to re-enroll the device if you want to add it back later.

Adding a New Gateway​

Expanding your organization's network is simple with the Global Deployment View. You can easily add new gateways from the dashboard, ensuring that the entire organization stays protected and manageable. This process requires only a few clicks and supports multiple platforms and operating systems.

Adding a new gateway. This is especially useful for branch offices, virtual environments, or cloud-based infrastructures. Follow the steps below to add a gateway.

  1. Navigate to the Global Deployment View page on Zenconsole.

  2. Click + Add Gateway on the Global Deployment View page.

    Figure 19. Adding a Gateway

  3. After clicking + Add Gateway, the Add a Gateway to Your Deployment panel opens.

  4. At the top of this panel, a banner displays a one-time installation script with a countdown timer.

    Figure 20. One-time Installation Script

  5. Copy the command and run it **on the target device **with administrator/root privileges.

  6. The installer downloads the required components and completes registration. Within a few minutes, the device appears under Gateways in Zenconsole.

    tip

    With gateways, you extend your organization’s secure perimeter, ensuring that all traffic passes through trusted control points.

Adding a New Endpoint​

Endpoints are user devices such as laptops, desktops, servers, or Android devices that require secure connectivity. By registering endpoints, you can ensure that every device is visible and protected within the deployment. This process is straightforward and supports multiple operating systems. To add an endpoint, follow the steps below.

  1. Click + Add Endpoint.

    Figure 21. Adding an Endpoint

  2. Choose your operating system (Windows, macOS, or Linux).

  3. Select one of the installation methods.

    Figure 22. Adding an Endpoint to Your Deployment Page

  4. After installing Zenarmor on your endpoint, the endpoint will automatically appear in the Endpoints tab.

    tip

    Adding endpoints guarantees that individual devices are securely connected and monitored, preventing gaps in visibility or protection.

Using the Map and Statistics Panel​

On the right-hand side of the screen, you can find a Map and Statistics Panel that provides a quick overview of your global deployments.This panel visually shows the geographical distribution and the current online status of all your gateways and endpoints.

Zenarmor Global deployment map and statistics panel includes the following sections:

  • Map View: Displays the geographical location of gateways and endpoints.
    • Blue circles represent gateways
    • Purple circles represent endpoints
    • Larger circles indicate multiple instances clustered in the same area.
  • Global Deployments Bar: Shows the total number of instances (both gateways and endpoints).
  • Online Gateways Bar: Shows how many gateways are currently active (blue bar)
  • Online Endpoints Bar: Shows how many endpoints are currently active (purple bar)

Figure 23. Map and Statistics Panel

Exploring the Map​

The Zenarmor gateway and endpoint deployments associated with your organization are shown on a map in the global deployment overview pane. This feature enables you to interactively explore and obtain information about your Zenarmor deployments on the map. You have the ability to access specific details within a region. The total quantity of deployments for each region is represented by an purple circle. To observe the details, simply double-click on the circle that is situated in the respective region. You may easily navigate the global deployment map by performing the following operations:

  • Zoom-in: You may zoom in on the map by clicking on zoom-in button with + icon at the top left of the map or by scrolling the mouse wheel.
  • Zoom-out: You may zoom out on the map by clicking on zoom-out button with - icon at the top left of the map or by scrolling the mouse wheel.
  • Wider-view: You may click on the Fit to extent button with the refresh icon for a wider view.
  • Navigate: Drag and drop with your mouse to navigate on the map.

Figure 24. Exploring the Map

Viewing Instance Details​

When you click on a specific deployment on the map or in the table, the Instance Details panel opens on the right side of the screen. This panel shows detailed information about the selected gateway or endpoint:

  • Name: Instance name
  • Slug: Internal unique identifier
  • Platform: Operating system (e.g., OPNsense 25.1.1, Windows 10)
  • Location: Country/city of the instance
  • Added At: Registration date
  • Last Seen: Time elapsed since last communication
  • Type: Gateway or Endpoint
  • Engine Status: Running / Stopped / Bypassed
  • Engine Version: Installed Zenarmor engine version
  • Overlay Networks: Any connected private secure networks
  • Internet Security Policies: Policies currently applied

You can close the panel anytime by clicking the X icon at the top-right corner of the panel.

tip

This panel is especially helpful for a quick “at a glance” check to see where your devices are located and which ones are online.

Figure 25. Instance Details

Exploring Devices on Gateways​

The Devices on Gateways view allows you to see all end-user devices (laptops, mobiles, IoT, etc.) that are connected through each gateway in your organization. This section answers the question: “Which devices are behind my gateway, and are they currently connected?”.

You can follow these steps to access the Devices on Gateways menu.

  1. From the left-hand sidebar, click Global Deployments to expand its menu.

  2. Click on Devices on Gateways.

  3. A list of your gateways will appear below the menu item.

  4. Select a gateway from the list to open its device view.

    Figure 26. Devices on Gateways

Devices are shown in different categories (such as laptops, mobiles, servers, or IoT devices), making it easier to understand what types of clients are active. You can also check whether these devices are online, offline, or recently connected, giving you a quick overview of their status.

For detailed information about how device identification works and how to configure it, you may view the Device Identification Overview on Zenconsole.

Last updated on by Zenarmor