Pular para o conteúdo principal

Início Rápido

Coloque o PatchOne em funcionamento em menos de 5 minutos usando o modo on-premises (SQLite, único Windows Server).

Pré-requisitos​

  • Windows Server 2019+ (ou Windows 10/11 para desenvolvimento/teste)
  • Python 3.11+ instalado
  • Pelo menos uma máquina Windows para o agente

1. Clonar e configurar​

Clone o repositório
git clone <repo> patchone
cd patchone
copy server\.env.example server\.env

Abra server\.env e defina no mínimo:

server/.env
SECRET_KEY=change-this-to-a-random-string-at-least-32-chars
ADMIN_PASSWORD=your-admin-password
SERVER_MODE=onprem
SECRET_KEY

Gere uma chave forte com python -c "import secrets; print(secrets.token_hex(32))". Nunca reutilize ou comite este valor.

2. Executar o instalador​

Execute como Administrador
deploy\install_server.bat

Este único script:

  1. Cria um ambiente virtual Python
  2. Instala todas as dependências do servidor
  3. Inicializa o banco de dados e popula o catálogo de 50 títulos de software
  4. Cria a conta de administrador inicial
  5. Registra o PatchOne como um Windows Service
  6. Configura o firewall

3. Abrir o dashboard​

Acesse http://<server-ip> e faça login com suas credenciais de administrador.

4. Implantar o primeiro agente​

Em um PowerShell como Administrador na máquina de teste, execute:

Execute como Administrador
& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/patchone-org/app/main/deploy/windows/install.ps1'))) -ServerUrl http://<server-ip>:8000

Substitua <server-ip> pelo endereço IP ou hostname do servidor PatchOne.

Verifique se o agente foi instalado:

Get-Service PatchOneAgent

A máquina aparece na página Máquinas após o próximo check-in.

Outros métodos de instalação

Para instalar em múltiplas máquinas via GPO, WinRM, winget ou PsExec, consulte Deploy do Agente em Escala.

5. Enviar a primeira atualização​

  1. Vá para Implantar no dashboard
  2. Selecione a máquina de teste
  3. Escolha um título de software do catálogo (ex.: Google Chrome)
  4. Clique em Implantar

O job é executado silenciosamente no agente. Verifique Jobs para ver o resultado.

Lista de verificação​

  • O dashboard carrega e o login funciona
  • A máquina de teste aparece na visualização Frota
  • Inventário de software visível na página de detalhes da máquina
  • Job de implantação concluído com sucesso

Próximos passos​