O LND sai com versão nova algumas vezes por ano, e quase sempre vale atualizar: são correções de segurança, de estabilidade e melhorias de roteamento. A atual é a 0.21.8, de 11 de novembro de 2026.
Atualizar não é instalar de novo. A carteira, os canais, o lnd.conf e o serviço já estão no lugar e continuam como estão. Só o programa muda. Na prática, você repete os passos iniciais do guia de instalação do LND: baixar a versão nova, conferir a assinatura e instalar por cima da antiga. Antes disso, quatro cuidados.
1. Guarde o channel.backup
O channel.backup é o backup dos seus canais e muda a cada canal aberto ou fechado. Fica em ~/.lnd/data/chain/bitcoin/mainnet/channel.backup, na pasta do LND. Copie para fora da máquina antes de atualizar. Junto com a seed, é o que devolve o seu dinheiro se a máquina der problema, em qualquer banco de dados que o seu LND use (bbolt, Postgres ou SQLite).
E nunca restaure uma cópia antiga do banco do LND para “voltar no tempo”. Um banco desatualizado faz o node publicar um estado velho do canal, e o peer pode punir levando o saldo inteiro. Se der problema sério, o caminho é seed mais channel.backup, como explica a documentação de recuperação do LND.
2. Leia as notas da versão
As notas da versão dizem o que mudou. Você não precisa entender tudo, só procurar o que toca o seu node.
As opções do seu
lnd.conf. Uma série nova pode remover ou renomear opções. Se uma linha do seulnd.confdeixou de existir, o LND não sobe, e o log diz qual opção não reconhece. Procure nas notas as opções que você usa.As funcionalidades que você usa. Tor, watchtower, Postgres, keysend, os apps que se conectam ao node: confira se alguma coisa mudou para eles.
Quem pula várias versões de uma vez deve ler as notas de cada série no caminho, e não só as da última.
3. Migração do banco: não tem volta
Algumas versões migram o banco de dados na primeira partida. As notas avisam quando isso acontece. A 0.21.8, por exemplo, não tem migração.
Duas coisas para saber quando a versão migra:
A primeira partida demora mais que o normal. Espere terminar, acompanhando o log, e não reinicie no meio.
Depois da migração, a versão anterior não abre mais o banco. Voltar o binário antigo deixa de ser uma saída. Por isso o
channel.backupvem antes de tudo.
4. Atualize
Com o backup feito e as notas lidas, são os passos do guia, com a versão nova na variável. Num Linux de 64 bits:
cd /tmp
VERSION=0.21.8
wget https://github.com/lightningnetwork/lnd/releases/download/v$VERSION-beta/lnd-linux-amd64-v$VERSION-beta.tar.gz
wget https://github.com/lightningnetwork/lnd/releases/download/v$VERSION-beta/manifest-v$VERSION-beta.txt
wget https://github.com/lightningnetwork/lnd/releases/download/v$VERSION-beta/manifest-roasbeef-v$VERSION-beta.sig
curl https://raw.githubusercontent.com/lightningnetwork/lnd/master/scripts/keys/roasbeef.asc | gpg --import
gpg --verify manifest-roasbeef-v$VERSION-beta.sig manifest-v$VERSION-beta.txt
sha256sum --check manifest-v$VERSION-beta.txt --ignore-missing
O gpg precisa dizer “Good signature”, e o sha256sum precisa dizer “OK” para o arquivo baixado. Se um dos dois falhar, pare: o arquivo não é o oficial. Num Raspberry, troque amd64 por arm64.
Depois, pare o LND, instale por cima e suba de novo:
sudo systemctl stop lnd
tar -xvf lnd-linux-amd64-v$VERSION-beta.tar.gz
sudo install -m 0755 -o root -g root -t /usr/local/bin lnd-linux-amd64-v$VERSION-beta/lnd lnd-linux-amd64-v$VERSION-beta/lncli
lnd --version
sudo systemctl start lnd
journalctl -fu lnd
O lnd --version precisa mostrar a versão nova antes de você subir o serviço. Espere o LND parar de vez antes de instalar: num banco grande, isso pode levar um minuto.
Depois de subir
No log, espere o LND abrir o banco e destravar a carteira. Num banco grande, ou com a compactação automática do bbolt ligada, isso leva alguns minutos. É normal.
Quando o
lncli getinforesponder, confira a versão e sesynced_to_chainesynced_to_graphestãotrue.Os canais voltam aos poucos, nos primeiros minutos, conforme os peers reconectam.
Se um app que usa o LND, como o LNbits, ficar sem conexão, reinicie o app depois que o LND estiver pronto.
Se não subir
O log reclama de uma opção do
lnd.conf: é uma opção que saiu ou mudou de nome. Comente a linha com#na frente, veja nas notas o que entrou no lugar e suba de novo.Outro erro, numa versão sem migração: dá para voltar à versão anterior pelos mesmos passos, com a versão antiga na variável
VERSION.Depois de uma migração: não volte a versão nem restaure banco antigo. Guarde o log e peça ajuda com ele.
No BR⚡LN Club
Quem usa o LightningOS atualiza o LND pela própria tela, que faz a conferência da assinatura e guarda a versão anterior. No chat do clube, a sala Suporte acompanha quem vai atualizar pela primeira vez, e é lá que dá para colar o log se alguma coisa não subir.


