Skip to content
GluuGluu
Browse Gluu Server 4.4

Release

Ubuntu

#Overview

Single-node Gluu Server Linux packages are available for Ubuntu 20.x, 22.x. Follow the instructions below:

  1. Install the Linux package
  2. Start the Server and log in to the container
  3. Run the setup script
  4. Sign in via browser
  5. Disable Gluu repositories

#Prerequisites

  • Make sure the target server or VM meets all minimum requirements specified in the VM Preparation Guide.
  • Ubuntu 20 or 22: The Universe repository must be enabled.

#Instructions

#Install the package

The Gluu Server will create its file system under /root/ and will be installed under /opt. File size and minimum requirements remain the same as the host.

For Ubuntu 22.x run the following commands:

echo "deb https://repo.gluu.org/ubuntu/ jammy main" > /etc/apt/sources.list.d/gluu-repo.list
curl https://repo.gluu.org/ubuntu/gluu-apt.key | apt-key add -
apt update
apt install gluu-server=4.4.2~ubuntu22.04_amd64.deb

After installation, the gluu-server package needs to be excluded from automatic updates with the following command.

apt-mark hold gluu-server

For Ubuntu 20.x run the following commands:

echo "deb https://repo.gluu.org/ubuntu/ focal main" > /etc/apt/sources.list.d/gluu-repo.list
curl https://repo.gluu.org/ubuntu/gluu-apt.key | apt-key add -
apt update
apt install gluu-server=4.4.2~ubuntu20.04

After installation, the gluu-server package needs to be excluded from automatic updates with the following command.

apt-mark hold gluu-server

After installation, the gluu-server package needs to be excluded from automatic updates with the following command.

apt-mark hold gluu-server

#Start the server and log in

The Gluu Server is a chroot container, which must be started to proceed.

For Ubuntu 20.x and 22.x run the following commands:

/sbin/gluu-serverd enable
/sbin/gluu-serverd start
/sbin/gluu-serverd login

#Run the setup script

Configuration is completed by running the setup script from inside the chroot container. This generates certificates, salt values, and renders configuration files. Run the script with the following commands:

cd /install/community-edition-setup
./setup.py

See the Setup Script Documentation for more detail on setup script options.

#Sign in via browser

Wait about 10 minutes in total for the server to restart and finalize its configuration. After that period, sign in via a web browser. The username will be admin and your password will be the ldap_password you provided during installation.

#Disable Gluu Repositories

To prevent involuntary overwrites of the currently deployed instance (in case a newer version of the same package is found during regular OS updates), disable the previously added Gluu repositories after initial installation.

Edit /etc/apt/sources.list.d/gluu-repo.list to comment out all Gluu-related repos.

#Backups

Sometimes things go wrong! It can be difficult to troubleshoot issues if the steps to reproduce the issue are not clearly documented. This is why we always recommend creating backups of your Gluu Server.

#Uninstallation

For Ubuntu Server 20.x and Ubuntu Server 22.x, run the following commands:

/sbin/gluu-serverd disable
/sbin/gluu-serverd stop
apt remove gluu-server
rm -fr /opt/gluu-server.save

#Support

Please review the Gluu support portal. There are many existing tickets about troubleshooting installation issues. If there is no similar existing public issue, register for an account and open a new ticket.

If your organization needs guaranteed responses, SLAs, and priority access to the Gluu support and development team, consider purchasing one of our VIP support contracts.