# Most basic steps for a functioning keycloak container?

**URL:** <https://forum.keycloak.org/t/most-basic-steps-for-a-functioning-keycloak-container/444>\
**Category:** Configuring the server\
**Created:** [November 17, 2019, 10:25am UTC](https://forum.keycloak.org/t/most-basic-steps-for-a-functioning-keycloak-container/444 "2019-11-17T10:25:21Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![Huntsecker](https://avatars.discourse-cdn.com/v4/letter/h/4da419/32.png) [@Huntsecker](https://forum.keycloak.org/u/Huntsecker)\
**Post date:** [November 17, 2019, 10:25am UTC](https://forum.keycloak.org/t/most-basic-steps-for-a-functioning-keycloak-container/444/1 "2019-11-17T10:25:21Z")

</div>

Morning all,  
Just trying to try this out and would like a noobs guide to setting up a docker container with minimal configuration for a minimal test. Following the documentation doesn’t seem to work container fails to start

```auto
docker run -e KEYCLOAK_USER=<USERNAME> -e KEYCLOAK_PASSWORD=<PASSWORD> jboss/keycloak -p 8080:8080

```

so was hoping their was someone who could assist with the correct config for the absolute minimal so I can test then expand once I know the tool better.  
Cheers  
Tom.

---

<div class="post-metadata">

**Author:** ![jangaraj](https://yyz2.discourse-cdn.com/free1/user_avatar/forum.keycloak.org/jangaraj/32/5175_2.png) [@jangaraj](https://forum.keycloak.org/u/jangaraj)\
**Post date:** [November 17, 2019, 3:19pm UTC](https://forum.keycloak.org/t/most-basic-steps-for-a-functioning-keycloak-container/444/2 "2019-11-17T15:19:00Z")

</div>

You have wrong command composition. See `docker run` manual. Correct one:

```auto
docker run \
  -e KEYCLOAK_USER=<USERNAME> \
  -e KEYCLOAK_PASSWORD=<PASSWORD> \
  -p 8080:8080 \
  jboss/keycloak 

```

+ you will be better if you expose port 8443 (https protocol):

```auto
docker run \
  -e KEYCLOAK_USER=<USERNAME> \
  -e KEYCLOAK_PASSWORD=<PASSWORD> \
  -p 8443:8443 \
  jboss/keycloak 

```

---

<div class="post-metadata">

**Author:** ![SW1](https://avatars.discourse-cdn.com/v4/letter/s/ce7236/32.png) [@SW1](https://forum.keycloak.org/u/SW1)\
**Post date:** [November 17, 2019, 10:17pm UTC](https://forum.keycloak.org/t/most-basic-steps-for-a-functioning-keycloak-container/444/3 "2019-11-17T22:17:06Z")

</div>

That doesn’t work for me either. I’ve seen that same line everywhere but all I get is

/opt/jboss/tools/docker-entrypoint.sh: line 47: KEYCLOAK\_FRONTEND\_URL: unbound variable

---

<div class="post-metadata">

**Author:** ![jangaraj](https://yyz2.discourse-cdn.com/free1/user_avatar/forum.keycloak.org/jangaraj/32/5175_2.png) [@jangaraj](https://forum.keycloak.org/u/jangaraj)\
**Post date:** [November 17, 2019, 10:28pm UTC](https://forum.keycloak.org/t/most-basic-steps-for-a-functioning-keycloak-container/444/4 "2019-11-17T22:28:52Z")

</div>

Yeah, the latest 8.0.0 image seems to be broken. Use `jboss/keycloak:7.0.1`:

```auto
docker run \
  -e KEYCLOAK_USER=<USERNAME> \
  -e KEYCLOAK_PASSWORD=<PASSWORD> \
  -p 8443:8443 \
  jboss/keycloak:7.0.1

```