📚 tutorial · 📅 2026-06-12 · 👤 fuzza
O Asahi Linux é, de longe, o projeto mais impressionante de portabilidade Linux desde o Raspberry Pi. Linux nativo em Apple Silicon, com GPU conformante OpenGL 4.6 e Vulkan 1.4, a correr num MacBook — algo que parecia impossível há 3 anos.
Quando a Apple anunciou a transição para ARM em 2020, ninguém sabia se o Linux alguma vez correria nativamente no M1. O ecossistema Apple Silicon é fechado, o boot é controlado pelo SEP, e os GPU drivers são proprietários. Ainda assim, uma equipa liderada por Hector Martin (marcan) conseguiu o impossível: engenharia reversa do hardware Apple e Linux funcional.
Estamos em Junho de 2026. O projeto está pós-marcan — ele entregou o testemunho e a comunidade continua. O estado atual é sólido: M1 e M2 são daily-driver, M3 está em progresso activo com GPU a chegar.
Neste guia vais aprender:
- O que é o Asahi Linux e como funciona o boot num MacBook Apple Silicon
- Três formas de instalar: Fedora Asahi Remix (oficial), Debian (Bananas Team), e Arch Linux ARM
- A arquitetura de boot em detalhe (m1n1 → U-Boot → GRUB → kernel)
- Suporte de hardware atual e o que funciona (ou não)
- Troubleshooting para problemas comuns
Pré-requisitos (para todos os métodos)
Antes de começares, confirma que tens tudo em ordem:
- Hardware: MacBook Apple Silicon com processador M1, M1 Pro, M1 Max, ou M1 Ultra. M2 também funciona. M3 está em progresso (lê a tabela de suporte abaixo).
- macOS: 13.5+ (Ventura) ou 14.2+ (Sonoma). Se tens macOS 27 Golden Gate beta, lê a secção de troubleshooting primeiro — há um bug conhecido no boot picker que impede o dual-boot.
- Espaço em disco: Pelo menos 40 GB livres, recomendado 60+ GB. O instalador pergunta quanto queres alocar.
- SIP: Podes deixar ativo. O instalador trata das permissões necessárias.
- FileVault: Se está ativo, desativa ou garante que tens a recovery key à mão.
- Backup: Faz um Time Machine ou backup manual. Isto mexe com partições — não arrisques.
Aviso: O Asahi Linux envolve manipular o container APFS do macOS. A probabilidade de correr mal é baixa, mas zero não é. Ter um backup é o mínimo dos mínimos.
Método A: Fedora Asahi Remix (Oficial e Recomendado)
O Fedora Asahi Remix é a distribuição oficial do projeto Asahi. É a mais testada, a mais suportada, e onde o desenvolvimento acontece primeiro. Se és novo nisto, começa por aqui.
Instalação
Um comando. Literalmente:
curl https://fedora-asahi-remix.org/install | sh
Há também um comando genérico que funciona para todas as variantes:
curl -L https://alx.sh | sh
Passo a passo
- Abre o Terminal no macOS (podes usar o Spotlight com Cmd+Espaço e escrever "Terminal").
- Copia e cola o comando de cima. Corre como utilizador normal — não uses
sudo. O instalador pede permissão quando precisa. - O instalador pergunta quanto espaço queres alocar para o Linux. Vai aparecer uma barra no terminal com um slider. Usa as setas para ajustar. Mínimo recomendado: 60 GB.
- Escolhe o ambiente gráfico:
- KDE Plasma 6.6 — recomendado, mais polido, tema Asahi
- GNOME 50 — para quem gosta de GNOME, funciona bem
- Minimal — só terminal, para servidores ou instalação manual de WM
- Dá um nome ao "Startup Disk" — é como vai aparecer no menu de boot. Exemplo:
Asahi LinuxouFedora Asahi. - O instalador faz o download da imagem e configura tudo. Dependendo da velocidade da net, demora 5-15 minutos.
- Quando terminar, desliga o MacBook completamente.
- Liga o MacBook com o botão de power premido até aparecerem os discos de boot.
- Seleciona o disco que criaste (o nome que deste no passo 5).
- O setup de segunda fase corre automaticamente: criação de utilizador, configuração regional, etc.
É basicamente isto. Tens um Fedora a correr nativo no teu MacBook M1.
O que o instalador faz (por trás do pano)
O instalador não é um script qualquer — ele faz várias operações delicadas:
- Encolhe o container APFS do macOS. O macOS fica com espaço suficiente para updates (38 GB reservados).
- Cria três partições:
- APFS stub (2.5 GB): um container macOS mínimo que contém o
m1n1stage 1. É a partir daqui que o Linux arranca — o boot picker do macOS carrega esta partição. - EFI System Partition (500 MB): contém o
m1n1stage 2, U-Boot, e GRUB. - Root Linux (restante): sistema de ficheiros ext4 com o Fedora Asahi Remix.
- APFS stub (2.5 GB): um container macOS mínimo que contém o
Pós-instalação
# Updates
sudo dnf upgrade
# Kernel Asahi
# linux-asahi é o estável (recomendado)
# linux-asahi-edge é o mais recente (pode ter bugs)
sudo dnf install linux-asahi
# Firmware (se precisares de reconstruir)
# Corre o instalador novamente desde macOS Recovery e escolhe
# "Rebuild vendor firmware package"
Notas pessoais sobre o Fedora
Uso o Fedora Asahi há mais de um ano. O KDE Plasma vem com um tema escuro Asahi que fica muito bem no ecrã do MacBook. A gestão de energia é boa — o suspend/resume funciona, a bateria dura bem. O suporte para altifalantes com DSP é impressionante para um projeto de engenharia reversa.
A única coisa que me faz falta é o Touch ID. Não funciona em nenhuma distribuição, e provavelmente nunca vai funcionar — o SEP trata disso e a Apple não abre.
Método B: Debian (Bananas Team)
O Debian não tem suporte oficial para Apple Silicon. Mas a Bananas Team (sim, esse é o nome) mantém tudo o que é preciso: kernel, drivers, bootloader configurado.
Não esperes o mesmo polimento do Fedora. O Debian é mais "faça você mesmo". Se gostas de APT e do ecossistema Debian, vale a pena.
Instalação
curl https://bananas.debian.net/install | sh
O processo é parecido com o Fedora Asahi:
- Corre o comando no Terminal do macOS
- Aloca espaço para o Linux
- Escolhe o ambiente: GNOME, KDE, ou console-only
- O instalador configurou os repositórios Bananas e instala tudo
Diferenças para o Fedora Asahi
Vantagens:
- APT. Se és dos Debian de longa data, estás em casa.
- Repositórios Debian com milhares de pacotes adicionais face ao Fedora.
- Mais leve em recursos base.
Desvantagens (são significativas):
- Kernel
linux-asahiNÃO está no Debian oficial. Vem do Bananas Archive, um repositório externo. Se o Bananas Archive cai, ficas sem updates de kernel. - Drivers Mesa Asahi também não estão no Debian oficial. Precisas de backports ou do repositório Bananas.
- Gaming stack (muvm/FEX/Steam) não está portada para Debian. Queres jogar no teu MacBook com Linux? Usa Fedora ou Arch.
- X11 não é suportado. Wayland apenas. No Fedora também, mas no Debian podes ter mais dificuldades com apps que ainda dependem de X11.
- Comunidade mais pequena. Quando tens problemas, há menos gente a quem perguntar.
Pós-instalação
sudo apt update && sudo apt upgrade
# Verificar que os repositórios Bananas estão ativos
sudo apt-cache policy linux-asahi
# Kernel mais recente
sudo apt install linux-asahi
Para quem é o Debian
Sinceramente? Para quem já usa Debian como daily driver noutro hardware e quer consistência entre máquinas. Para um utilizador novo que quer experimentar Asahi, o Fedora é uma escolha muito melhor.
Método C: Arch Linux ARM (asahi-alarm)
O Arch Linux ARM tem uma variante específica para Asahi, chamada asahi-alarm. O que a distingue? Rolling release, kernel bleeding-edge, e suporte para Steam gaming.
Instalação
curl https://asahi-alarm.org/installer-bootstrap.sh | sh
Opções de instalação
O instalador oferece três opções:
- Pré-construído com KDE Plasma — o mais completo
- Pré-construído com GNOME — alternativa
- Minimal — só terminal, para instalares manualmente o que quiseres
Instalação manual a partir do minimal
# Depois de bootar no Arch minimal (password: root/root)
# Configurar rede WiFi
nmcli device wifi connect <SSID> password <password>
# Instalar desktop e ferramentas Asahi
sudo pacman -Sy asahi-desktop-meta
# Criar utilizador normal
useradd -m -G wheel,audio,video,storage <username>
passwd <username>
Steam Gaming
sudo pacman -Sy steam
O Steam corre através de muvm (micro VM) + FEX (emulador x86-64 para ARM). Isto permite correr jogos x86 nativos no ARM. O desempenho varia — jogos mais leves correm muito bem, AAA pesados podem ter quebras.
Diferenças para as outras opções
Vantagens:
- Rolling release — tens sempre o kernel mais recente. Se sai um patch para o driver WiFi, está no teu sistema no dia seguinte.
- AUR — o Arch User Repository tem de tudo. Precisas de uma ferramenta obscura? Está no AUR.
- Steam gaming — melhor suporte que o Fedora (que também funciona), e o Debian nem tem.
- Pacman — rápido, simples, sem dependências complexas.
Desvantagens:
- Mais DIY. O Arch não te segura na mão. Se quebras, és tu que arranjas.
- Menos suporte da comunidade Asahi. A maioria dos utilizadores está no Fedora.
- Rolling release ocasionalmente parte coisas. Sabes como é.
- Documentação mais dispersa. O wiki do Arch ARM é menos completo que o Fedora Asahi docs.
Para quem é o Arch
Para quem já usa Arch. Ou para quem quer jogar no MacBook com Linux. Ou para quem gosta de ter o kernel mais recente e não se importa de sujar as mãos.
Arquitetura de Boot (explicação técnica)
Este é o ponto que mais confunde as pessoas. Como é que o Linux arranca num MacBook Apple Silicon? Não é EFI normal. A sequência completa é:
Cold Boot
→ iBoot2 (ROM, bootrom insegurável)
→ iBoot (SSV — Signed System Volume, verificado por hardware)
→ 1TR (One True Recovery)
→ SEP verifica boot policy (qual disco pode bootar)
→ m1n1 stage 1 (app fuOS dentro do ambiente macOS)
→ m1n1 stage 2 (carregado da ESP)
→ U-Boot (fornece UEFI Runtime Services)
→ GRUB (lê a config, apresenta menu)
→ Linux kernel (vmlinuz-*)
O boot picker em Apple Silicon não é EFI nem BIOS. É uma app macOS chamada fuOS que corre no ambiente de recovery. Quando premites o botão de power ao ligar, entras no modo "pick a boot volume" — o firmware apresenta uma lista de containers APFS que têm permissão para bootar.
O SEP (Secure Enclave Processor) gere as boot policies. O macOS assina cada kernel e cada actualização de firmware. O Linux não está assinado. Então como é que funciona? A instalação cria um container APFS "stub" com uma boot policy permissiva — security_mode = permissive — que permite correr código não assinado pela Apple.
O m1n1 é o segredo do Asahi. Tem dois estágios:
- Stage 1: é uma app macOS que corre como fuOS (Fully Untrusted OS). A Apple permite que qualquer aplicação macOS corra como fuOS no ecossistema Apple Silicon — é uma porta aberta propositada. O stage 1 é basicamente um "loader" que salta para o stage 2.
- Stage 2: está na ESP, corre após o stage 1 o ter carregado. Faz a configuração de hardware básica (interrupt controller, timers, MMU) e carrega o U-Boot.
U-Boot é um firmware UEFI genérico para ARM. Fornece UEFI Runtime Services. É a camada de abstração que permite ao GRUB e ao Linux funcionar sem saberem que estão num MacBook.
O resultado final? O Linux pensa que está a correr num computador ARM UEFI normal. E de certa forma, está.
Dual-boot no dia-a-dia
Como escolher o OS ao boot
- Liga o MacBook com o botão de power premido (cerca de 3 segundos).
- O ecrã mostra os discos disponíveis:
Macintosh HDe o nome que deste ao Asahi. - Clica no que queres. Ou usa as setas e Enter com o teclado.
Pro tip: se o menu de boot não aparece, desliga completamente (não é sleep) e tenta outra vez. Às vezes o firmware está inconsistente.
Como definir o OS padrão
- Do macOS: System Settings → General → Startup Disk. Seleciona o volume que queres como default.
- Do Linux: usa
asahi-bless:# Definir Linux como boot default sudo asahi-bless --next # Definir macOS como boot default sudo asahi-bless --set-default --volume Macintosh\ HD
Partilha de ficheiros entre macOS e Linux
O Linux consegue ler a partição APFS do macOS:
# Instalar ferramentas APFS (já vem instalado no Fedora Asahi)
sudo dnf install linux-asahi-tools
# ou no Arch
sudo pacman -S linux-asahi-tools
# Montar a partição macOS
lsblk # identificar a partição macOS, geralmente /dev/nvme0n1p2
sudo mount -t apfs /dev/nvme0n1p2 /mnt/macos
Assim podes aceder aos teus ficheiros do macOS dentro do Linux. Escrita também funciona, mas tem cuidado — escrever no volume do macOS pode causar problemas com o journal APFS.
Sincronização Bluetooth
O Bluetooth pairing não é partilhado entre macOS e Linux. Cada OS tem os seus próprios pares. Mas há uma ferramenta que te pode ajudar:
# Partilhar pares Bluetooth do macOS para o Linux
# Corre no Linux
sudo asahi-btsync
Isto lê o ficheiro de configuração Bluetooth do macOS e importa os pares para o Linux. Poupa trabalho se tens muitos dispositivos emparelhados no macOS.
Suporte de Hardware (Junho 2026)
| Funcionalidade | M1 / M2 | M3 |
|---|---|---|
| GPU (OpenGL 4.6, Vulkan 1.4) | ✅ Conformante, Mesa upstream | ❌ Software rendering |
| WiFi (Broadcom) | ✅ (kernel 6.1+) | ✅ (WIP) |
| Bluetooth | ✅ (kernel 6.2+) | ❌ |
| Display 120 Hz ProMotion | ✅ | ❌ |
| Altifalantes com DSP | ✅ | ❌ |
| Microfones | ✅ (maioria dos modelos) | ❌ |
| Webcam (FaceTime HD) | ✅ | ❌ |
| Touch Bar (13" M1/M2 Pro) | ✅ | N/A |
| Touch ID | ❌ | ❌ |
| Thunderbolt / USB4 | ⚠️ WIP (funcionalidade básica) | ❌ |
| HDMI | ✅ (Mini, Studio, Pro) | ❌ |
| Suspend / Resume | ✅ | ❌ |
| Drm/kms (display) | ✅ | ⚠️ WIP |
| Video Encode / Decode | ⚠️ Decoder em progresso | ❌ |
| Steam Gaming (muvm + FEX) | ✅ | ❌ |
| Carga por USB-C | ✅ | ✅ |
O M3 está a chegar, devagar. O maior desafio é a GPU — a Apple mudou a arquitetura gráfica no M3 e foi preciso começar quase do zero. O driver display já está a funcionar, GPU conformante deve chegar até final de 2026 ou início de 2027.
Troubleshooting
O boot picker não mostra o Asahi
Problema mais comum.
Causa 1 — macOS 27 Golden Gate beta: A Apple partiu o boot picker na versão beta do macOS 27. As policy checks foram alteradas e o container APFS stub não aparece como opção de boot. A solução temporária é usar macOS 26 ou inferior como volume de boot default. Podes ter macOS 27 instalado, mas o volume ativo de boot (o default) tem de ser macOS 26.
# A partir do macOS Recovery, selecionar volume macOS 26 como boot default
# Ou, se só tens macOS 27:
# - Usar um disco externo com macOS 26 para bootar
# - Ou instalar macOS 26 numa partição secundária
Causa 2 — o firmware "esqueceu-se": Forçar a reconstrução do m1n1:
# 1. Boot para macOS Recovery (Cmd+R ao ligar ou pelo menu de boot)
# 2. Abrir Terminal
# 3. Re-correr o instalador
curl -L https://alx.sh | sh
# 4. Selecionar "Reinstall Asahi Linux" ou "Rebuild vendor firmware"
Causa 3 — double-tap trick: Parece estranho, mas resulta muitas vezes. Em vez de premir e segurar o botão de power, dá dois toques rápidos e depois segura à terceira vez. Isto força o boot picker a re-validar os discos disponíveis.
Quero remover o Asahi e voltar só a macOS
O processo é manual mas simples:
# 1. Boot para macOS Recovery (Cmd+R ou power button → Options)
# 2. Abrir Terminal
# 3. Ver a estrutura de discos
diskutil list
# 4. Identificar as partições do Asahi (disk0s3, disk0s4, disk0s7 no exemplo)
# 5. Remover as partições
diskutil apfs deleteContainer disk0s3 # APFS stub
diskutil eraseVolume free free disk0s4 # ESP (EFI)
diskutil eraseVolume free free disk0s7 # Root Linux
# 6. Expandir macOS para ocupar o espaço livre
diskutil apfs resizeContainer disk0s2 0 # 0 = usar todo o espaço
O diskutil list mostra o esquema de partições. O APFS stub aparece como container APFS (disk0s3 normalmente), a ESP como Microsoft Reserved (ou EFI, disk0s4), e o root Linux como Linux filesystem (disk0s7).
Importante: escreve os números de disco antes de apagar. Apagar o disco errado = perder o macOS.
O sistema não boota
Apple Silicon não é brickable. Ao contrário de PCs x86 onde podes corromper o UEFI, o MacBook Apple Silicon tem o boot em ROM — não és tu nem o Linux que o alteram.
Causa — kernel panic no boot:
- Boot para macOS Recovery
- Re-corre o instalador Asahi e seleciona "Reinstall bootloader"
- Se o problema persistir, pode ser o kernel. Tenta com o kernel estável (
linux-asahi) em vez do edge.
Causa — stuck em boot loop: Usa o double-tap trick: dois toques rápidos + segurar no botão power. Isto força o firmware a revalidar e pode quebrar o loop.
Causa — nada acontece (ecrã preto):
- Verifica se o MacBook não está simplesmente sem bateria
- Tenta um DFU restore: precisas de outro Mac com Apple Configurator 2, ou Linux com
idevicerestore
Performance da bateria
É normal a bateria durar menos no Linux que no macOS. O macOS tem uma gestão energética altamente otimizada para o hardware Apple. O Linux está a melhorar, mas ainda não está ao mesmo nível.
Dicas para melhorar:
# Instalar ferramentas de gestão de energia
sudo dnf install powertop tlp
# Ver consumo
sudo powertop
WiFi não funciona
Verifica a versão do kernel:
uname -r
# Precisas de kernel 6.1+ para WiFi M1
# Kernel 6.2+ para Bluetooth
Se tens kernel recente e ainda não funciona, pode ser firmware:
# Reconstruir firmware Apple (necessário macOS)
# Boot para macOS Recovery
curl -L https://alx.sh | sh
# Opção: "Rebuild vendor firmware package"
Conclusão
O Asahi Linux está num estado impressionante. Não é perfeito — Touch ID nunca vai funcionar, Thunderbolt está WIP, a bateria dura menos que no macOS — mas para uso diário, em M1 e M2, é perfeitamente viável.
O ecossistema está a crescer. O Fedora Asahi Remix é a distribuição oficial e recomendada. O Debian Bananas Team dá aos fãs de APT uma opção viável (com limitações). O Arch Linux ARM oferece rolling release e Steam gaming para quem gosta de risco.
A minha recomendação pessoal: começa pelo Fedora Asahi Remix. É o mais testado, o mais suportado, e onde encontras mais ajuda se algo correr mal. Depois de estares confortável, explora Debian ou Arch se houver uma razão específica.
O futuro é promissor. M3 está a caminho, os drivers Mesa estão a ser upstreamed, a equipa está a trabalhar na aceleração de vídeo e Thunderbolt. Daqui a um ano, o Asahi vai estar ainda melhor.
E tu? Já instalaste Asahi Linux? Qual distribuição escolheste? Deixa comentário abaixo.
Comentários (0)
Nenhum comentário ainda. Seja o primeiro!
Deixar comentário