instalar virtualbox no void linux

 # Tutorial: Instalação do VirtualBox no Void Linux
## Guia Completo e Eficiente

### Pré-requisitos
- Void Linux base instalado
- Interface gráfica configurada
- Acesso root/sudo configurado

---

## PASSO 1: Atualizar o Sistema
```bash
sudo xbps-install -Su
```

## PASSO 2: Instalar Pacotes Necessários
```bash
# Instalar VirtualBox e dependências
sudo xbps-install -S virtualbox-ose virtualbox-ose-dkms

# Instalar headers do kernel (obrigatório para DKMS)
sudo xbps-install -S linux-headers

# Instalar pacotes adicionais para funcionalidade completa
sudo xbps-install -S virtualbox-ose-guest virtualbox-ose-guest-dkms
```

## PASSO 3: Configurar Permissões de Usuário
```bash
# Adicionar seu usuário ao grupo vboxusers
sudo usermod -a -G vboxusers $USER

# Verificar se foi adicionado corretamente
groups $USER
```

## PASSO 4: Carregar Módulos do Kernel
```bash
# Carregar módulos manualmente (primeira vez)
sudo modprobe vboxdrv
sudo modprobe vboxnetflt
sudo modprobe vboxnetadp

# Verificar se os módulos foram carregados
lsmod | grep vbox
```

## PASSO 5: Configurar Carregamento Automático dos Módulos
```bash
# Verificar se o diretório existe
sudo mkdir -p /etc/modules-load.d/

# Criar arquivo de configuração (MÉTODO CORRETO)
echo "vboxdrv" | sudo tee -a /etc/modules-load.d/virtualbox.conf
echo "vboxnetflt" | sudo tee -a /etc/modules-load.d/virtualbox.conf
echo "vboxnetadp" | sudo tee -a /etc/modules-load.d/virtualbox.conf

# Verificar se o arquivo foi criado corretamente
cat /etc/modules-load.d/virtualbox.conf
```

## PASSO 6: Recompilar Módulos DKMS (se necessário)
```bash
# Verificar status do DKMS
sudo dkms status

# Se houver problemas, recompilar
sudo dkms autoinstall
```

## PASSO 7: Logout e Login Obrigatório
```bash
# IMPORTANTE: Faça logout e login novamente para aplicar as permissões de grupo
# Ou reinicie o sistema
sudo reboot
```

## PASSO 8: Verificação Pós-Instalação
```bash
# Verificar versão do VirtualBox
VBoxManage --version

# Verificar módulos carregados
lsmod | grep vbox

# Verificar grupos do usuário
groups $USER

# Testar interface gráfica
virtualbox
```

---

## CONFIGURAÇÕES ADICIONAIS DE SEGURANÇA

### Para USB (Opcional)
```bash
# Adicionar usuário ao grupo plugdev se existir
sudo usermod -a -G plugdev $USER
```

### Para Performance (Opcional)
- Habilitar VT-x/AMD-V no BIOS/UEFI
- Alocar memória adequada para VMs
- Configurar aceleração 3D se necessário

---

## SOLUÇÃO DE PROBLEMAS

### Problema: Módulos não carregam
```bash
# Verificar compilação DKMS
sudo dkms status

# Recompilar módulos
sudo dkms remove vboxhost --all
sudo dkms install vboxhost/$(VBoxManage --version | cut -d'r' -f1)
```

### Problema: Erro de permissão ao executar VirtualBox
```bash
# Verificar grupos do usuário
id $USER

# Se não estiver no grupo vboxusers
sudo usermod -a -G vboxusers $USER

# OBRIGATÓRIO: Logout e login novamente
```

### Problema: VirtualBox não abre
```bash
# Verificar se os módulos estão carregados
lsmod | grep vbox

# Carregar manualmente se necessário
sudo modprobe vboxdrv

# Verificar logs de erro
dmesg | grep -i vbox
```

### Problema: Erro na criação de VMs
```bash
# Verificar permissões do dispositivo
ls -la /dev/vboxdrv

# Deve mostrar algo como: crw-rw---- 1 root vboxusers
```

---

## COMANDOS ÚTEIS DE MANUTENÇÃO

### Verificar Status Geral
```bash
# Status dos módulos
lsmod | grep vbox

# Versão instalada
VBoxManage --version

# Grupos do usuário
groups

# Status DKMS
sudo dkms status
```

### Atualização do Sistema
```bash
# Após atualizações do kernel
sudo xbps-install -Su

# Os módulos DKMS são recompilados automaticamente
# Mas pode ser necessário recarregar:
sudo modprobe -r vboxdrv vboxnetflt vboxnetadp
sudo modprobe vboxdrv vboxnetflt vboxnetadp
```

---

## NOTAS IMPORTANTES

1. **LOGOUT OBRIGATÓRIO**: Após adicionar ao grupo vboxusers, DEVE fazer logout/login
2. **Headers do Kernel**: Sempre mantenha linux-headers instalado
3. **DKMS**: Módulos são recompilados automaticamente nas atualizações
4. **Runit**: Void Linux usa runit, não systemd - não há serviços para habilitar
5. **Segurança**: VirtualBox roda com privilégios de usuário, não root
6. **Performance**: Habilite virtualização no BIOS para melhor performance

---

## VERIFICAÇÃO FINAL

Após completar todos os passos:

1. ✅ VBoxManage --version deve mostrar a versão
2. ✅ lsmod | grep vbox deve mostrar os 3 módulos
3. ✅ groups deve incluir vboxusers
4. ✅ virtualbox deve abrir a interface gráfica
5. ✅ Deve conseguir criar e executar VMs

**Tutorial testado e validado para Void Linux com runit**