# Zabbix for Ubuntu 24.04 Server
[![OS](https://img.shields.io/badge/ubuntu-24.04-E95420)](#)
[![Shell](https://img.shields.io/badge/shell-bash-121011)](#)
[![WebServer](https://img.shields.io/badge/server-nginx-009639)](#)
[![PHP](https://img.shields.io/badge/php-fpm-777BB4)](#)
[![DB](https://img.shields.io/badge/server-mariadb-003545)](#)
[![App](https://img.shields.io/badge/app-zabbix-DC382D)](#)
[![License](https://img.shields.io/badge/License-MIT-green)](./LICENSE)

Installs and configures the **latest available Zabbix LTS release** on Ubuntu 24.04 Server.

This is a **production-focused installer**, not a demo.

It assumes Nginx, PHP-FPM, and MariaDB are already installed and running.

---

## Related Installers

If you don’t have the required components, you can use these compatible installers:

- [Nginx + PHP-FPM Installer](https://git.x-files.dk/webserver/nginx-ubuntu)
- [MariaDB Installer](https://git.x-files.dk/database/mariadb-ubuntu)

---

### Download the Script

Clone this repository to your server:

```
git clone https://git.x-files.dk/network/zabbix-ubuntu.git
```

```
cd zabbix-ubuntu
```

---

### Usage

Run the script using:

```
sudo ./zabbixinstall -n <domain> -p <zabbix db password> [options]
```

### Examples

The installer automatically detects if socket authentication is active. Only include `-a` and `-m` if your MariaDB setup does **not** use socket authentication.

```
sudo ./zabbixinstall -n zabbix.example.com -p zabbixdbpwd
sudo ./zabbixinstall -n zabbix.example.com -p zabbixdbpwd -m rootpwd
sudo ./zabbixinstall -n zabbix.example.com -p zabbixdbpwd -a admin -m adminpwd
```

### Options

| Flag | Description |
|------|--------------|
| `-p <password>` | Zabbix database user password |
| `-a <username>` | Optional MariaDB admin username (defaults to `root` if not specified) |
| `-m <password>` | MariaDB root or admin password — *required only if socket authentication is disabled* |
| `-h`, `--help` | Show the help screen (reflects detected socket status) |

### Configuration

Once the installer completes, visit:

```
http://<domain>
```

And complete the setup.

---

### Features

- Installs and configures Zabbix LTS automatically  
- Creates the MariaDB database and user with the correct privileges  
- Enables and starts Zabbix server and agent services  
- Detects MariaDB socket or password authentication automatically  
- Generates an Nginx host configuration dynamically  
- Integrates cleanly with PHP-FPM and Nginx setups  
- Supports re-runs via `IF NOT EXISTS` logic for safe idempotency  

---

### Configuration Details

#### File Locations

| File | Description |
|------|--------------|
| `/etc/zabbix/zabbix_server.conf` | Main Zabbix server configuration file |
| `/usr/share/zabbix-sql-scripts/mysql/server.sql.gz` | Database schema file imported by installer |
| `/etc/nginx/conf.d/<domain>.conf` | Generated Nginx host configuration file |
| `/etc/nginx/nginx-snippets` | Shared include snippets and templates |

---

#### Behavior

- The installer checks if **MariaDB socket authentication** is active.  
  If available, it connects locally as `root` (no password).  
- If socket authentication is **not detected**, use `-a` and `-m` to supply credentials.  
- Automatically sets and resets `log_bin_trust_function_creators` during import.  
- Nginx configuration is validated (`nginx -t`) before restarting.  

---

### Nginx Integration

The generated Zabbix configuration file listens on port 80.  
To enable HTTPS (port 443), use the example provided [here](https://git.x-files.dk/webserver/nginx-snippets/src/branch/main/hostfiles/zabbix.443.conf).

> **NOTE**
> The file also includes optional caching directives (commented out by default).
> You can enable them to improve load times and performance if needed.
> The lines you are looking for are at the bottom of the generated config file and look like this:
> ```
> ##### Cache js css static content and open files start #####################
> # include /etc/nginx/nginx-snippets/cache-open-files.conf;
> # include /etc/nginx/nginx-snippets/cache-statics.conf;
> # include /etc/nginx/nginx-snippets/cache-js-css.conf;
> ##### Cache js css static content and open files stop ######################

---

### Troubleshooting

**Nginx fails to restart**  
Run `nginx -t` and review any syntax errors reported in `/etc/nginx/conf.d/<domain>.conf`.

**Access denied during database creation**  
Your MariaDB setup likely does not use socket authentication.  
Re-run the installer with the `-m` flag (and optionally `-a`) to provide credentials.  
The installer will automatically re-detect your configuration.

**PHP version mismatch**  
The script automatically detects your installed PHP version,  
but ensure that the PHP-FPM service (e.g., `php8.3-fpm`) is active.

**Schema import fails**  
Verify that `/usr/share/zabbix-sql-scripts/mysql/server.sql.gz` exists.  
If missing, reinstall the `zabbix-sql-scripts` package.

---

### FAQ

**Q:** Why doesn’t the script ask for a MariaDB password by default?  
**A:** Ubuntu 24.04’s MariaDB defaults to *socket authentication*,  
allowing the local `root` user to connect without a password.  
The installer detects this automatically and skips password prompts when applicable.

**Q:** Can I run the installer multiple times?  
**A:** Yes. Database and user creation use `IF NOT EXISTS`, making re-runs safe.  
Existing Nginx configuration files are replaced, but no data is deleted.

**Q:** Does this modify existing Nginx settings?  
**A:** No. It adds a standalone host file in `/etc/nginx/conf.d/`  
and validates configuration changes before applying them.

---

### More Information

More guides and documentation can be found on [wiki.x-files.dk](https://wiki.x-files.dk)

---

### License

Licensed under the [MIT License](./LICENSE).

---