Guia atualizado para instalar o Centova Cast v3 em servidor próprio: requisitos, licença, MariaDB, instalador oficial, firewall e primeiros ajustes.
O Centova Cast é um painel comercial para hospedar rádios Shoutcast e Icecast, com AutoDJ, DJs, estatísticas e revenda. Ele é instalado no seu servidor com uma licença da Centova Technologies. Este guia segue o instalador oficial e serve para quem administra o próprio servidor. Se você quer apenas colocar uma rádio no ar, não precisa instalar nada: a rádio hospedada já vem com o painel pronto.
Requisitos em 2026
| Item | O que vale hoje |
|---|---|
| Sistema operacional | A documentação oficial cita CentOS 7 ou 8 (e RHEL equivalente) e Debian estável. A versão 3.2.15 (2023) acrescentou Rocky Linux, AlmaLinux e CentOS Stream. Como o CentOS 7 acabou em 30/06/2024 e o CentOS 8 em 31/12/2021, use AlmaLinux ou Rocky Linux 8 ou 9, ou Debian estável. |
| Servidor | Instalação limpa, sem cPanel, Plesk ou outro painel. Pelo menos um IP. As portas 80 e 21 desse IP não podem ter outro servidor web ou de FTP, se você for usar o proxy na porta 80 e o FTP do Centova. |
| Banco de dados | MySQL ou MariaDB, local ou na rede. |
| Ferramentas | Compilador gcc, gerenciador de pacotes funcionando (dnf/yum ou apt) e cron. |
| Hardware | Sem mínimo oficial publicado. O disco cresce com as músicas de cada rádio, e cada AutoDJ é um processo Liquidsoap com memória própria. Dimensione pelo número de rádios com AutoDJ. |
Licença
A licença é comprada no site da Centova Technologies. Cada licença vale para um servidor físico ou VPS, com opções por número de estações (1, 10, 25 ou mais) e pagamento mensal, anual ou único, além de teste gratuito. Cada servidor extra de streaming ligado ao mesmo painel (control daemon) precisa da própria licença. A chave da licença fica na área do cliente da Centova e é usada no download do instalador.
Passo 1: prepare o sistema
Conectado como root (veja como acessar o SSH como root), atualize o sistema e instale os pré-requisitos.
No AlmaLinux ou Rocky Linux:
dnf -y update
dnf -y install mariadb-server findutils wget tar gzip unzip sed grep gawk rsync gcc gcc-c++ make which tmux
No Debian:
apt update && apt -y upgrade
apt -y install mariadb-server findutils wget tar gzip unzip sed grep rsync build-essential debianutils tmux
Acerte o fuso horário do servidor (as playlists agendadas dependem do relógio):
timedatectl set-timezone America/Sao_Paulo
Passo 2: configure o MariaDB e crie o banco
systemctl enable --now mariadb
mariadb-secure-installation
No assistente, defina a senha do root do banco e responda sim para remover usuários anônimos, bloquear o root remoto e apagar o banco de teste. Depois crie o banco e o usuário do Centova:
mariadb -u root -p
CREATE DATABASE centova;
CREATE USER 'centova'@'localhost' IDENTIFIED BY 'TroqueEstaSenha';
GRANT ALL PRIVILEGES ON centova.* TO 'centova'@'localhost';
FLUSH PRIVILEGES;
EXIT;
Troque TroqueEstaSenha por uma senha forte e anote os três dados (banco, usuário e senha): eles serão pedidos no passo 5.
Passo 3: baixe o instalador oficial
wget -O install.sh install.centova.com/SUA-CHAVE-DE-LICENCA
chmod a+x ./install.sh
Troque SUA-CHAVE-DE-LICENCA pela chave da sua licença.
Passo 4: rode o instalador
A instalação compila o Liquidsoap e pode levar bastante tempo. Rode dentro do tmux, para não perder o processo se a conexão SSH cair:
tmux new -s centova
./install.sh --shoutcast2 --icecast --liquidsoap
Se a conexão cair, entre de novo e volte à sessão com tmux attach -t centova. As opções principais do instalador:
| Opção | O que faz |
|---|---|
--shoutcast2 | Instala o Shoutcast DNAS v2 |
--icecast | Instala o Icecast |
--liquidsoap | Instala o Liquidsoap, o AutoDJ atual (o Centova 3.3 usa o Liquidsoap 2) |
--icescc / --sctrans2 | Instalam os AutoDJs alternativos ices-cc e sc_trans v2 |
--deps | Usa o dnf/yum ou o apt para instalar as dependências sozinho |
--secure=painel.seudominio.com.br [email protected] | Coloca o painel nas portas 80 e 443 com certificado Let's Encrypt. O domínio precisa já apontar para o IP do servidor |
--no-firewall | Não mexe no firewall |
--channel=testing | Usa o canal de testes da Centova. Evite em produção |
--force | Reinstala por cima de uma instalação existente e apaga as alterações. Só em servidor novo |
Passo 5: termine pelo navegador
- Abra o endereço que o instalador mostrar, normalmente
https://203.0.113.10:2199/com o IP do seu servidor. A mesma porta atende com e sem SSL. - Defina a senha do administrador do Centova.
- Informe o banco: servidor
localhost, bancocentova, o usuário e a senha criados no passo 2. - Entre no painel como admin. A partir daí você cria os modelos de conta e as primeiras rádios.
Para instalação sem passar pelo navegador, o instalador aceita --admin-email, --admin-pass, --dbname, --dbuser, --dbpass e --dbhost.
Passo 6: libere as portas no firewall
| Porta | Uso |
|---|---|
2199 | Painel web (precisa ser pública) |
2197 | Entrega de conteúdo do Centova (precisa ser pública) |
21 | FTP para os clientes enviarem músicas (opcional) |
80 e 443 | Proxy na porta 80 e painel com --secure (opcionais) |
8000 a 10000 | Portas das rádios Shoutcast e Icecast |
2198 | Só em servidores de streaming extras: comunicação com o painel, liberada apenas para o IP do painel |
No AlmaLinux e no Rocky, que usam o firewalld:
firewall-cmd --permanent --add-port=2199/tcp
firewall-cmd --permanent --add-port=2197/tcp
firewall-cmd --permanent --add-port=21/tcp
firewall-cmd --permanent --add-port=80/tcp
firewall-cmd --permanent --add-port=8000-10000/tcp
firewall-cmd --reload
Não feche a porta do SSH. Se você usa outro firewall, libere as mesmas portas nele.
Passo 7: ajustes opcionais no centovacast.conf
As opções globais ficam em /usr/local/centovacast/etc/centovacast.conf. Faça uma cópia antes de editar:
cp -p /usr/local/centovacast/etc/centovacast.conf /root/centovacast.conf.bak
nano /usr/local/centovacast/etc/centovacast.conf
| Opção | Padrão | Para que serve |
|---|---|---|
LOCALE | en_US | Idioma padrão do painel. Veja os idiomas disponíveis em /usr/local/centovacast/system/locale/. Cada rádio pode escolher o próprio idioma nas configurações dela |
CLIENT_ENCODER_SETTINGS | false | Com true, o cliente pode alterar as configurações de codificação da própria rádio |
UPLOAD_SIZE_LIMIT | 104857600 (100 MB) | Tamanho máximo, em bytes, de um arquivo enviado pelo gerenciador web. A própria Centova recomenda ser conservador: para arquivos grandes, FTP |
ALLOW_IMPORT_M3U | false | Permite importar playlists M3U. A Centova avisa que não dá suporte a esse recurso |
SELFREF_HOSTNAME | false | Usa o nome de host nos links em vez do IP. Só ative com o DNS já correto: com DNS errado, as rádios param |
Depois de salvar, reinicie o Centova (isso reinicia todas as rádios do servidor por alguns segundos):
/usr/local/centovacast/centovacast restart
Manutenção depois da instalação
- Atualizar:
/usr/local/centovacast/sbin/updateatualiza o painel e os programas de streaming instalados. O Centova nunca se atualiza sozinho. - Fique no canal stable. Versões do canal de testes já trouxeram regressões em funções do AutoDJ, como pular música.
- Atualize o Liquidsoap junto com o painel. As versões 3.3.x foram feitas para o Liquidsoap 2.4. Painel novo com Liquidsoap antigo dá erros no AutoDJ.
- Instalar componentes depois:
/usr/local/centovacast/sbin/update --add icecast(oushoutcast2,liquidsoap,icescc,sctrans2). - Faça backup do banco (
mariadb-dump), de/usr/local/centovacast/etce das pastasetcde cada rádio, para fora do servidor. Alterações feitas à mão em arquivos do sistema do Centova podem ser sobrescritas nas atualizações: anote o que mudou.
Problemas comuns
A instalação para na compilação do Liquidsoap
Faltam dependências de compilação. Veja os comandos que o instalador precisa com /usr/local/centovacast/sbin/update --add liquidsoap --show-liquidsoap-deps, instale e rode /usr/local/centovacast/sbin/update --add liquidsoap de novo. Se a rádio não liga por causa do Liquidsoap, veja o erro "binário da aplicação não configurado para liquidsoap".
O painel não abre na porta 2199
Firewall do servidor ou do provedor bloqueando a porta. Confira com firewall-cmd --list-ports e veja se o serviço está ativo com systemctl status centovacast.
Erro de conexão com o banco na etapa do navegador
Usuário, senha ou nome do banco diferentes do criado no passo 2, ou o MariaDB parado. Teste com mariadb -u centova -p centova.
O servidor web ou o FTP do sistema não sobe depois da instalação
Conflito de porta com o Centova, que usa a 80 (proxy) e a 21 (FTP). Mantenha um só serviço em cada porta ou use outro IP.
Tenho um Centova antigo em CentOS 7
O sistema não recebe mais correções de segurança. Planeje um servidor novo em AlmaLinux, Rocky ou Debian e migre as rádios, ou migre o sistema com ferramentas como o ELevate. Veja como atualizar o sistema e o kernel.