Installation Linux

This page provides the complete installation guide for running ZigiOps on a Linux machine.

This page includes prerequisites, installer preparation, GUI/console installation, service management, and post-installation steps.

What Are the Prerequisites for Installing ZigiOps on Linux?

Before starting the installation, ensure the following conditions are met.

Supported Operating Systems

ZigiOps supports major Linux distributions. Recommended versions are listed in the System Requirements page.

Required Permissions

You need root or sudo privileges to run the installer.

Java Requirements

The installer runs as a standalone .jar package and uses the embedded Java runtime that ships with ZigiOps. No separate manual Java installation is required unless using a custom runtime.

Network and Ports

Confirm the following:

You can open the port that ZigiOps listens on (the HTTPS UI port).
Outbound connectivity is available to the systems you plan to integrate (for example, Jira, ServiceNow, or other ITSM and monitoring tools).
Firewalls allow traffic according to your security policies.

System Resources

Follow the recommended CPU, RAM, and disk guidelines from System Requirements.

How Do I Download and Prepare the ZigiOps Installer on Linux?

Obtain the installer

Obtain the ZigiOps installer from ZigiWave.

Copy it to the target server

Copy it to the target Linux server.

Make it executable

Ensure you have permission to execute it:

sudo chmod +x zigiwave-zigiops-installer.jar

Have sudo access ready

Have sudo access ready, as installation requires elevated privileges.

How Do I Run the ZigiOps Installer in GUI or Console Mode?

The ZigiOps installer supports two modes:

GUI mode (graphical interface)
Console mode (terminal-based wizard)

Launching the Installer

Run the installer using:

sudo java -jar <PATH>/zigiwave-zigiops-installer.jar

Replace <PATH> with the directory containing the file.

When Does GUI Mode Appear?

If your system has X11 libraries installed and supports graphical output, the installer will automatically start in GUI mode. This is useful when installing from a desktop-enabled environment.

When Does It Switch to Console Mode?

If X11 libraries are not installed (which is typical for servers), the installer automatically falls back to console mode and presents an interactive, terminal-based wizard. No additional flags are required - ZigiOps detects the mode automatically.

What Steps Do I Follow in the Installation Wizard?

Regardless of GUI or console mode, the installer guides you through the same steps:

Welcome screen - A brief introduction to ZigiOps installation.
License Agreement - You must read and accept the license to proceed.
Select Installation Directory - Choose where ZigiOps will be installed (for example, /opt/zigiops). The path must allow write permissions for the ZigiOps service user.
Configure Ports - Set the Web UI port (HTTPS) and any listener ports used by your workflows.
Configure Service Settings - Including service run user (default: root, or a designated user if allowed) and optional JVM settings.
Confirm Settings and Install - Once confirmed, the installer copies all required files, configures ZigiOps as a Linux service, and prepares runtime directories and dependencies.
Completion - The wizard displays a success message and instructions to start the service.

How Do I Start and Manage the ZigiOps Service on Linux?

After installation, ZigiOps is registered as a Linux service (systemd-based).

Start the service:

sudo systemctl start zigiops

Stop the service:

sudo systemctl stop zigiops

Restart the service:

sudo systemctl restart zigiops

Check service status:

sudo systemctl status zigiops

Enable automatic startup on boot:

sudo systemctl enable zigiops

If your distribution uses a different service name, the installation wizard will display it.

How Do I Verify the Installation Was Successful?

Check service status

Ensure active (running) is displayed.

Verify that the required ports are listening

sudo netstat -tulpn | grep <port>

Review logs

Check the ZigiOps log directory (typically inside the installation folder) for startup messages or errors.

Test the UI

Open a browser and check whether the ZigiOps login page loads successfully.

How Do I Access the ZigiOps Web Interface After Installation?

Open a browser and navigate to:

https://<your-linux-host>:<configured-port>/

Notes:

The installer sets ZigiOps to use HTTPS.
If you are using a self-signed certificate, your browser may display a security warning. This is expected during initial installations.
Use the default ZigiOps credentials, after which you will be asked to set your own password.