# Manual de Instalacao - MailMigrate

## Requisitos do Servidor

### Obrigatorios
- PHP >= 8.3
- Extensao PDO
- Extensao PDO_MySQL
- Extensao IMAP
- Extensao OpenSSL
- Extensao cURL
- Extensao MBString
- Extensao JSON
- Extensao ZIP
- MySQL >= 8.0

### Recomendados
- Memoria: 256MB+
- max_execution_time: 300+
- upload_max_filesize: 10MB+

## Instalacao

### Metodo 1: Instalador Web (Recomendado)

1. Faca upload do arquivo ZIP para o servidor
2. Extraia os arquivos para o diretorio desejado
3. Acesse `http://seudominio.com/install` pelo navegador
4. Siga o assistente de instalacao:
   - Verificacao de requisitos
   - Configuracao do banco de dados
   - Criacao do administrador
   - Finalizacao

### Metodo 2: Instalacao Manual

1. Extraia os arquivos
2. Crie o banco de dados MySQL
3. Importe o schema: `mysql -u usuario -p banco < database/schema.sql`
4. Copie `config/.env.example` para `config/.env`
5. Edite `config/.env` com suas configuracoes
6. Crie o arquivo `config/.installed`
7. Execute `composer install --no-dev`
8. Crie o usuario administrador diretamente no banco

### Apos Instalacao

- Remova o diretorio `/install` (opcional)
- Configure as permissoes do diretorio `storage/` para 755
- Configure o cron job para processamento em background:
```
*/5 * * * * php /caminho/public/index.php /api/v1/cron/process >> /dev/null 2>&1
```

## Compatibilidade

- cPanel / WHM
- VPS Linux (Ubuntu, CentOS, Debian)
- Plesk
- DirectAdmin
- Hospedagem compartilhada com suporte a PHP 8.3+

## Solucao de Problemas

### Erro 500
- Verifique permissoes dos diretorios (755) e arquivos (644)
- Verifique se o .htaccess esta configurado
- Verifique logs em `storage/logs/`

### Erro de Conexao com Banco
- Verifique host, porta, usuario e senha no .env
- Verifique se o usuario tem privilegios no banco
- Teste a conexao manualmente

### Erro IMAP
- Verifique se a extensao IMAP esta habilitada
- Verifique se as portas 993/143 estao liberadas no firewall