Quick Start Console Port Confusion

Hi all - first post!

I have been going over the quick start, and choosing the path to install self hosted on a cloud VM. All seemed to go fine, and was very logical until I hit the ZAC install page (Ziti Admin Console | OpenZiti)

Under the section titled "Downloading From GitHub" (which should have worked I found that once I had completed the steps I couldnt connect on the address given: https://ctrl.ziti.example.com:1280/zac/ <--- (Obviously, with the host DNS changed to the host maching involved)

Did some digging around with the systemd units and the open ports of the machine in question, and all seemed to be well there, other than there was no open port for 1280. Eventually, after a short brute force session I could connect to the ZAC on port 8441 with no problems. So the question here is two fold!

  1. have I messed this up somehow?
  2. do the docs need updating?

Either way ! enjoying the way this is put together as a project! Its great work!

Hi @poppaLol, welcome to the community and to OpenZiti (and zrok and BrowZer),

On the whole, I'd say the doc just needs a tiny bit of updating. It's not explicitly spelled out on the page, but the example port is just "an example". I'll update the doc so tht it states explicitly to use the same port as the managment api. The "Downloading From GitHub" section relies on the controller being the server that delivers the ZAC SPA app.

We're pleased you're enjoying the project, hopefully that makes sense. I'll go update the doc to be a bit more specific to help out the next user a bit more.

Cheers!

EDIT: after the PR merges the doc will state:

Navigate to the console in your web browser using whatever port the management API is configured for. Depending on which quickstart you have used, the port may be different. The "Local" quickstart defaults to port 1280 while the "Host OpenZiti Anywhere" quickstart defaults to 8441 and is customizable by you. Make sure you are using the advertised host and port for your managment API, e.g., https://ctrl.ziti.example.com:1280/zac/

1 Like

Makes perfect sense! Looking forward to experimenting with services and clients now. Many thanks for the quick reply!