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:
- Atualiza a lista de pacotes e instala as dependências pelo
apt(git, rsync, curl, sudo e os módulos Python do painel). - Confere se o código do painel está na pasta.
- Cria o serviço systemd do painel, com reinício automático. Se já existir um serviço do painel, ele é mantido.
- Habilita e inicia o serviço.
- 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
- Abra
http://IP_DO_SERVIDOR:5000no navegador. - Entre com o usuário root e a senha de root do sistema.
- No menu lateral, vá em Configuracoes e abra a aba Setup.
- 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 usepippara 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 |