Esta seção fornece instruções passo a passo para instalar a interface web do Zabbix. Siga estas etapas depois de ter instalado o backend do Zabbix - Zabbix server, agent e banco de dados.

O frontend do Zabbix é escrito em PHP, portanto, para executá-lo, é necessário um servidor web com suporte a PHP.

Você pode encontrar mais informações sobre a configuração de SSL para o frontend do Zabbix consultando estas melhores práticas.

Tela de boas-vindas

Abra a URL do frontend do Zabbix no navegador:

Para Apache: http://<server_ip_or_name>/zabbix
Para Nginx: http://<server_ip_or_name>

Você deverá ver a primeira tela do assistente de instalação do frontend.

Use o menu suspenso Idioma padrão para alterar o idioma padrão do sistema e continuar o processo de instalação no idioma selecionado (opcional). Para mais informações, consulte Instalação de idiomas adicionais do frontend.

Observe que definir o idioma como English (en_US) também habilitará o formato de data/hora dos EUA no frontend.

Verificação de pré-requisitos

Certifique-se de que todos os pré-requisitos obrigatórios do frontend do Zabbix sejam atendidos.

Pré-requisito	Valor mínimo	Descrição
Versão do PHP	8.2.0
Opção do PHP `memory_limit`	`128MB`	Em `php.ini`: `memory_limit = 128M`
Opção do PHP `post_max_size`	`16MB`	Em `php.ini`: `post_max_size = 16M`
Opção do PHP `upload_max_filesize`	`2MB`	Em `php.ini`: `upload_max_filesize = 2M`
Opção do PHP `max_execution_time`	`300` segundos	Em `php.ini`: `max_execution_time = 300` (os valores `0` e `-1` também são permitidos)
Opção do PHP `max_input_time`	`300` segundos	Em `php.ini`: `max_input_time = 300` (os valores `0` e `-1` também são permitidos)
Suporte a bancos de dados no PHP	Um de: MySQL, PostgreSQL	Consulte Requirements para a lista de todas as extensões PHP obrigatórias e opcionais. Observe que pré-requisitos opcionais com falha são exibidos com o status vermelho Warning, e o processo de instalação pode continuar mesmo que eles não sejam atendidos.
PHP BCMath	deve estar habilitado
PHP mbstring	deve estar habilitado
Opção do PHP `mbstring.func_overload`	deve estar desabilitada	Em `php.ini`: `mbstring.func_overload = 0`
Opção do PHP `session.auto_start`	deve estar desabilitada	Em `php.ini`: `session.auto_start = 0`
Opção do PHP `arg_separator.output`	`&`	Em `php.ini`: `arg_separator.output = "&"` (o valor `"&"` também é permitido)

Se o usuário ou o grupo de usuários do Apache precisar ser alterado, verifique as permissões da pasta de sessão; caso contrário, a configuração do Zabbix pode não conseguir continuar.

Configurar conexão com o banco de dados

Informe os detalhes para conectar ao banco de dados. O banco de dados do Zabbix já deve ter sido criado.

Para MySQL, informar localhost ou deixar o campo Database host em branco resulta na conexão via socket Unix padrão. O formulário de configuração não fornece um campo separado Database socket, portanto, para usar um socket personalizado, configure-o nas definições do Zabbix server (por exemplo, com DBSocket= em zabbix_server.conf). Isso mantém o frontend alinhado com as definições de conexão entre o server e o banco de dados.

Para PostgreSQL, o campo Database host pode conter várias entradas host:port separadas por vírgulas. A string é dividida em partes e cada porta é validada da mesma forma que o campo Database port. Após a validação bem-sucedida, a string é analisada em hosts e portas para compor a string de conexão. Se uma porta não estiver definida para um host na lista separada por vírgulas, o valor de Database port é usado como porta padrão. Se o campo Database host for deixado em branco, o socket Unix de domínio padrão será usado. Se um caminho de socket for informado (por exemplo, /var/run/pgbouncer), esse socket Unix de domínio será usado em seu lugar.

Se a opção Database TLS encryption estiver marcada, campos adicionais para configurar a conexão TLS com o banco de dados aparecerão no formulário (somente MySQL ou PostgreSQL).

Se Store credentials in estiver definido como HashiCorp Vault ou CyberArk Vault, parâmetros adicionais ficarão disponíveis:

para HashiCorp Vault: endpoint da API do Vault, prefixo do Vault, caminho do segredo e token de autenticação ou AppRole;
para CyberArk Vault: endpoint da API do Vault, prefixo do Vault, string de consulta do segredo e certificados. Ao marcar a caixa Vault certificates, dois novos campos para especificar os caminhos do arquivo de certificado SSL e do arquivo de chave SSL serão exibidos.

Configurações

Inserir um nome para o Zabbix server é opcional; no entanto, se informado, ele será exibido na barra de menu e nos títulos das páginas.

Defina o fuso horário e o tema padrão para o frontend.

Se a opção Criptografar conexões da interface web estiver marcada, campos adicionais para configurar a conexão TLS entre o Zabbix server e o frontend aparecerão no formulário.

Resumo da pré-instalação

Revise um resumo das configurações.

A subpágina mostrará os dados se a configuração TLS tiver sido adicionada.

Instalação

Se estiver instalando o Zabbix a partir do código-fonte, faça o download do arquivo de configuração e coloque-o em conf/ no subdiretório de documentos HTML do webserver onde você copiou os arquivos PHP do Zabbix.

Se o usuário do webserver tiver permissão de gravação no diretório conf/, o arquivo de configuração será salvo automaticamente e será possível prosseguir para a próxima etapa imediatamente.

Conclua a instalação.