--- title: "Prerequisites for and how to view Appliances and their health status" slug: "appliances-v6-7" description: "Manage your appliances effectively with health stats, filtering options, and action buttons for seamless operation in your Collective." tags: ["Appliance Configuration", "Appliance Health Status", "Appliance Management", "Appliances"] updated: 2026-03-16T19:08:15Z published: 2026-04-03T16:41:11Z canonical: "support.appgate.com/appliances-v6-7" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.appgate.com/llms.txt > Use this file to discover all available pages before exploring further. # Appliances Appliances are listed on the **Appliances** page (System > Appliances). You can toggle between the *Stats* view, which focuses on health and statistics, and the *Default* view. ![Table displaying AWS appliances with options for items per page and auto-refresh.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/ag63-table_layout.png?sv=2026-02-06&spr=https&st=2026-10-26T21%3A56%3A41Z&se=2026-10-26T22%3A56%3A41Z&sr=c&sp=r&sig=FT2u2gH4sY3T1as5uS8JHJ%2B%2FDafcuDl9Txxd6EN8sPY%3D) The stats view displays the current *Version* you are using and alerts you with an [admin message](/v1/docs/admin-ui-tools-v6-7) when a newer version is available (for ZTP-connected Collectives only). ## Filtering and sorting appliances Use the search box to filter appliances. Click on column headings to sort the data. > [!NOTE] > **NOTE** > > If a customization is installed, it will be indicated in the *Version* column with a (c). ## Before configuring an appliance Gather the following information before configuring appliances: - Network interface and routing details. - LogServer details for receiving logs from the Collective appliances. - NTP server details, including secure NTP information. Pre-configure the following elements: - ***DNS***. The hostname of the new appliance must be resolvable by the Controller. - ***Trusted certificates.*** If using a LogForwarder with mTLS, add the destination's certificate to [Trusted Certificates](/v1/docs/trusted-certificates-v6-7). - ***Sites.*** Configure the Site first if setting up a Gateway. Refer to the [Sites](/v1/docs/sites-v6-7) section for details. For background reading: - See the [About appliances](/v1/docs/about-appliances-v6-7) section for general information. - Learn about peer-to-peer connectivity in the [System Connections](/v1/docs/system-connections-v6-7) section. - Understand tunneled connections in the [Tunnel architectures](/v1/docs/tunnel-architectures-v6-7) section. - Refer to the [Interface Schematic](/v1/docs/interface-schematic-v6-7) for typical appliance topology. Use the **Appliances** page to: - Add new appliances. Refer to [the first Controller](/v1/docs/the-first-controller-v6-7) or [Configuring a new appliance](/v1/docs/managing-appliance-defining-a-new-appliance-v6-7) for guidance. - Edit existing appliances. Changes to activated appliances will be pushed automatically without needing to reexport the configuration file. - Monitor appliance health status. - Perform bulk actions. - Use the [action buttons](/v1/docs/appliances-v6-7#action-buttons) provided. To begin configuring an appliance, select **+Add** in the **Appliances** page. See the [System Settings](/v1/docs/system-settings-v6-7), [Functions](/v1/docs/functions-v6-7), and [Miscellaneous](/v1/docs/miscellaneous-v6-7) sections for information on completing the fields in the **Add Appliance** page. ## Appliance Health Status Appliance health statuses include: - ***Busy.*** Appliances connected and performing actions. - ***Error.*** Connected appliances that are unhealthy. - ***Healthy.*** Correctly configured and functioning appliances. - ***Not Active.*** Appliances not yet activated. See the [Registering a new appliance](/v1/docs/registering-a-new-appliance-v6-7) section to activate them. - ***Offline.*** Activated appliances not connected to a Controller. - ***Warning.*** Connected but unhealthy appliances. ### Appliance Health Details Click on any appliance **Status** to open **Appliance Health Details**, which provides: - **Appliance health**. Current health status. - **Function(s) health.** Health status of each configured function. - **Upgrade status.** Displays as “idle” unless an upgrade is in progress. - **Appliance metrics.** CPU, Memory, Disk, and Network throughput of the busiest NIC and IP addresses. > [!NOTE] > **NOTE** > > Monitor memory usage closely as the system lacks a swap partition. Refer to the [Instance Sizing](/v1/docs/instance-sizing-v6-7) section for capacity requirements. - **Appliance Customization.** Appears if a customization is installed. Refer to [Appliance Troubleshooting](/v1/docs/appliance-troubleshooting-v6-7) for details on warnings, errors, and suggested actions to improve system health. ![Appliance health details showing various service statuses and error messages.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/ag62-appliance_health.png?sv=2026-02-06&spr=https&st=2026-10-26T21%3A56%3A41Z&se=2026-10-26T22%3A56%3A41Z&sr=c&sp=r&sig=FT2u2gH4sY3T1as5uS8JHJ%2B%2FDafcuDl9Txxd6EN8sPY%3D) ## Actions The [Admin UI tools](/v1/docs/admin-ui-tools-v6-7#bulk-actions) page provides more information about bulk actions for appliances. ## Action Buttons ![Action button menu options for appliances including reboot and log download.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/ag63-action_buttons.png?sv=2026-02-06&spr=https&st=2026-10-26T21%3A56%3A41Z&se=2026-10-26T22%3A56%3A41Z&sr=c&sp=r&sig=FT2u2gH4sY3T1as5uS8JHJ%2B%2FDafcuDl9Txxd6EN8sPY%3D) Access action buttons by clicking the three dots icon (![Three circular shapes stacked vertically on a dark background, selected to access a menu.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/three_dots.png?sv=2026-02-06&spr=https&st=2026-10-26T21%3A56%3A41Z&se=2026-10-26T22%3A56%3A41Z&sr=c&sp=r&sig=FT2u2gH4sY3T1as5uS8JHJ%2B%2FDafcuDl9Txxd6EN8sPY%3D)) next to each item or from the **Actions** button. Options vary based on item type and state. The Action button in the **Appliances** page displays the following options: - ***Reboot***. Reboots the appliance. - ***Renew Certificate.*** Required if appliance settings change, such as [interfaces](/v1/docs/system-settings-v6-7) or [hosts file](/v1/docs/miscellaneous-v6-7). > [!NOTE] > **NOTE** > > - The appliance will be temporarily deactivated during certificate renewal, dropping active connections but allowing automatic reconnection. > - Changing the appliance hostname/IP will trigger automatic certificate renewal. The appliance will be shown as non-active for a short period. - ***Download Logs***. Downloads a zip archive of all [appliance daemon logs](/v1/docs/audit-logs-v6-7). - ***Deactivate.*** Removes an appliance from the Collective to be re-added in the future. This deletes configurations, sets status to *Not active*, and reenables the *Export seed file/ISO* button. The *Deactivate* option is useful for reestablishing a deleted or damaged cloud instance. > [!NOTE] > **NOTE** > > A functioning Controller cannot be deactivated. Disable the Controller function first and wait for it to become healthy. > [!NOTE] > **NOTE** > > To delete an appliance, use the *Delete* button on the page for that specific appliance. - ***Suspend/Resume.*** On Gateways, suspends new connections for maintenance and allows you to resume functionality when complete. - ***Run Commands.*** Opens the **Remote Commands** window with eight limited commands available for diagnostics. Most commands have a *Timeout* field that accepts a value in seconds. - ***Export seed file/ISO.*** Required for configuring a new appliance. You must create a new appliance and apply this seed file. This opens the **Export seed** modal with the following options: > [!NOTE] > **NOTE** > > The Export seed action button is only visible for *Not active* appliances. - *Export seed.* See [Defining a new appliance](/v1/docs/managing-appliance-defining-a-new-appliance-v6-7) for details. - *Upgrade to latest version.* - If selected, generates a configuration compatible with the Controller’s current API version. - If not selected, generates a configuration compatible with the appliance record’s API version. - *Seed Lifetime.* Use the dropdown to select the lifetime. Seeds contain temporary keys for Controller access. Keep the lifetime short. After expiration, the seed becomes invalid and must be reexported. - *Allow appliance customizations.* Disabled by default; can be enabled later using `cz-config`. See [cz-setup and cz-config commands](/v1/docs/cz-setup-and-cz-config-commands-v6-7) for details. - *Use SSH key provided by the cloud instance.* Specify a key when launching cloud-based appliances. - *Use SSH public key.* Begins with ssh-rsa, ssh-dss, ssh-ed25519, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384, or ecdsa-sha2-nistp521. - *Use password.* Use a password instead of an SSH key. Must be strong (grants root access). You can switch to a public key later; see [SSH Command line administration](/v1/docs/ssh-command-line-v6-7). - *Seed type.* Export as: - **JSON**. Typical format for cloud appliances; filename must end in `-seed.JSON` - **ISO**. For virtualized environments such as VMware. - **RAW**. Copies JSON to the clipboard for quick paste into the appliance using SSH, such as `nano /home/cz/seed.JSON` After successful seeding, the appliance will be listed in the **Appliances** page. If not, see [Registering a new appliance](/v1/docs/registering-a-new-appliance-v6-7) for troubleshooting.