---
title: "Atualização do Signer em Windows Server"
description: "Atualização do Signer em Windows Server com IIS: verifique a versão instalada, faça backup, troque os binários do site, confira a nova versão e saiba como voltar atrás."
canonical: "https://docs.lacunasoftware.com/articles/signer/on-premises/windows/update"
locale: "pt-BR"
product: "Signer"
last_updated: "2026-10-22"
---

# Atualização do Signer em Windows Server

Esta página mostra como atualizar uma instância on-premises do Signer instalada no IIS conforme o
[setup em Windows Server](https://docs.lacunasoftware.com/articles/signer/on-premises/windows).

## Antes de atualizar

1. Verifique a versão instalada. Abra `https://<seu-dominio>/api/system/info` no navegador. O campo `productVersion`
   mostra a versão.
1. Leia o [changelog](https://docs.lacunasoftware.com/articles/signer/changelog) de todas as versões entre a sua e a nova. Procure as versões marcadas
   com alteração no modelo do banco de dados.
1. Se você vai sair da versão 2.x para a 3.x, siga também [Atualizando para 3.x](https://docs.lacunasoftware.com/articles/signer/on-premises/update-30). A versão
   3.0.0 exige o *Hosting Bundle* do .NET 10.0. Instale-o antes de trocar os binários.
1. Atualize primeiro o ambiente de homologação. Teste o envio e a assinatura de documentos antes de atualizar a produção.
1. Escolha um horário de pouco uso. Na primeira inicialização, a aplicação atualiza o banco de dados quando a versão
   nova tem alterações no modelo.

> **Aviso**
>
> Se você tem mais de um servidor, só um deles deve atualizar o banco de dados. Pare os outros servidores, atualize um
> servidor e espere ele iniciar. Depois, atualize os outros. Outra opção: em todos os servidores menos um, defina
> `General:AutoUpdateDatabase` e `General:ProcessBackgroundJobs` como `false` no `appsettings.iis.json`.

## Backup

1. Pare o site no Gerenciador do IIS.
1. Faça backup do banco de dados no SQL Server.
1. Faça uma cópia da pasta do site (por exemplo, `C:\inetpub\Signer`). A cópia inclui o `appsettings.iis.json`.

## Atualização

1. Baixe o pacote da versão nova: `https://cdn.lacunasoftware.com/signer/signer-<versão>.zip`. Os links de cada
   versão estão no [changelog](https://docs.lacunasoftware.com/articles/signer/changelog).
1. Extraia o pacote para a pasta do site e sobrescreva todos os arquivos.
1. Faça no `appsettings.iis.json` as alterações que o changelog pedir.
1. Inicie o site no Gerenciador do IIS.

> **Observação**
>
> O pacote não tem um arquivo `appsettings.iis.json`, por isso a sua configuração não muda. O pacote tem um
> `web.config`. Se você alterou o `web.config` (por exemplo, o limite de upload do IIS), refaça a alteração depois de
> extrair o pacote. Veja [Limite de upload](https://docs.lacunasoftware.com/articles/signer/on-premises/limite-de-upload).

## Verifique a atualização

1. Abra `https://<seu-dominio>/api/system/info` e verifique se `productVersion` mostra a versão nova.
1. Abra o arquivo de log (configurado em `Serilog`, por exemplo `C:\Logs\Signer.log`) e procure erros da inicialização.
   A atualização do banco pode levar alguns minutos.

Se o site não iniciar e o log mostrar `PKI SDK License was not loaded successfully`, a aplicação não carregou a
licença do PKI SDK (licença ausente, inválida ou vencida). Peça uma licença atualizada à Lacuna e informe-a em
`PkiSuite:SdkLicense`.

Se o IIS mostrar o erro `500.31` logo depois de uma atualização para a 3.x, verifique se o *Hosting Bundle*
do .NET 10.0 está instalado.

## Se algo der errado

Se a versão nova tiver um problema, fale primeiro com o suporte da Lacuna. Se for preciso voltar à versão anterior,
siga o [rollback de versão](https://docs.lacunasoftware.com/articles/signer/on-premises/rollback). Para voltar só os binários, pare o site e restaure a cópia da
pasta do site.

## Veja também

* [Setup em Windows Server](https://docs.lacunasoftware.com/articles/signer/on-premises/windows)
* [Rollback de versão](https://docs.lacunasoftware.com/articles/signer/on-premises/rollback)
* [Changelog](https://docs.lacunasoftware.com/articles/signer/changelog)