Linux Quick Tips: Toolbx

Recentemente formatei meu notebook.

Tenho usado o Fedora Workstation como meu OS desde que parei com o famigerado distro hopping.

Um desafio que enfrentei na minha configuração é lidar com softwares que não estão disponíveis nos repositórios DNF ou que não são compatíveis com a distro por qualquer motivo.

Um bom exemplo disso é o Playwright, uma ferramenta para testes end-to-end de aplicações web que gosto de usar.

Segundo a documentação oficial, o Playwright oferece suporte oficial ao Ubuntu — mas não ao Fedora.

Como contorno essa limitação sem abandonar minha distro preferida?

A resposta: Toolbx!

O Toolbx é uma ferramenta que permite executar ambientes containerizados usando containers OCI, com Podman (padrão) ou Docker como back-end.

Executando Playwright com Toolbx

Se você está usando Fedora Workstation como eu, o Toolbx já vem pré-instalado.

Caso contrário, pode seguir as instruções de instalação aqui.

Vamos configurar um projeto Playwright dentro de uma toolbox.

Criando um Projeto

mkdir toolbx-rocks
cd toolbx-rocks
npm init -y
npm init playwright@latest

Quando perguntado sobre instalar dependências do sistema e drivers de navegador, escolha Não — vamos cuidar disso dentro da toolbox.

Criando e Entrando em uma Toolbox Ubuntu

Crie um container toolbox executando Ubuntu 24.04:

toolbox create --distro ubuntu --release 24.04 ubuntu

Depois, entre no container:

toolbox enter ubuntu

💡 Dica: Se você está usando Ghostty, pode ter problemas com seu input, backspace, ou comandos como clear dentro do container, rode o seguinte para contornar:

TERM=xterm-256color toolbox enter ubuntu

Instalando as Dependências do Playwright

Dentro da toolbox, navegue até o diretório do projeto e execute:

npx playwright install
npx playwright install-deps

Esses comandos vão instalar os drivers de navegador necessários e as dependências do sistema.

Rodando o Playwright

Para verificar se tudo funciona:

npx playwright test --ui

Você deve ver a interface do Playwright aparecer. Screenshot da UI do Playwright

Noice.

Conclusão

O Toolbx é bem útil para rodar software que não tem suporte na sua distro — como o Playwright neste caso.

Embora este não seja o caso de uso mais avançado, ele mostra como o Toolbx pode resolver esse tipo de problema com pouco overhead.

Existem outras ferramentas por aí, como o Distrobox, mas como estou seguindo uma abordagem mais stick to defaults, vou com a opção pré-instalada.

Obrigado por ler.

Provavelmente vou postar mais dicas rápidas como essa no futuro.