# Installation Linux

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](/integration-platform/system-requirements.md) 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](broken://pages/98ef6561e252bbe0be3ca3cff01f0f0a6a2e9b77).

***

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

{% stepper %}
{% step %}

### Obtain the installer

Obtain the ZigiOps installer from ZigiWave.
{% endstep %}

{% step %}

### Copy it to the target server

Copy it to the target Linux server.
{% endstep %}

{% step %}

### Make it executable

Ensure you have permission to execute it:

```bash
sudo chmod +x zigiwave-zigiops-installer.jar
```

{% endstep %}

{% step %}

### Have sudo access ready

Have sudo access ready, as installation requires elevated privileges.
{% endstep %}
{% endstepper %}

***

## 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:

```bash
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:

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

```bash
sudo systemctl start zigiops
```

**Stop the service:**

```bash
sudo systemctl stop zigiops
```

**Restart the service:**

```bash
sudo systemctl restart zigiops
```

**Check service status:**

```bash
sudo systemctl status zigiops
```

**Enable automatic startup on boot:**

```bash
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?

{% stepper %}
{% step %}

### Check service status

Ensure `active (running)` is displayed.
{% endstep %}

{% step %}

### Verify that the required ports are listening

```bash
sudo netstat -tulpn | grep <port>
```

{% endstep %}

{% step %}

### Review logs

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

{% step %}

### Test the UI

Open a browser and check whether the ZigiOps login page loads successfully.
{% endstep %}
{% endstepper %}

***

## How Do I Access the ZigiOps Web Interface After Installation?

Open a browser and navigate to:

```bash
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.

***

## What Post-Installation Steps Should I Complete?

{% stepper %}
{% step %}

### Secure Access

* Replace self-signed certificates with production certificates
* Restrict access via firewall rules
* Configure authentication and user rights
  {% endstep %}

{% step %}

### Add Your Systems

Go to **Systems** and start connecting systems such as ServiceNow, Jira, Azure DevOps, Dynatrace, AppDynamics, and more.
{% endstep %}

{% step %}

### Load or Create Integration Workflows

* Use built-in templates, or
* Create custom workflows matching your data flow requirements
  {% endstep %}

{% step %}

### Configure Backups or Monitoring (Optional)

Integrate with your logging/monitoring stack for ongoing health visibility.
{% endstep %}
{% endstepper %}

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zigiwave.com/installation-and-deployment/installation-linux.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.