# Instalação

> Onde obter o Vukem Video, o que é cada download e como conferi-lo antes de executar.

Source: https://alexgalhardo.github.io/vukem-video/pt-br/docs/installation/

**Warning:**
O Vukem Video está na fase ALPHA: o editor, a CLI e o servidor MCP funcionam, e novas versões (`v0.N.0`) acrescentam recursos a cada cerca de 90 commits. Veja o [changelog](/changelog) para saber o que cada versão muda.

## O que você vai aprender

- qual arquivo baixar para o seu sistema, ou como executar a imagem de contêiner;
- como iniciar o servidor e onde ele escuta;
- como conferir um download antes de executá-lo.

## A ideia

O Vukem Video roda apenas no seu computador. Você instala um único programa, o `vukem-video`. Ele serve o editor no navegador, o servidor MCP, a CLI e a API HTTP a partir do mesmo processo e do mesmo espaço de trabalho.

## Início rápido

1. Abra a [página de versões](https://github.com/AlexGalhardo/vukem-video/releases) e baixe o instalador do seu sistema, ou o arquivo compactado da sua plataforma.
2. Instale. O instalador adiciona o `vukem-video` ao seu path.
3. Execute `vukem-video version`. Ele imprime a versão, o que mostra que o programa está instalado.
4. Execute `vukem-video serve`. Ele escuta em `127.0.0.1:7878` e em nenhum outro lugar.

### A imagem de contêiner

Toda versão estável também publica uma imagem multiarquitetura com o FFmpeg LGPL fixado dentro, em dois registros com o mesmo digest: `ghcr.io/alexgalhardo/vukem-video` e `alexgalhardo/vukem-video` no Docker Hub. As tags são `X.Y.Z`, `X.Y` e `latest`. O espaço de trabalho fica no volume `/data`, então mantenha-o em um volume nomeado ou em uma pasta de sua escolha:

```bash
docker run --rm -p 127.0.0.1:7878:7878 -v vukem-video:/data \
  -e APP_KEY="$(openssl rand -base64 32)" \
  ghcr.io/alexgalhardo/vukem-video:X.Y.Z
```

O contêiner roda como o usuário `app` (uid 10001) e, por padrão, não envia dados para lugar nenhum. `docker run --rm ghcr.io/alexgalhardo/vukem-video:X.Y.Z version` imprime a versão.

Para compilar a partir do código-fonte, você precisa do Go (a versão do `go.mod`) e do Bun para o front-end.

### O aplicativo desktop

Uma versão que traz o aplicativo desktop lista um arquivo por sistema ao lado dos outros instaladores: `vukem-video-desktop_X.Y.Z_windows_amd64_setup.exe` para o Windows 11, `vukem-video-desktop_X.Y.Z_darwin_arm64.dmg` (Apple silicon) ou `..._darwin_amd64.dmg` (Intel) para o macOS e `vukem-video-desktop_X.Y.Z_linux_amd64.deb` para Debian e Ubuntu. Cada um contém a janela e o servidor que ela inicia. A página do [aplicativo desktop](/docs/guide/desktop) explica o que ele faz.

### Os instaladores do BETA sem assinatura

Nenhum instalador é assinado com um certificado pago: no BETA não há Apple Developer ID, nem notarização, nem certificado de assinatura de código do Windows. Por isso o Windows e o macOS avisam antes da primeira execução. Isso é esperado; o que prova que o arquivo é genuíno é o checksum e a assinatura da versão, que você pode [verificar](/docs/self-hosting/verify-a-release).

- **Windows.** O SmartScreen mostra "O Windows protegeu seu PC". Escolha **Mais informações** e depois **Executar assim mesmo**.
- **macOS.** O Gatekeeper diz que o app não pode ser aberto porque a Apple não consegue verificá-lo. Clique com o botão direito (ou com Control) no app, escolha **Abrir** e depois **Abrir** de novo. Ou remova a marca de quarentena em um terminal: `xattr -d com.apple.quarantine "/Applications/Vukem Video.app"`.
- **Debian e Ubuntu.** Sem aviso. Instale com `sudo apt install ./vukem-video-desktop_X.Y.Z_linux_amd64.deb`.

## Erros comuns

- O sistema avisa antes da primeira execução. Os instaladores não são assinados com um certificado pago; veja [Os instaladores do BETA sem assinatura](#os-instaladores-do-beta-sem-assinatura) acima para as etapas do SmartScreen e do Gatekeeper e, se quiser uma prova, [verifique o download](/docs/self-hosting/verify-a-release) antes.
- O FFmpeg não é encontrado. O editor usa o seu FFmpeg, e `VUKEM_VIDEO_FFMPEG` e `VUKEM_VIDEO_FFPROBE` indicam os binários explicitamente. Veja as [variáveis de configuração](/docs/reference/configuration).

## Próximos passos

- [Primeiros passos: sua primeira exportação](/docs/quick-start)
- [Espaço de trabalho e armazenamento](/docs/workspace)
