# How do I use ZAC with quickstart docker-compose?

**URL:** <https://openziti.discourse.group/t/how-do-i-use-zac-with-quickstart-docker-compose/422>\
**Category:** Ziti Administration Console\
**Created:** [April 21, 2022, 12:02pm UTC](https://openziti.discourse.group/t/how-do-i-use-zac-with-quickstart-docker-compose/422 "2022-04-21T12:02:51Z")\
**Posts on this page:** 9\
**Page:** 1

<div class="post-metadata">

**Author:** ![RodneyRichardson](https://avatars.discourse-cdn.com/v4/letter/r/dbc845/32.png) [@RodneyRichardson](https://openziti.discourse.group/u/RodneyRichardson)\
**Post date:** [April 21, 2022, 12:02pm UTC](https://openziti.discourse.group/t/how-do-i-use-zac-with-quickstart-docker-compose/422/1 "2022-04-21T12:02:51Z")

</div>

I have started the docker containers specified in the quickstart guide ([ziti/docker-compose.yml at release-next · openziti/ziti · GitHub](https://github.com/openziti/ziti/blob/release-next/quickstart/docker/docker-compose.yml)), including the ZAC “ziti-console” container, using the default values on my local Windows machine.

I can access the ZAC web page at https:// localhost:8443/login (and http:// localhost:1408), but I don’t know what to put into the “EDGE CONTROLLER NAME” and “URL” fields.

I’ve tried various values, but get errors like “Edge Controller not Online” or “Invalid Edge Controller”.

- https: [//localhost:1280](https://localhost:1280) for both fields
- arbitrary name, plus URL https:// localhost:1280

@TheLumberjack : Are you able to update the quickstart documentation to give more details?

[Note: I don’t have spaces in my actual values, but I’ve needed to add them here to allow a new user to post]

---

<div class="post-metadata">

**Author:** ![TheLumberjack](https://yyz2.discourse-cdn.com/free1/user_avatar/openziti.discourse.group/thelumberjack/32/113_2.png) [@TheLumberjack](https://openziti.discourse.group/u/TheLumberjack)\
**Post date:** [April 21, 2022, 12:19pm UTC](https://openziti.discourse.group/t/how-do-i-use-zac-with-quickstart-docker-compose/422/2 "2022-04-21T12:19:01Z")

</div>

Sure I can update the doc - this is somewhat ‘tricky’. The ZAC needs to be told where it will send data. When running in docker compose that ends up being “ziti-edge-controller” because the compose file sets up a docker network

![image](https://global.discourse-cdn.com/free1/uploads/netfoundry/original/1X/70adaa9a8c2eb52eaf788c20a3a20bd7c55f0a0b.png)  
 ![image](https://global.discourse-cdn.com/free1/uploads/netfoundry/original/1X/cd594911f066725bfbe41c542337d1b488acc75b.png)

---

<div class="post-metadata">

**Author:** ![RodneyRichardson](https://avatars.discourse-cdn.com/v4/letter/r/dbc845/32.png) [@RodneyRichardson](https://openziti.discourse.group/u/RodneyRichardson)\
**Post date:** [April 21, 2022, 12:38pm UTC](https://openziti.discourse.group/t/how-do-i-use-zac-with-quickstart-docker-compose/422/3 "2022-04-21T12:38:33Z")

</div>

Thank you! I thought I’d also tried `ziti-controller` (the name of the docker service), but not the name used in the network “aliases” field.

---

<div class="post-metadata">

**Author:** ![TheLumberjack](https://yyz2.discourse-cdn.com/free1/user_avatar/openziti.discourse.group/thelumberjack/32/113_2.png) [@TheLumberjack](https://openziti.discourse.group/u/TheLumberjack)\
**Post date:** [April 21, 2022, 12:40pm UTC](https://openziti.discourse.group/t/how-do-i-use-zac-with-quickstart-docker-compose/422/4 "2022-04-21T12:40:53Z")

</div>

I added three screenshots to the relevant ZAC doc section [Installing Ziti Administration Console | Ziti](https://openziti.github.io/ziti/quickstarts/zac/installation.html#login-and-use-the-ziti-console)

One of which covers using compose now. Thanks so much for the feedback thus far.

---

<div class="post-metadata">

**Author:** ![Rastaban](https://yyz2.discourse-cdn.com/free1/user_avatar/openziti.discourse.group/rastaban/32/886_2.png) [@Rastaban](https://openziti.discourse.group/u/Rastaban)\
**Post date:** [March 20, 2023, 1:23am UTC](https://openziti.discourse.group/t/how-do-i-use-zac-with-quickstart-docker-compose/422/5 "2023-03-20T01:23:56Z")

</div>

The step for ZAC installation with docker compose the following commands are pointing to the wrong path.

> docker cp docker\_ziti-controller\_1:/var/openziti/pki/ziti-edge-controller-intermediate/keys/ziti-edge-controller-server.key .  
> docker cp docker\_ziti-controller\_1:/var/openziti/pki/ziti-edge-controller-intermediate/certs/ziti-edge-controller-server.chain.pem .

For some reason I found them in

> persistent/pki/ziti-edge-controller-intermediate/keys/ziti-edge-controller-server.key .

And even today I was not able to get in the controller 🙂

---

<div class="post-metadata">

**Author:** ![TheLumberjack](https://yyz2.discourse-cdn.com/free1/user_avatar/openziti.discourse.group/thelumberjack/32/113_2.png) [@TheLumberjack](https://openziti.discourse.group/u/TheLumberjack)\
**Post date:** [March 20, 2023, 1:29am UTC](https://openziti.discourse.group/t/how-do-i-use-zac-with-quickstart-docker-compose/422/6 "2023-03-20T01:29:35Z")

</div>

Hi @Rastaban, welcome to OpenZiti and the forum! Yeah you’re right, those paths are out of date.

I’ve filed an issue to revisit this guide and make sure the steps are accurate: [ZAC + compose section uses incorrect paths · Issue #448 · openziti/ziti-doc · GitHub](https://github.com/openziti/ziti-doc/issues/448)

I’ll try to get to this or have someone else get to it soon. Thanks for pointing that out

---

<div class="post-metadata">

**Author:** ![Rastaban](https://yyz2.discourse-cdn.com/free1/user_avatar/openziti.discourse.group/rastaban/32/886_2.png) [@Rastaban](https://openziti.discourse.group/u/Rastaban)\
**Post date:** [March 20, 2023, 1:32am UTC](https://openziti.discourse.group/t/how-do-i-use-zac-with-quickstart-docker-compose/422/7 "2023-03-20T01:32:48Z")

</div>

Thanks for the answer. I love this project.  
Just for curiosity. Did I miss the default admin password generation somewhere? I am trying to get in but I get a " The authentication request failed" error on the interface of the controller.  
And this is what I get when I run in the controller bash

```auto
ziti edge login -u admin -p admin
Using controller url: https://ziti-edge-controller:1280/edge/management/v1 from identity 'default' in config file: /persistent/ziti-cli.json
error: unable to authenticate to https://ziti-edge-controller:1280/edge/management/v1. Status code: 401 Unauthorized, Server returned: {
    "error": {
        "code": "INVALID_AUTH",
        "message": "The authentication request failed",
        "requestId": "mEN92cEm-"
    },
    "meta": {
        "apiEnrollmentVersion": "0.0.1",
        "apiVersion": "0.0.1"
    }
}

```

---

<div class="post-metadata">

**Author:** ![TheLumberjack](https://yyz2.discourse-cdn.com/free1/user_avatar/openziti.discourse.group/thelumberjack/32/113_2.png) [@TheLumberjack](https://openziti.discourse.group/u/TheLumberjack)\
**Post date:** [March 20, 2023, 1:39am UTC](https://openziti.discourse.group/t/how-do-i-use-zac-with-quickstart-docker-compose/422/8 "2023-03-20T01:39:39Z")

</div>

Thanks for that @Rastaban! Glad you’re enjoing the project.

There’s another bug if you stop/start docker-compose over and over. The password that is emitted into the stashed .env file will get overwritten if you do that. You might be hitting that bug? [docker env password is renewed at each `docker-compose up` · Issue #1013 · openziti/ziti · GitHub](https://github.com/openziti/ziti/issues/1013)

The first time you start with compose right now, you will need to capture that password and not lose it because as I mentioned, it’ll get overwritten.

You **can** find the original password by using `docker logs` on the controller and going all the way back to the very, beginning log messages. It looks like this:

```auto
Do you want to keep the generated admin password 'ZqfiJmIRdjxN8k5X5ZTm8MXM6RxhGonc'? (Y/n) INFO: using ZITI_PWD=ZqfiJmIRdjxN8k5X5ZTm8MXM6RxhGonc

```

Hope that helps

---

<div class="post-metadata">

**Author:** ![TheLumberjack](https://yyz2.discourse-cdn.com/free1/user_avatar/openziti.discourse.group/thelumberjack/32/113_2.png) [@TheLumberjack](https://openziti.discourse.group/u/TheLumberjack)\
**Post date:** [March 20, 2023, 3:28pm UTC](https://openziti.discourse.group/t/how-do-i-use-zac-with-quickstart-docker-compose/422/9 "2023-03-20T15:28:38Z")

</div>

FYI @Rastaban. Both of our compose files already deploy a ZAC. I updated the doc to simply inform you of that fact. Thanks for pointing this out. cheers
