Debian e Hyprland num MacBook M1: guia de instalação
Como instalar Debian num MacBook Apple M1 através do port Bananas e preparar o Hyprland como compositor Wayland, seguindo a wiki oficial do Debian.
É possível correr Debian num MacBook M1 e usar o Hyprland como compositor Wayland. A instalação começa no macOS; depois, o Debian e os componentes certos tratam do resto.
O projeto Bananas mantém um port não oficial do Debian para Apple Silicon, com trabalho baseado no kernel e noutras peças do projeto Asahi Linux. O port é considerado maduro e já conta com dezenas de milhares de instalações, mas os patches necessários ainda não foram integrados no kernel principal. Por isso, o Debian não suporta oficialmente estas máquinas.
O foco está no Debian para M1 e M2 instalado através do instalador Asahi, com Hyprland (um compositor Wayland leve com gestão dinâmica de janelas), e não numa introdução geral ao Asahi Linux.
Compatibilidade e estado do port
Os MacBook Air e Pro, Mac mini e Mac Studio equipados com Apple Silicon M1 ou M2 usam a arquitetura ARM64. O port Bananas suporta atualmente máquinas M1 e M2. M3 e M4 não são suportados.
O port usa software open-source que ainda não está todo incluído no arquivo oficial do Debian. Entre as peças importantes está um kernel Linux com patches do Asahi Linux, um conjunto de alterações que ainda não foi integrado no kernel principal. Isso explica por que razão a instalação e algumas atualizações dependem do arquivo Bananas.
A equipa Debian Bananas mantém esse repositório e o instalador. O suporte oficial no debian-installer também terá de esperar: os patches do kernel precisam de ser integrados upstream antes de o Debian poder acrescentar suporte oficial. Há trabalho num instalador não oficial baseado no arquivo Bananas, mas não é necessário esperar por ele para instalar o sistema.
Instalar Debian com o instalador Asahi
O método recomendado pela wiki do Debian usa o instalador Asahi. Antes de começar, faz uma cópia de segurança dos dados importantes e confirma que tens espaço livre suficiente no armazenamento do Mac.
- Inicia o macOS e abre o Terminal.
- Corre o instalador:
curl -L https://bananas.debian.net/install | sh
A wiki também apresenta este endereço alternativo:
curl -L https://bananas-archive.debian.net/install | sh
- Segue as instruções no ecrã. O instalador pede que escolhas quanto espaço libertar da partição macOS, que tipo de instalação queres e o nome da entrada que aparecerá no seletor de disco de arranque.
- Para preparar uma instalação orientada para Hyprland, escolhe console-only. GNOME e KDE são as opções de ambiente gráfico oficialmente suportadas pelo port; a instalação mínima deixa-te configurar uma alternativa.
- Quando o instalador terminar, prime Enter para desligar o Mac.
- Volta a ligá-lo mantendo premido o botão de energia até aparecer Loading startup options.
- Seleciona o novo disco Debian e termina a configuração inicial.
O instalador altera o particionamento do disco. Lê cada confirmação antes de avançar e não interrompas o processo enquanto estiver a trabalhar.
Preparar o Debian para um ambiente alternativo
O port Bananas suporta oficialmente GNOME e KDE. Para outras opções, a wiki recomenda começar pela instalação mínima, usar tasksel para instalar o desktop pretendido e instalar também o metapacote asahi-platform. Este metapacote acrescenta suporte de áudio em instalações mínimas.
O Hyprland é um compositor Wayland, não um ambiente X11. A distinção importa neste caso: X11 não é suportado nestas plataformas, enquanto o Hyprland se enquadra no caminho Wayland. Isso não significa que o Hyprland seja oficialmente suportado pela equipa Bananas.
Instalar Hyprland em Debian 13, Trixie
Em setembro de 2026, o pacote hyprland não está na versão estável normal de Trixie. Está disponível para ARM64 em trixie-backports, na versão 0.55.2. O pacote também está disponível em unstable/sid, na versão 0.56.2. Para uma instalação Trixie estável, os backports evitam recorrer à distribuição unstable.
Adiciona o repositório de backports e instala o pacote:
echo 'deb http://deb.debian.org/debian trixie-backports main' | sudo tee /etc/apt/sources.list.d/trixie-backports.list
sudo apt update
sudo apt install -t trixie-backports hyprland
O pacote não está disponível em Debian 12, Bookworm. Para este guia, a opção mais direta é Debian 13, Trixie, com backports; compilar a partir do código-fonte é outra possibilidade, mas fica fora destes passos.
O Hyprland usa Aquamarine, não wlroots. Por isso, não definas WLR_RENDERER. Também não fixes manualmente XDG_RUNTIME_DIR; deixa o PAM e o logind tratarem dessa variável.
Iniciar uma sessão Hyprland
O pacote Debian fornece o comando start-hyprland, uma entrada hyprland.desktop e um ficheiro de configuração de exemplo em Lua. Podes iniciar o compositor a partir de um TTY depois de iniciares sessão:
start-hyprland
Não uses sudo. Se estiveres num gestor de início de sessão com seletor de sessões Wayland, também podes escolher Hyprland nessa lista.
A configuração inicial é utilizável sem grandes alterações. A combinação Super+Q abre o terminal na configuração padrão. Para definires explicitamente esse atalho no ficheiro ~/.config/hypr/hyprland.lua, podes usar:
hl.bind("SUPER + Q", hl.dsp.exec_cmd("foot"))
Gráficos e outras limitações
A aceleração gráfica depende do kernel e do driver DRM compatíveis com Asahi, além das bibliotecas Mesa instaladas. O projeto Asahi reporta suporte conformante para OpenGL 4.6, OpenGL ES 3.2 e Vulkan 1.3. Ainda assim, as versões dos componentes incluídos no Debian podem fazer diferença.
Os drivers GPU para M1 e M2 foram integrados no Mesa 25.1, versão que ficou de fora do Trixie. Para usar esses drivers em Trixie, a wiki indica compilar Mesa 25.1 ou posterior a partir do código-fonte, ou reconstruir o pacote Debian correspondente.
Há também limitações no arranque. O Debian distribui uma compilação compatível de u-boot, mas sem alguns patches downstream. O fork do Asahi pode ser necessário para arranque múltiplo com várias instalações Linux, para usar o teclado integrado durante o arranque inicial em portáteis M2 ou para usar portas USB-A nessa fase em Mac mini e Studio M2. A stack de gaming Asahi, que inclui libkrun, muvm, FEX e Steam, ainda não foi portada para Debian.
Arquivo Bananas e ajuda
Quem precisar de gerir o arquivo Bananas manualmente deve obter a chave de assinatura em bananas-archive.debian.net/bananas-archive. A suite trixie-bananas destina-se a Trixie; unstable-bananas acompanha Testing e experimental-bananas destina-se a desenvolvimento.
Para uma configuração avançada, a wiki apresenta um ficheiro deb822 como este:
Types: deb deb-src
URIs: https://bananas-archive.debian.net/bananas-archive
Suites: trixie-bananas
Components: main
Signed-By: /etc/apt/keyrings/bananas-archive-keyring.gpg
E um pinning correspondente:
Package: *
Pin: release n=trixie-bananas
Pin-Priority: 1050
A equipa está disponível no IRC/Matrix, no canal #debian-bananas, e através da lista de discussão debian-arm-apple.
Conclusão
Instalar Debian num Mac M1 passa pelo instalador Asahi e pelo port mantido pela equipa Bananas. Para usar Hyprland, começa com uma instalação mínima, instala o compositor a partir de Trixie Backports e inicia a sessão sem privilégios de administrador. A experiência gráfica depende também das versões do kernel e do Mesa, por isso convém confirmar as limitações antes de tratar o Mac como uma máquina Debian convencional.
Se já instalaste Debian num Mac Apple Silicon, partilha a tua configuração e as dificuldades que encontraste nos comentários.
Recursos
Partilhar
Comentários 0
Ainda sem comentários — sê o primeiro.