zandGitHub a636bb36d7 Delete dead workflows
Mattermost and zt-ci callers whose action repos are private and
archived; upstream repo bots.

Claude-Session: https://claude.ai/code/session_01HuMDfgFssPUptYUzgZ6Cp8
2026-09-24 10:05:21 -07:00
2026-09-24 10:05:21 -07:00
2026-08-29 13:46:59 -07:00
2023-12-07 12:25:30 -05:00
2026-08-29 13:46:59 -07:00
2026-02-18 18:34:13 -08:00
2024-07-03 10:22:40 -04:00
2026-08-29 13:46:59 -07:00
2020-01-17 20:05:29 +00:00
2026-08-29 13:46:59 -07:00
2026-08-29 13:46:59 -07:00
2023-02-05 08:15:46 -05:00

zt-console

Ziggy using the zt-console

Hanzo ZT is a free and open source project focused on bringing zero trust to any application.
The project provides all the pieces required to implement or integrate zero trust into your solutions.


@hanzozt/zt-console

This repo hosts the Ziti Admin Console, and is designed to provide a user interface to help you administrate an Hanzo ZT Network via the Ziti Edge API

Part of the Hanzo ZT ecosystem


Interested in knowing how to easily embed programmable, high performance, zero trust networking into your application without VPNs?
Learn more about Hanzo ZT project.
Also, checkout core project on github

Please star us!


Issues License PRs Welcome Contributor Covenant


Hanzo ZT Console

The Hanzo ZT Console is an administrative web interface for an Hanzo ZT network.

Deployments

Read the production deployment guides for the console as well as the controller, router, etc.

Link to deployment guides

Requirements

To build and run the application from source, you'll also need to make sure you have the following developer tools installed and available on your command line.

Tool Version
Node.js >=18
npm >=8.1
ng =16

Install Angular CLI

This provides the ng command.

npm install -g @angular/cli@16

Projects

This repository houses two projects.

  1. zt-console-lib - Angular library used by the console UI.
  2. app-zt-console - console UI with two deployment modes.
  3. Single page application mode (recommended)
  4. Node.js server mode (server.js, deprecated)

Build

From the project root:

  1. Install both projects' dependencies and build the library.

    npm install
    

Build the Single Page Application

  1. Build the console project with Angular.

    ng build zt-console
    
  2. The single-page application assets are rendered in the ./dist/app-zt-console directory.

  3. use the Node server to preview changes.

Build the Standalone Node Server

Do not use this in production: deployment guides. This is a deprecated build and run mode temporarily preserved here for previewing local changes during development.

  1. Build the console project with Angular.

    ng build zt-console-node
    
  2. If developing the standalone Node server, run it.

    node server.js
    
  3. Access the console at http://localhost:1408

  4. Configure the server with the URL of the controller's edge-management API, e.g. https://localhost:1280

Developing with Angular

There are two elements to the Angular app.

From the project directory:

  1. Install dependencies and build the library.

    npm install
    
  2. Continually build the library in ./dist/zt-console-lib by running the npm script watch:lib.

    ng build zt-console-lib --watch
    

    Note: The NPM library is referenced/linked in package.json as "zt-console-lib": "file:dist/zt-console-lib". This library includes the javascript code shared with the console application and the Angular code shared with other applications.

  3. Continually build the deprecated Node server in app-zt-console-node to preview changes.

    ng build zt-console-node --watch
    

Attribution

Hanzo ZT Console is derived from the OpenZiti Admin Console (openziti/ziti-console), Copyright NetFoundry Inc., licensed under Apache-2.0. See NOTICE and LICENSE.

release-notes.md is upstream's release history and documents NetFoundry's development of the Ziti Admin Console, not Hanzo's.

S
Description
Hanzo ZT Console - web management UI for Hanzo Zero Trust
Readme Apache-2.0
20 MiB
Languages
JavaScript 68.6%
TypeScript 20%
SCSS 5.6%
HTML 5.1%
CSS 0.6%