Escolha como instalar o servidor
| Forma | Ideal para | Requisitos |
|---|---|---|
| 1. Imagem de VM pronta | Importar, iniciar, entrar — Debian, PostgreSQL e PassZit prontos | VMware, VirtualBox, Proxmox/KVM ou Hyper-V |
| 2. ISO do appliance | Uma VM nova ou um servidor físico, sem intervenção | Acesso à internet durante a instalação |
| 3. Script de instalação | Um servidor Debian, Ubuntu, AlmaLinux ou Rocky Linux existente | Acesso root e à internet |
| 4. Pacotes manualmente | PostgreSQL próprio, gerenciamento de configuração | O pacote deb ou rpm da versão |
O servidor precisa de 2 vCPU, 2 GB de RAM e um disco de 16 GB. Os navegadores o acessam pela porta TCP 8443. Para as extensões do navegador, ele precisa de um nome e de um certificado em que os navegadores confiem — o PassZit obtém um do Let's Encrypt ou usa o seu (Definições → Certificado).
1. Imagem de VM pronta
VMware ESXi, Workstation, VirtualBox
ESXi Host Client: Create / Register VM → Deploy a virtual machine from an OVF or OVA file. vSphere: Deploy OVF Template.
Proxmox VE e KVM
Crie uma VM sem disco (2 vCPU, 2 GB de RAM, rede VirtIO), importe o disco e anexe-o como disco de boot SCSI.
Hyper-V (geração 1)
Descompacte, crie uma VM de geração 1 com 2 GB de RAM e escolha o VHDX como disco.
No Proxmox VE, depois de copiar a imagem para o nó:
qm importdisk <vmid> passzit-appliance.qcow2 local-lvm
Inicie a VM: a tela mostra o endereço do console e um token de configuração. Abra https://<endereço>:8443, aceite uma vez o certificado autoassinado, informe o token e crie o primeiro administrador com login em dois fatores. Na tela da VM, entre como pzadmin (primeira senha passzit, trocada no primeiro login): um menu configura a rede, o nome do servidor e o fuso horário, mostra o token de configuração e restaura backups. Só as portas 22 (SSH) e 8443 ficam abertas.
2. ISO do appliance
passzit-appliance.iso — inicie uma VM ou servidor por ela. Após 5 segundos começa a instalação automática: ela apaga o primeiro disco, instala Debian, PostgreSQL e PassZit pela rede e depois mostra o endereço do console e o token de configuração.
3. Script de instalação
No Debian 12+, Ubuntu 22.04+, AlmaLinux ou Rocky Linux 9+ (x86-64 ou ARM64), como root:
curl -fsSL https://github.com/Max-Zit/passzit/releases/latest/download/install.sh | sudo sh
O script instala o PostgreSQL, baixa a versão mais recente, verifica a assinatura, cria um banco de dados com senha aleatória, inicia o serviço e mostra o endereço e o token de configuração. Execute-o de novo para atualizar. Opções (com sh -s -- ao usar pipe): --version X, --db postgres://…, --no-auto-updates (deixa desativadas as atualizações automáticas de segurança do sistema), --source URL. Para ler antes:
curl -fsSLO https://github.com/Max-Zit/passzit/releases/latest/download/install.sh
less install.sh
sudo sh install.sh
4. Pacotes e outros arquivos
sudo apt install ./passzit-server_X_amd64.deb # Debian, Ubuntu
sudo dnf install ./passzit-server-X-1.x86_64.rpm # AlmaLinux, Rocky Linux
Defina PASSZIT_DB em /etc/passzit/server.env e depois systemctl start passzit-server. O token de configuração fica em /var/lib/passzit/setup-token.txt. Estes arquivos têm a versão no nome e estão listados na página da versão:
| Arquivo | O que é |
|---|---|
passzit-server_X_amd64.deb, _arm64.deb, .rpm | O servidor, para instalação manual (x86-64 e ARM64) |
passzit-extension-chromium-X.zip, -firefox-X.zip | A extensão do navegador para instalação manual (veja abaixo) |
passzit-cli-X-linux-amd64, -windows-amd64.exe, -darwin-arm64 … | A linha de comando passzit para Linux, Windows e macOS |
passzit-helper-X-linux-amd64, -arm64 | Abre conexões remotas a partir da extensão no Linux; no Windows, quem faz isso é o MaxZit Launcher (baixe-o na página Launcher do seu servidor) |
| SHA256SUMS | Somas de verificação dos programas e pacotes |
| SHA256SUMS-appliance | Somas de verificação das imagens de VM e da ISO |
Extensão do navegador
A extensão preenche e salva logins no Chrome, Edge, Opera, Brave, Vivaldi e Firefox. Instale-a pela loja do seu navegador, que a mantém atualizada:
Chrome Web Store
Chrome, Brave, Opera e Vivaldi.
Firefox Add-ons
Firefox 128 ou mais recente.
Microsoft Edge Add-ons
Microsoft Edge.
Seu servidor PassZit oferece o mesmo: Extensões do navegador no menu do cofre web leva à loja do seu navegador e oferece os pacotes da versão dele para instalação manual. Depois clique no ícone do PassZit, informe o endereço do seu servidor e escolha Ligar com o cofre web — nenhuma senha é digitada na extensão.
Verificar um download
sha256sum -c SHA256SUMS --ignore-missing # programas e pacotes
sha256sum -c SHA256SUMS-appliance --ignore-missing # OVA, QCOW2, zip VHDX, ISO
O servidor e o script de instalação verificam o manifesto assinado da versão antes de instalar qualquer coisa; veja Segurança.
Atualizações
Definições → Atualizações e servidor mostra a versão em uso e a mais recente e instala atualizações, opcionalmente de forma automática em um horário escolhido. Só são instaladas versões assinadas com a chave de publicação do PassZit; o servidor faz antes um backup do banco de dados e do programa e os restaura se a nova versão não iniciar. O canal Testing oferece versões candidatas para um servidor de testes. Definições → Backup da consola guarda backups diários criptografados do banco de dados, da chave secreta do servidor e do certificado para restauração em uma nova máquina.