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

# Atualização do Signer em Linux

Esta página mostra como atualizar uma [instância *on premises*](https://docs.lacunasoftware.com/articles/signer/on-premises) do [Signer](https://docs.lacunasoftware.com/articles/signer)
instalada em Linux conforme a [instalação em Ubuntu Server](https://docs.lacunasoftware.com/articles/signer/on-premises/linux/install-ubuntu).

> **Info**
>
> Essas instruções assumem que você está autenticado como **root**. Se você não estiver, execute `sudo su -` antes de continuar.

## Antes de atualizar

1. Verifique a versão instalada:

   ```sh
   curl http://localhost:5001/api/system/info
   ```

   O campo `productVersion` da resposta 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 ASP.NET Core Runtime 10.0.
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`.

## Backup

1. Faça backup do banco de dados no SQL Server.
1. Faça uma cópia da pasta dos binários e da pasta de configuração:

   ```sh
   tar czf /root/signer-backup-$(date +%Y%m%d).tar.gz /usr/share/lacuna-signer /etc/lacuna-signer
   ```

## Atualização

1. Defina a versão nova. Veja a versão mais recente no [changelog](https://docs.lacunasoftware.com/articles/signer/changelog):

   ```sh
   VERSION=3.0.0
   ```

1. Baixe o pacote, pare o serviço, troque os binários e inicie o serviço:

   ```sh
   curl -O https://cdn.lacunasoftware.com/signer/signer-$VERSION.tar.gz
   systemctl stop lacuna-signer
   rm -fR /usr/share/lacuna-signer/*
   tar xzf signer-$VERSION.tar.gz -C /usr/share/lacuna-signer
   chmod -R a=,u+rwX,go+rX /usr/share/lacuna-signer
   systemctl start lacuna-signer
   ```

A configuração fica em `/etc/lacuna-signer` e não muda com a atualização.

## Verifique a atualização

1. Verifique se o serviço está ativo:

   ```sh
   systemctl status lacuna-signer
   ```

1. Verifique se `productVersion` mostra a versão nova:

   ```sh
   curl http://localhost:5001/api/system/info
   ```

1. Acompanhe o log durante a primeira inicialização. A atualização do banco pode levar alguns minutos:

   ```sh
   journalctl -u lacuna-signer -f
   ```

Se o serviço 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 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, extraia a pasta
`/usr/share/lacuna-signer` do backup.

## Veja também

* [Setup do Signer em Linux](https://docs.lacunasoftware.com/articles/signer/on-premises/linux)
* [Resolução de problemas](https://docs.lacunasoftware.com/articles/signer/on-premises/linux/troubleshoot)
* [Rollback de versão](https://docs.lacunasoftware.com/articles/signer/on-premises/rollback)