Ubuntu 16.04 Installation Guide

Installing Gluu Server

Download and install Gluu Server by the following commands. Use the .deb installation to perform a base chroot installation with the following Gluu Server Base Ubuntu requirements.

As an alternative, use our Gluu repository for Ubuntu Xenial (16.04):

# echo "deb https://repo.gluu.org/ubuntu/ xenial main" > /etc/apt/sources.list.d/gluu-repo.list

# curl https://repo.gluu.org/ubuntu/gluu-apt.key | apt-key add -

# apt-get update

# apt-get install gluu-server-

Note: While entering the "deb" command manually, make sure to enter an extra space between "/ubuntu/" and "xenial main"

Configuring Gluu Server

After both the retrieval, and the installation of the Gluu Server software package start the Gluu Server, and login into the local chroot environment to configure the Gluu Server.

Below are the steps to configure Gluu Server:

  1. Start the Gluu Server
  2. Login into local chroot environment to configure Gluu Server.
  3. Navigate or change to community-edition-setup directory where setup.py script is located.
  4. Run setup.py to configure the Gluu Server

Below are the following commands:

# /etc/init.d/gluu-server- start

# /etc/init.d/gluu-server- login

# cd /install/community-edition-setup/


The setup.py script will bring up a prompt to provide information for certificate. It is recommened to use hostname.domain structure for hostname and refrain from using 127.x.x.x for IP address. After the successful execution of setup.py script, login to oxTrust, the policy administration point for Gluu.

Access the oxtrust UI from the local browser using https://hostname.domain, which was provided during the configuration. And the uri will be mentioned at the end of successful configuration.

For both help and the latest installation options see either setup.py help, or run ./setup.py -h.

If resolvable DNS host is not used, add the hostname to your hosts file on the server or the system where the oxtrust UI is accessed. Login with the default user name “admin” and the password used in the configuration(also contained in setup.properties.last use the Unix command grep --color -i pass to find the according line quickly) and look for the LDAP password which is the same as the admin password.

Make sure to remove or encrypt setup.properties.last It has the clear text passwords for everything: LDAP, admin user, keystores, and 3DES salt. Logs can be analyzed for installation errors in setup.log for a detailed step-by-step analysis of the installation. As an alternative, check the file setup_errors.log to just see the errors (or stderr output from the scripts).

Removing/disabling Gluu repo

After initial installation is completed, it's recommended to remove Gluu repos from sources list, to avoid accidental upgrade of the Gluu package by conducting regular system's update procedures (like, by running # apt-get update)

Either remove /etc/apt/sources.list.d/gluu-repo.list file, or modify it commenting out lines declaring Gluu CE's repos there.

Starting and Stopping the Gluu Server

To start the Gluu Server use the below command:

# /etc/init.d/gluu-server- start

To stop the Gluu Server use the below command:

# /etc/init.d/gluu-server- stop

To check the status of the Gluu Server use the below command:

#/etc/init.d/gluu-server- staus

Login to the chroot environment

# /etc/init.d/gluu-server- login

alternatively sudo can be used as below:

# chroot /home/gluu-server24/ su -

Scripted Installation

Below are the steps to script the installation of the Gluu Server:

  • Save and backup your existing file setup.properties.last.
  • Uninstall existing Gluu Server installation.
  • For a new installation you can either grab a new VM, or just use the existing one.
  • Run all the commands until service gluu-server24 login.
  • Copy your file setup.properties.last into the new server's /install/community-edition-setup/ location.
  • Rename the file setup.properties.last to setup.properties.
  • Run the setup script with ./setup.py command.


Step by Step instructions to uninstall Gluu Server: 

  1. Exit from the chroot environment to main linux, by entering Logout command. 
  2. Stop the Gluu Server chroot environment which will unmount allchroot directories. 
  3. Delete both the Gluu Server packages that are installed, and the home directory of the Gluu Server user.

The following commands illustrate the steps:

# service gluu-server- stop

# apt-get remove gluu-server-

# rm -rf /opt/gluu-server-*

During an installation, any modified files will be saved in the directory, /home/gluu-server24.save. If required to remove all the remnants of the installation, delete these files with the command `rm -rf /home/gluu-server24.save'.

In some circumstances, the installation can be broken. In that case please try the following to force to uninstall the package.

# dpkg --purge --force-all gluu-server-


Gluu offers both community and VIP support. Anyone can browse and open tickets on our support portal. For private support, expedited assistance, and strategic consultations, please view our pricing and schedule a meeting with us to discuss VIP support options.