Skip to content

Test Drive Demo#


Follow the instructions below to quickly deploy a single-node Gluu Server demo using Docker.


"Test drive" is perfect for testing the Gluu Server. For production deployments, follow instructions for your OS of choice, e.g. Docker.


Linux Requirements#

For Docker deployments on Linux, provision a VM with:

OS X (Mac) Requirements#

For Docker deployments on OS X, make sure you have the following:


  1. Log in as root:

    sudo su -
  2. Obtain the files for deployment:

wget \
    && unzip
cd community-edition-containers-4.0/examples/single-host
chmod +x
  1. Run the following command and follow the prompts:


    Do not be alarmed about the warning alerts that may show up. Wait until it prompts you for information or loads the previous configuration found. If this is a fresh install, the output will look like this :

    [I] Determining OS Type and Attempting to Gather External IP Address
    Host is detected as Linux
    Is this the correct external IP Address: [Y/n]? y
    [I] Preparing cluster-wide config and secrets
    WARNING: The DOMAIN variable is not set. Defaulting to a blank string.
    WARNING: The HOST_IP variable is not set. Defaulting to a blank string.
    Pulling consul (consul:)...
    latest: Pulling from library/consul
    bdf0201b3a05: Pull complete
    af3d1f90fc60: Pull complete
    d3a756372895: Pull complete
    54efc599d7c7: Pull complete
    73d2c234fe14: Pull complete
    cbf8018e609a: Pull complete
    Digest: sha256:bce60e9bf3e5bbbb943b13b87077635iisdksdf993579d8a6d05f2ea69bccd
    Status: Downloaded newer image for consul:latest
    Creating consul ... done
    [I] Checking existing config in Consul
    [W] Unable to get config in Consul; retrying ...
    [W] Unable to get config in Consul; retrying ...
    [W] Unable to get config in Consul; retrying ...
    [W] Configuration not found in Consul
    [I] Creating new configuration, please input the following parameters
    Enter Domain:                 yourdomain
    Enter Country Code:           US
    Enter State:                  TX
    Enter City:                   Austin
    Enter Email:        
    Enter Organization:           Gluu Inc
    Enter Admin/LDAP Password:
    Confirm Admin/LDAP Password:
    Continue with the above settings? [Y/n]y

    The startup process may take some time. You can keep track of the deployment by using the following command:

    ./ logs -f

Uninstall the Gluu demo#

To remove all deployed objects, run the following command inside community-edition-containers-4.0.0/examples/single-host:

./ down


  • How to use ldapsearch
docker exec -ti ldap /opt/opendj/bin/ldapsearch -h localhost -p 1636 -Z -X -D "cn=directory manager" -b "o=gluu" -s base -T "objectClass=*"
  • Locked out of your Gluu demo? This is how Vault can be manually unlocked

  • Get Unseal key from vault_key_token.txt

  • Log into vault container: docker exec -it vault sh

  • Run this command : vault operator unseal

  • Wait for about 10 mins for the containers to get back to work.