Instalar o SakerCP

Para quem tem uma licença activa da fase alpha. A licença é do IP público do servidor: o repositório só entrega os pacotes a esse IP, e o painel confirma-a sozinho. Durante a alpha, instale num servidor novo, sem nada em produção.

Antes de começar

• Servidor novo (dedicado ou VPS), x86_64, com CloudLinux OS 8 ou 9 ou AlmaLinux 8 ou 9 mínimo para converter. Sem outro painel instalado. Pelo menos 2 CPU, 4 GB de memória e 40 GB de disco.
• O IPv4 público do servidor é o da licença (se tiver vários, um deles). O servidor fala com o repositório e com o servidor de licenças por IPv4.
• Um nome para o servidor (por exemplo srv1.exemplo.pt) com o registo A (e AAAA, se tiver IPv6) a apontar para o servidor, e, se possível, o inverso (PTR) do IP com esse nome: sem ele, muitos servidores de correio recusam o que este enviar.
• A licença da CloudLinux da edição do plano (Solo, Admin, Shared ou Shared Pro): sua, ou pedida a nós no portal das licenças.
• Opcional: uma licença do Imunify360 (antivírus, WAF e firewall). O painel funciona sem ele, mas sem essas protecções.
• Um e-mail de administrador que exista: é para lá que o servidor manda os avisos (o --email).
• Opcional: a rede de onde vai administrar (o seu IP fixo, a rede do escritório ou a VPN). Com ela, a administração do painel só abre a partir daí; sem ela, abre de qualquer IP, com a password e a autenticação em dois passos. Pode configurá-la depois, em Segurança › Redes de gestão.

Instalar com o instalador

Como root, no servidor (com o nome a apontar para ele):

curl -fsSO https://repo.sakercp.com/install.sh
bash install.sh --host srv1.exemplo.pt --email admin@exemplo.pt --lang pt

O instalador confirma a licença do SakerCP deste IP; num AlmaLinux converte-o em CloudLinux (pela licença CloudLinux do IP, ou com --cloudlinux-key-file /root/cloudlinux.key, um ficheiro só do root com a chave de activação) e pede um reinício; liga as quotas e a MariaDB, instala os pacotes, configura o servidor e cria o primeiro administrador. Se uma licença falhar, pára e diz porquê e o que fazer: a do SakerCP (por aprovar, revogada, inexistente) ou a da CloudLinux (chave recusada, IP sem licença). Pode correr-se outra vez sem estragar nada; depois de um reinício, corre-se o mesmo comando. Outras opções: --admin-net (de onde vai administrar, várias redes separadas por vírgulas; sem ela, de qualquer IP), --ns1/--ns2, --imunify-key-file e --lang pt (as mensagens em português; sem ela, em inglês, como os comandos). O registo fica em /var/log/sakercp-install.log.

Os passos abaixo são o que o instalador faz, para quem prefira fazê-los à mão.

1. CloudLinux

Num AlmaLinux 8 ou 9, converter para CloudLinux com a chave de activação (ou -i numa licença por IP) e reiniciar:

dnf -y install wget
wget https://repo.cloudlinux.com/cloudlinux/sources/cln/cldeploy
sh cldeploy -k <chave-de-activação>
reboot

Depois do reinício, cldetect --check-license tem de responder OK.

2. Quotas e base de dados

O painel usa as quotas de disco por utilizador no sistema de ficheiros das homes. O melhor é /home numa partição própria, XFS montada com uquota,gquota (no /etc/fstab), ou ext4 com a funcionalidade quota. quotaon -pu /home tem de dizer que estão ligadas.

dnf -y install mariadb-server
systemctl enable --now mariadb

Nos planos Shared Pro, o sakercp-setup instala depois o MySQL Governor, que troca a MariaDB pela da CloudLinux; num servidor novo, sem bases de dados, isso é automático.

3. O SakerCP

curl -fsSo /etc/yum.repos.d/sakercp.repo https://repo.sakercp.com/sakercp.repo
dnf -y install sakercp sakercp-cpvendor

O dnf pede para aceitar a chave do repositório: confirme que a impressão digital é AAFD 07EB 2FAB 0DA2 78F2 3FB1 1699 16C6 F393 5FCD.

Depois, a configuração do servidor, com os seus valores:

export SK_HOST=srv1.exemplo.pt
export SK_IP4=203.0.113.10          # o IP da licença
export SK_IP6=                      # vazio se não tiver IPv6
export SK_NS1=ns1.exemplo.pt SK_NS2=ns2.exemplo.pt
export SK_NS1_IPS='"203.0.113.10"' SK_NS2_IPS='"203.0.113.10"'
export SK_ADMIN_EMAIL=admin@exemplo.pt
export SK_ADMIN_NET=198.51.100.0/24  # de onde vai administrar
sakercp-setup

O sakercp-setup verifica primeiro o que falta (CloudLinux licenciado, quotas, MariaDB, nenhum outro painel) e recusa continuar se faltar alguma coisa, com a lista. Depois configura o Apache, o correio, o DNS, o FTP, o CageFS e a firewall. Pode correr outra vez sem estragar nada.

4. O primeiro administrador

/opt/sakercp/bin/sk-broker admin-create admin
reboot

As credenciais ficam em /root/sakercp-admin-admin.txt: a password e o código para a aplicação de autenticação (o segundo passo é obrigatório na administração). Apague o ficheiro depois de as guardar. O reinício aplica a protecção do /proc.

A administração abre em https://srv1.exemplo.pt:2444/ (só a partir da rede indicada) e o painel dos clientes em https://srv1.exemplo.pt:2443/ e em https://painel.<domínio do cliente>. A licença vê-se em Software › Licença do SakerCP.

5. Imunify360 (opcional)

Com a licença do Imunify360, depois do sakercp-setup:

wget https://repo.imunify360.cloudlinux.com/defence360/i360deploy.sh
bash i360deploy.sh --key <chave-do-imunify360>
imunify360-agent install-vendors

A interface do Imunify360 abre na administração do painel.

A edição da CloudLinux

O painel ajusta-se à edição da licença CloudLinux: na Solo, uma conta de alojamento e sem limites de recursos (LVE) nem MySQL Governor; na Admin, até 5 contas e sem Governor; na Shared e na Shared Pro, sem limite de contas, com revendedores e com o Governor. Se a licença mudar de edição (por exemplo, de Solo para Shared Pro), a administração avisa e, em Rede e certificados › Hostname e resolvers, o botão Instalar o que falta instala o que a edição nova permite. Para cada site, o domínio e o www têm de apontar para o servidor antes do certificado.

Actualizações

O painel actualiza-se sozinho: as versões críticas (falhas de segurança) em poucos minutos, as outras todos os dias às 02:00, com verificação de saúde e volta atrás automática. O nível escolhe-se em Software › Actualizações do SakerCP; à mão, sakercp-update. Só os serviços do painel reiniciam: os sites, o correio e as bases de dados não param. Sem licença activa, o repositório não entrega actualizações.

Ajuda

Durante a alpha, escreva para alpha@sakercp.com com o que correu mal e a saída do comando.