Seu StartFinance online, do zero ao HTTPS.

Tenha estes itens em mãos antes de abrir o terminal. Isso evita interromper a instalação no meio do processo.

O repositório guarda o código que será clonado na VPS. Mantenha-o privado para não expor o sistema.

O Git envia sua pasta local para o repositório privado. Use sempre o instalador oficial.

winget install --id Git.Git -e --source winget

Depois da instalação, abra o Git Bash dentro da pasta do sistema e confirme:

git --version

Abra o Git Bash na pasta raiz do StartFinance — a mesma pasta que contém install.sh e package.json.

1. Configure sua identificação no Git

git config --global user.name "Seu Nome"
git config --global user.email "seu-email@exemplo.com"

2. Crie o histórico e faça o primeiro commit

git init -b master
git status
git add .
git commit -m "Primeira versão do StartFinance"

3. Conecte e envie ao repositório privado

git remote add origin https://github.com/seu-usuario/StartFinance.git
git push -u origin master

Como o repositório é privado, a VPS precisará de um token para fazer o primeiro clone. O token substitui a senha do GitHub.

Crie a conta pelo link indicado, abra um projeto e adicione um Cloud Server com os parâmetros abaixo.

Firewall da Hetzner

No painel onde seu domínio é administrado, crie um registro do tipo A antes de rodar o instalador.

Após alguns minutos, confirme no PowerShell do Windows:

nslookup finance.seudominio.com.br

O endereço retornado deve ser o IPv4 203.0.113.10. Não continue com o HTTPS enquanto o domínio apontar para outro IP.

O Bitvise oferece terminal SSH e transferência SFTP em uma interface visual para Windows.

Execute os comandos no terminal SSH da VPS. O primeiro instala o Git; o segundo clona o repositório; o terceiro inicia o assistente.

sudo apt-get update && sudo apt-get install -y git
git clone https://github.com/seu-usuario/StartFinance.git startfinance-source
cd startfinance-source
sudo bash install.sh

Versão em uma única linha

sudo apt-get update && sudo apt-get install -y git && git clone https://github.com/seu-usuario/StartFinance.git startfinance-source && cd startfinance-source && sudo bash install.sh

As perguntas aparecem exatamente nesta ordem. Pressionar Enter aceita o valor indicado entre colchetes.

Domínio do sistema (ex.: financeiro.empresa.com): finance.seudominio.com.br
Porta interna do Node.js [3000]: Enter
Configurar HTTPS gratuito com Let's Encrypt agora? [S/n]: S
E-mail para avisos do certificado SSL: seu-email@exemplo.com
Criar o super admin da plataforma agora? [S/n]: S
E-mail do super admin: admin@suaempresa.com.br
Nome do super admin [Super Admin]: Seu nome
Senha do super admin (mínimo 8 caracteres): a senha não aparece
Confirme a senha: digite novamente
Confirma a instalação? [S/n]: S

O que o instalador fará automaticamente

Quando o terminal exibir a confirmação, abra o domínio no navegador e entre com o superadmin criado na etapa anterior.

Comandos de diagnóstico

sudo systemctl status startfinance --no-pager

curl -fsS http://127.0.0.1:3000/api/health

sudo journalctl -u startfinance -n 100 --no-pager

Depois que uma nova versão for enviada ao GitHub, entre novamente na VPS e execute:

cd ~/startfinance-source
git pull
sudo bash update.sh

Problemas mais comuns

sudo certbot --nginx -d finance.seudominio.com.br

sudo systemctl status startfinance --no-pager
sudo journalctl -u startfinance -n 100 --no-pager

Links oficiais úteis