Assista o vídeo tutorial:

Neste guia prático e interativo, você vai configurar um ambiente Protheus 12.1.2510 completo utilizando PostgreSQL em Docker. Ideal para quem quer estudar, testar customizações ou aprender o sistema sem impactar ambientes produtivos.

📩 Baixe aqui o instalador Protheus e Docker-compose

📋 O que você vai precisar

Antes de começar, vamos entender o que será instalado e por quê:

Arquitetura do Ambiente

┌─────────────┐      ┌──────────────┐      ┌─────────────┐      ┌──────────────┐
│  WebAgent   │ ───> │  AppServer   │ ───> │  DBAccess   │ ───> │  PostgreSQL  │
│  (Cliente)  │      │  (Protheus)  │      │ (TopConnect)│      │   (Docker)   │
└─────────────┘      └──────────────┘      └─────────────┘      └──────────────┘
                            ↓
                     ┌──────────────┐
                     │License Server│
                     └──────────────┘

Componente	Função	Papel no Protheus
WebAgent (Cliente)	Interface web acessada pelo usuário	Envia requisições ao AppServer
AppServer (Protheus)	Processa rotinas, regras de negócio e programas AdvPL	Cérebro do sistema; conecta WebAgent, DBAccess e License
License Server	Gerencia licenças e sessões	Autoriza acessos ao AppServer
DBAccess (TopConnect)	Conector entre AppServer e banco	Traduz e executa consultas SQL
PostgreSQL (Docker)	Banco de dados do Protheus, rodando em container	Armazena tabelas, cadastros e dados

✅ Checklist Geral de Instalação

Acompanhe seu progresso marcando cada etapa concluída:
[ ] Etapa 1: Instalar e configurar o Docker Desktop
[ ] Etapa 2: Criar o banco PostgreSQL no Docker
[ ] Etapa 3: Instalar driver ODBC PostgreSQL
[ ] Etapa 4: Instalar Java Runtime Environment (JRE)
[ ] Etapa 5: Instalar TOTVS License Server
[ ] Etapa 6: Instalar Protheus (AppServer + DBAccess)
[ ] Etapa 7: Inicializar e validar o ambiente

🐳 Etapa 1: Instalar o Docker Desktop

1.1 Instalação do WSL

Para instalação do Linux no Windows, execute no PowerShell:

wsl --install

Verifique se instalou corretamente:

wsl --version

1.2 Instalação do Docker

Baixe o Docker Desktop: https://www.docker.com/products/docker-desktop/
Execute o instalador e marque "Use WSL 2 instead of Hyper-V"
Reinicie o computador
Também é possível a instalação do Docker via Microsoft Store.

Abra o Docker Desktop e efetue o Login, é possível com conta Google
Certifique-se de que o Docker estará rodando
✅ Checklist: WSL Instalado | Docker instalado | Login Efetuado

🗄️ Etapa 2: Criar o PostgreSQL no Docker

2.1 Criar o container Docker

Abra um bloco de notas
Cole o conteudo abaixo:

version: '3.8'

services:
  protheus:
    image: postgres:16
    container_name: protheus
    environment:
      POSTGRES_USER: protheus
      POSTGRES_PASSWORD: protheus
      POSTGRES_DB: protheus
    ports:
      - "5432:5432"    
    volumes:
      - protheus:/var/lib/postgresql/data
    restart: always

volumes:
  protheus:

Salve o arquivo como docker-compose.yml
Para criar o container, abra o cmd na pasta do arquivo e execute:

docker compose up -d

2.2 Validar

docker exec -it protheus psql -U protheus -d protheus -c "SELECT version();"

Também é possível se conectar no banco de dados via IDE, como o DBeaver.

✅ Checklist: Container criado | PostgreSQL respondendo

🔌 Etapa 3: Instalar o Driver ODBC PostgreSQL

3.1 Baixar e Instalar

Baixe o driver ODBC x64 ANSI: https://www.postgresql.org/ftp/odbc/releases/REL-16_00_0007/
Execute o instalador e certifique-se de marcar "PostgreSQL ANSI ODBC Driver"

3.2 Configurar DSN

Execute `C:\Windows\System32\odbcad32.exe` (ODBC 64 bits)
Aba "DSN de Sistema" → "Adicionar"
Selecione "PostgreSQL Unicode(x64)"
Preencha:
Data Source: `protheus`
Database: `protheus`
Server: `localhost`
Port: `5432`
User Name: `protheus`
Password: `protheus`
Clique em "Test" → deve aparecer "Connection successful"
Salve
✅ Checklist: Driver ODBC instalado | DSN `protheus` criado | Teste de conexão OK

☕ Etapa 4: Instalar o Java (JRE)

4.1 Instalar

Baixe o JRE: https://www.java.com/pt-BR/download/
Execute o instalador (Java 8 ou 11 recomendado)

