Pular para o conteúdo
Documentação

Instalar o painel miniCP

Como instalar o miniCP em um servidor Debian 13 limpo e fazer o primeiro acesso.

R Regis Manze 20/11/2026 3 min de leitura

Esta página mostra como colocar o miniCP no ar em um servidor novo. O instalador sobe só o painel. A pilha de hospedagem (servidor web, PHP, bancos de dados etc.) é instalada depois, pela própria interface, no Setup inicial.

Requisitos

Item Valor
Sistema Debian 13 (Trixie), de preferência recém-instalado
Usuário root (o painel cria usuários, gerencia serviços e edita configurações do sistema)
Porta do painel 5000
Portas dos sites 80 e 443
FTP (opcional) 21 e a faixa passiva 40000-40100

Atenção: o painel responde em HTTP na porta 5000. Libere essa porta no firewall só para as redes de onde a equipe administra o servidor.

Instalação automática

O pacote do miniCP e o instalador são fornecidos pela equipe miniDC. Com a pasta do painel já no servidor (o padrão é /opt/hosting-panel), rode como root:

cd /opt/hosting-panel
bash install.sh

O script faz, em ordem:

  1. Atualiza a lista de pacotes e instala as dependências pelo apt (git, rsync, curl, sudo e os módulos Python do painel).
  2. Confere se o código do painel está na pasta.
  3. Cria o serviço systemd do painel, com reinício automático. Se já existir um serviço do painel, ele é mantido.
  4. Habilita e inicia o serviço.
  5. Confere se o serviço subiu e mostra o endereço de acesso.

Ao terminar, você vê algo como:

✓ miniCP no ar!
   Acesse:  http://IP_DO_SERVIDOR:5000
   Login:   root  (senha de root do sistema, via PAM)
   Depois:  Configuracoes > Setup Inicial para instalar a stack.

Dica: o script pode ser executado de novo sem risco. Ele não sobrescreve um serviço que já existe.

Instalar em outra pasta

O install.sh usa a pasta onde ele está. Se o painel estiver em outro caminho, rode o script de lá ou informe a pasta:

bash /opt/minicp/install.sh
# ou
MINICP_DIR=/opt/minicp bash install.sh

Primeiro acesso

  1. Abra http://IP_DO_SERVIDOR:5000 no navegador.
  2. Entre com o usuário root e a senha de root do sistema.
  3. No menu lateral, vá em Configuracoes e abra a aba Setup.
  4. Marque o que deseja instalar e clique em Iniciar Setup. Veja Setup inicial do servidor.

Atenção: o Setup foi feito para servidor virgem. Se o servidor já tem Apache, PHP ou banco de dados configurados, não rode o Setup. Ajuste cada parte pelas telas PHP, Servicos, Modo de Operacao e Tuning.

Se o painel não subir

Veja o log do serviço. O nome do serviço é mageweb ou hosting-panel, conforme a instalação:

systemctl status mageweb --no-pager
journalctl -u mageweb -n 50 --no-pager

Erro de importação de módulo Python indica dependência faltando. Rode o install.sh de novo.

Atenção: no Debian 13 as bibliotecas Python vêm do apt. Não use pip para instalar dependências do painel.

Reiniciar o painel

Depois de qualquer troca manual de arquivos do painel, é preciso reiniciar o serviço para o código novo valer:

systemctl restart mageweb

A atualização feita pela interface já reinicia sozinha. Veja Atualizar o painel.

Opcionais após a instalação

Recurso Onde ativar
FTP (vsftpd) Menu FTP; portas em Configuracoes → FTP
Cota de disco Menu Usuarios ou opção Quota de disco no Setup
Banco de dados remoto Menu Bancos de Dados
Reinício automático de serviços Servicos → Auto-restart em todos
Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!