commit f92684aebf441e8f94b06611a1d073a267c7cc53
Author: HalbeBruno <bruno@ipv0.com.br>
Date:   Fri Dec 5 13:38:08 2025 -0300

    README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..191731b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,95 @@
+# DNSBlock
+
+Agente do DNSBlock para Linux.
+
+## Instalação e Configuração
+
+```bash
+ curl -sS https://install.dnsblock.app | bash
+```
+
+## Instalação Manual
+
+O agente deve ser instalado como um serviço do sistema (Systemd) para garantir execução contínua e reinício automático.
+
+### 1. Instalação dos Arquivos
+
+Você pode clonar o repositório oficial diretamente no diretório de destino:
+
+```bash
+# Acessar diretório de programas opcionais
+cd /opt
+
+# Clonar o repositório (criará a pasta /opt/dnsblock)
+sudo git clone https://git.ipv0.com.br/0/dnsblock.git
+
+# Entrar no diretório
+cd dnsblock
+
+# Configurar permissão de execução
+sudo chmod +x dnsblock-agent
+```
+
+### 2. Configuração
+
+Renomeie o arquivo de exemplo e edite com seus dados:
+
+```bash
+# Criar arquivo de configuração a partir do exemplo
+sudo cp config.json.example config.json
+
+# Editar
+sudo nano config.json
+```
+
+Insira sua **Serial Key** fornecida no painel de administração.
+
+### 3. Criar Serviço Systemd
+
+Crie o arquivo de serviço para o gerenciador do sistema:
+
+```bash
+sudo nano /etc/systemd/system/dnsblock-agent.service
+```
+
+Cole o seguinte conteúdo:
+
+```ini
+[Unit]
+Description=DNSBlock Agent Service
+After=network.target
+
+[Service]
+Type=simple
+User=root
+WorkingDirectory=/opt/dnsblock
+ExecStart=/opt/dnsblock/dnsblock-agent
+Restart=always
+RestartSec=10
+
+[Install]
+WantedBy=multi-user.target
+```
+
+### 4. Ativar e Iniciar
+
+Habilite o serviço para iniciar com o sistema e rode-o agora:
+
+```bash
+# Recarregar daemon do systemd
+sudo systemctl daemon-reload
+
+# Habilitar inicialização automática
+sudo systemctl enable dnsblock-agent
+
+# Iniciar o serviço
+sudo systemctl start dnsblock-agent
+```
+
+### 5. Verificar Status
+
+Para confirmar se o agente está rodando corretamente:
+
+```bash
+sudo systemctl status dnsblock-agent
+```