Skip to main content
Star us on GitHub Star

Console Deployment

The console must be bound to the same web listener as the controller's management API.

  1. On the controller host, download the latest release of the console from GitHub. You can use any console version >= 3.0.0.

    wget https://github.com/openziti/ziti-console/releases/latest/download/ziti-console.zip
  2. Unzip the console in the controller's working directory.

    sudo unzip -d /var/lib/ziti-controller/zac ./ziti-console.zip
  3. In /var/lib/ziti-controller/config.yml, ensure you have an API binding zac on the same web listener where edge-management is bound. Ensure the location matches the path where you unzipped the console.

    - binding: zac
    options:
    location: /var/lib/ziti-controller/zac
    indexFile: index.html
  4. Restart the controller service to apply the changes.

    sudo systemctl restart ziti-controller.service
  5. Visit the controller's web address in a browser to access the console.

    https://ctrl.ziti.example.com:1280/zac/
  6. Console certificate option - The console is served from the controller's API and can be used with the default API certificate. The controller can be configured to present a different certificate for the console when the API is accessed by a distinct URL for the console. For more information about using alternative server certs with the controller, see: the configuration reference for the identity property.