Instalando o Alta

Baixe e execute o instalador e, em seguida, inicie o assistente de configuração para criar seu primeiro serviço Alta.

Requisitos

Linux x86-64. Recomendamos usar o Fedora 42.
Acesso root ou sudo para a instalação única.
curl e tar.
Conexão com a internet para a validação periódica da licença (conecta-se a ls4.cesbo.com).

Instalação

Se você está atualizando uma instalação existente, faça backup da sua configuração e da sua licença antes de executar o instalador.

Execute o instalador
Terminal window
```
curl -fsSL https://alta.cesbo.com/install.sh | sh
```
O instalador verifica se o servidor é Linux x86-64, baixa a versão estável mais recente e instala o binário em /usr/local/bin/alta. Se você não estiver executando como root, ele usa sudo para instalar o binário.
Inicie o assistente de configuração
Terminal window
```
sudo /usr/local/bin/alta init
```
O assistente cria o arquivo de configuração e pode registrar o Alta como um serviço do systemd.

Se o Alta já estiver instalado, o instalador apenas atualiza /usr/local/bin/alta. Ele não reinicia os serviços em execução. Reinicie o seu serviço Alta para usar o novo binário:

sudo systemctl restart alta
sudo systemctl status alta --no-pager

Substitua alta pelo nome do seu serviço se você escolheu um nome diferente no assistente. Se vários serviços usam este binário, reinicie cada serviço que você deseja atualizar.

Para testes públicos, use a licença compartilhada. Não é necessária ativação no seu perfil da Cesbo:

sudo mkdir -p /etc/alta
echo '{"l":"11a4ae46b8981cdd7e39f880ca778a71e568fa6a"}' | sudo tee /etc/alta/license.txt >/dev/null

Se a sua configuração não estiver em /etc/alta, salve o license.txt ao lado dela. Em seguida, abra a interface web → Check license → Re-check now. Não é necessário reiniciar.

Assistente de configuração

O assistente de inicialização prepara um novo serviço no seu sistema. Cada serviço tem seu próprio arquivo de configuração, porta de gerenciamento e nome exclusivo. Inicie o assistente de inicialização com este comando:

sudo /usr/local/bin/alta init

Service name: identificador exclusivo do serviço.
Config path: caminho completo do arquivo de configuração; os diretórios são criados conforme necessário.
Admin login: nome de usuário do primeiro administrador.
Admin password: defina e confirme a senha (não é exibida durante a digitação).
Management port: porta da API/interface web. Padrão 8100.
OTT Port: porta para os espectadores receberem streams HLS. Padrão 8102.
Add to systemd: registra o serviço para o gerenciamento do sistema.
Launch on startup: ative se o serviço foi adicionado ao systemd.
Start service: inicia imediatamente.

Uma porta sem endereço (por exemplo, 8100) escuta em todas as interfaces de rede. Um endereço com porta (por exemplo, 127.0.0.1:8100) aceita conexões apenas nesse endereço, portanto 127.0.0.1 é acessível somente a partir da máquina local.

Você pode executar vários serviços usando nomes de serviço e portas exclusivos. Saiba mais: Gerenciar serviços do Alta

Instalar uma versão específica

Para testes beta, suporte ou rollback, você pode instalar uma versão específica em vez da versão estável mais recente:

alta_tmp=$(mktemp -d) &&
curl -fL https://cdn.cesbo.com/alta/builds/alta-261019 -o "$alta_tmp/alta" &&
sudo install -m 0755 "$alta_tmp/alta" /usr/local/bin/alta &&
rm -r "$alta_tmp"

Substitua 261019 pela versão de que você precisa. Os links de download das versões estão listados no Registro de alterações.

Em uma instalação nova, execute o assistente de configuração:

sudo /usr/local/bin/alta init

Em uma instalação existente, reinicie o serviço para carregar o novo binário:

sudo systemctl restart alta
sudo systemctl status alta --no-pager

Substitua alta pelo nome do seu serviço se você escolheu um nome diferente no assistente. Se vários serviços usam este binário, reinicie cada serviço que você deseja atualizar.

Acessar a interface web

O seu serviço está pronto para uso. Conecte-se à interface web usando qualquer navegador. Se você manteve a porta padrão 8100, o endereço da interface será http://server-address:8100, onde server-address é o IP ou o nome do host do seu servidor. Para fazer login, use o login e a senha de administrador que você definiu no assistente. Se você esqueceu a senha, consulte Alterar senha.

Os espectadores recebem os streams na porta OTT, por exemplo http://server-address:8102/<channel>/index.m3u8. Você pode verificar ou alterar a porta em Settings → HTTP Servers. Saiba mais: Formato de URL

Se a interface não estiver acessível, verifique o firewall do servidor. Permita o acesso TCP à porta de gerenciamento (padrão 8100) a partir de endereços de administradores confiáveis e à porta OTT (padrão 8102) a partir das redes dos espectadores. Use as portas que você configurou se elas forem diferentes das padrão.