4.2 Validar

java -version

✅ Checklist: JRE instalado | Comando java -version funcionando

🔑 Etapa 5: Instalar o License Server

5.1 Baixar e Instalar

Acesse o Portal TOTVS: https://suporte.totvs.com/download
Navegue: Linha Protheus → TOTVSTEC-FRAMEWORK → INSTALADORES
Baixe o License Server e o arquivo `.lic`
Execute o instalador e instale em: `C:\TOTVS\Protheus1225\LicenseServer`
Marque "Iniciar o serviço automaticamente"

5.2 Verificar Serviço

Execute `services.msc` e verifique se "TOTVS License Server" está em execução.
✅ Checklist: License Server instalado | Serviço em execução

🚀 Etapa 6: Instalar o Protheus

6.1 Baixar e Instalar

Acesse: https://suporte.totvs.com/download
Navegue: Linha Protheus → TOTVSTEC-FRAMEWORK → INSTALADORES
Baixe o Protheus 12.1.2510 - Instalador Completo
Execute como Administrador e instale em: C:\TOTVS\Protheus1225\AppServer
Marque todos os componentes: AppServer, DBAccess, SmartClient, Dicionário, RPO
DNS License Server e Porta, coloque os mesmos dados da instalação do License Server
No arquivo appserver.ini, insira o parâmetro abaixo:

[General]
app_environment=environment

6.2 Configurar do DBAccess

Neste momento é realizada a conexão com o banco de dados Postgres criado no Docker.
Ao abrir a tela do DBMonitor, no momento da instalação, clique em "Configurações"
Clique em Postgres
Em "Ambiente", clique em "Novo", escreva "protheus" e salve
Usuário e senha: "protheus", conforme criado no Postgres, e salve
Clique na guia "Assistentes" >> "Validar Conexão"
Selecione Postgres, avançe e no ambiente coloque "protheus"
✅ Checklist: Protheus instalado

⚡ Etapa 7: Inicializar e Validar

7.1 Iniciar Serviços ou Reiniciar caso já esteja rodando

Execute `services.msc` e inicie na ordem:
TOTVS DBAccess → Iniciar
TOTVS Protheus AppServer → Iniciar (aguarde 30-60s)

7.2 Instalar WebAgent

Acesse no navegador http://localhost:4321/
Confirme a instalação do WebAgent

7.3 Validar Instalação

Testar módulos:
Acesse SIGACFG
Crie uma empresa de teste (código `99`)

⚠️ Problemas Comuns

Problema Solução
"Não foi possível conectar" Verifique se AppServer está rodando
"License Server not found" Verifique serviço License Server
"Database connection error" Verifique DSN ODBC e container PostgreSQL
✅ Checklist: Serviços iniciados | Logs OK | SmartClient conectado | Configurador executado | Tabelas SX criadas

Problema	Solução
"Não foi possível conectar"	Verifique se AppServer está rodando
"License Server not found"	Verifique serviço License Server
"Database connection error"	Verifique DSN ODBC e container PostgreSQL

🎯 Próximos Passos

Parabéns! Seu ambiente Protheus está pronto para estudos!

Sugestões de Uso

Iniciantes: Explore SIGACFG, SIGAADV e crie cadastros de teste
Desenvolvedores: Instale o TDS e comece a programar em AdvPL
Administradores: Configure backups automáticos e monitore logs

📚 Referências

Documentação Oficial

TDN - Instalador Protheus 12: https://tdn.totvs.com/display/PROT/Instalador+Protheus+Windows+12.1.27
TDN - Protheus com PostgreSQL: https://tdn.totvs.com/display/PROT/Protheus+com+PostgreSQL
Portal do Cliente TOTVS: https://suporte.totvs.com

Downloads

Software Link
Docker Desktop https://www.docker.com/products/docker-desktop/
PostgreSQL ODBC x64 ANSI https://www.postgresql.org/ftp/odbc/versions/msi/
Java JRE https://www.java.com/pt-BR/download/
Visual C++ Redistributables https://learn.microsoft.com/pt-br/cpp/windows/latest-supported-vc-redist
📩 Baixe aqui o instalador Protheus e Docker-compose
Guia baseado na documentação oficial TOTVS - Novembro 2024

Software	Link
Docker Desktop	https://www.docker.com/products/docker-desktop/
PostgreSQL ODBC x64 ANSI	https://www.postgresql.org/ftp/odbc/versions/msi/
Java JRE	https://www.java.com/pt-BR/download/
Visual C++ Redistributables	https://learn.microsoft.com/pt-br/cpp/windows/latest-supported-vc-redist

Assista o vídeo tutorial:Neste guia prático e interativo, você vai configurar um ambiente Protheus 12.1.2510 completo utilizando PostgreSQL em Docker. Ideal para quem quer estudar, testar customizações ou aprender o sistema sem impactar ambientes produtivos.