Instalação

Este guia orienta-o através de uma instalação limpa, atualizações seguras e uma remoção limpa. Inclui pré-requisitos, exemplos de comandos e verificações pós-instalação para que possa validar os serviços, a firewall e o DNS antes de entrar em funcionamento.

Requisitos do sistema

  • Instalação nova do Debian 13 (sem pilha web ou de e-mail pré-existente)
  • Acesso root no servidor
  • Um domínio para o painel e o e-mail (com registos glue se hospedar DNS)
  • PTR (DNS reverso) para o nome de host do e-mail
  • Portas abertas: 22, 80, 443, 25, 465, 587, 993, 995, 53

Instalação pelo GitHub

Execute o instalador a partir do GitHub:

curl -fsSL https://raw.githubusercontent.com/shukiv/jabali-panel/main/install.sh | sudo bash

Sinalizadores opcionais:

  • JABALI_MINIMAL=1 para instalação apenas do núcleo
  • JABALI_FULL=1 para forçar todos os componentes opcionais
  • --debug para saída detalhada

O instalador clona o painel para /var/www/jabali e configura os serviços, nginx, SSL e pacotes de sistema necessários.

Compilação manual de pacotes Debian

O Jabali é fornecido como dois pacotes Debian:

  • jabali-deps para dependências do sistema (nginx, PHP, DB, e-mail, DNS, etc.)
  • jabali-panel para a aplicação do painel e serviços systemd

Compile os pacotes a partir da raiz do repositório:

./scripts/build-jabali-deps-deb.sh
./scripts/build-jabali-panel-deb.sh

Instale no servidor:

sudo dpkg -i ./jabali-deps_<version>_all.deb
sudo apt-get -f install -y
sudo dpkg -i ./jabali-panel_<version>_all.deb

Após a instalação, os serviços systemd são ativados e iniciados:

  • jabali-agent
  • jabali-queue
  • jabali-health-monitor

URLs pós-instalação

  • Painel de administração: https://your-host/jabali-admin
  • Painel do utilizador: https://your-host/jabali-panel
  • Webmail: https://your-host/webmail

Atualizações

Se instalou através do GitHub ou compilação manual, a partir do diretório do painel:

cd /var/www/jabali
php artisan jabali:upgrade

Verificar apenas atualizações:

php artisan jabali:upgrade --check

Desinstalar

Antes de desinstalar, faça cópias de segurança dos dados do painel e do conteúdo do utilizador.

Parar e desativar serviços:

sudo systemctl stop jabali-agent jabali-queue jabali-health-monitor
sudo systemctl disable jabali-agent jabali-queue jabali-health-monitor

Remova os pacotes (mantenha as configurações) ou elimine (remova as configurações):

sudo apt remove jabali-panel jabali-deps
# or
sudo apt purge jabali-panel jabali-deps

Limpeza opcional (remove ficheiros e configurações do painel):

sudo rm -rf /var/www/jabali
sudo rm -rf /etc/jabali
sudo rm -rf /etc/nginx/jabali
sudo rm -rf /etc/ssl/jabali
sudo rm -f /root/.jabali_db_credentials
sudo rm -f /root/jabali_credentials.txt

Se pretender remover a base de dados do painel e o utilizador:

sudo mysql -e "DROP DATABASE IF EXISTS jabali;"
sudo mysql -e "DROP USER IF EXISTS jabali@localhost;"

Resolução de problemas

  • Se o painel não carregar, confirme se o nginx está a funcionar e se as portas 80/443 estão abertas.
  • Verifique o estado do serviço com systemctl status jabali-agent jabali-queue jabali-health-monitor.
  • Revise os registos em storage/logs e na saída do diário do sistema.