Como Hospedar Firefly III em um VPS (Guia Completo)

Visão Geral do Firefly III

Firefly III é um gerenciador de finanças pessoais de código aberto que ajuda os usuários a rastrear despesas, receitas e orçamentos. Com suas funcionalidades poderosas e flexibilidade, é uma excelente escolha para quem deseja recuperar o controle sobre suas finanças. Este guia irá mostrar os passos para hospedar o Firefly III em um VPS usando Docker, oferecendo uma abordagem prática para desenvolvedores e entusiastas de homelab.

Escolhendo um Provedor de VPS

Antes de iniciar a instalação, é importante escolher um provedor de VPS confiável. Abaixo, uma comparação de algumas das principais opções disponíveis no mercado.

Para uma comparação mais detalhada, confira nossa comparação completa de VPS.

Pré-requisitos

1. Configuração do VPS: Escolha e cadastre-se em um provedor de VPS. Recomenda-se usar um servidor com Ubuntu 20.04 ou superior.
2. Nome de Domínio: Para facilitar o acesso, recomenda-se adquirir um nome de domínio, embora não seja estritamente necessário.
3. Acesso SSH: Certifique-se de ter acesso SSH ao seu VPS para operações via linha de comando.
4. Docker & Docker Compose: Instale o Docker e o Docker Compose, necessários para executar o Firefly III em containers.

Passos para Instalar o Firefly III em um VPS

Passo 1: Conectar-se ao Seu VPS

Use um cliente SSH para se conectar ao seu VPS:

ssh root@seu-ip-do-vps

Passo 2: Instalar Docker e Docker Compose

Execute os seguintes comandos para instalar o Docker e o Docker Compose:

# Atualize seu gerenciador de pacotes
apt update
apt upgrade -y

# Instale o Docker
apt install docker.io -y

# Inicie o serviço do Docker
systemctl start docker
systemctl enable docker

# Instale o Docker Compose
apt install docker-compose -y

Você pode verificar a instalação do Docker com:

docker --version
docker-compose --version

Passo 3: Configurar o Firefly III

1. Crie um diretório para o Firefly III:

mkdir ~/firefly-iii
cd ~/firefly-iii

2. Crie um arquivo docker-compose.yml:

version: '3.8'
services:
  app:
    image: fireflyiii/core:latest
    restart: unless-stopped
    ports:
      - '8080:80'
    environment:
      - APP_KEY=your_app_key_here
      - DB_CONNECTION=mysql
      - DB_HOST=db
      - DB_DATABASE=firefly_iii
      - DB_USERNAME=firefly
      - DB_PASSWORD=your_db_password_here
    volumes:
      - firefly-storage:/var/www/html/storage
  db:
    image: mysql:5.7
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: your_root_password_here
      MYSQL_DATABASE=firefly_iii
      MYSQL_USER=firefly
      MYSQL_PASSWORD=your_db_password_here
    volumes:
      - db-data:/var/lib/mysql

volumes:
  firefly-storage:
  db-data:

3. Iniciar os Serviços:

docker-compose up -d

Você pode verificar os containers em execução com:

docker ps

Passo 4: Acessar o Firefly III

Abra seu navegador e acesse http://seu-ip-do-vps:8080. Siga o assistente de configuração para concluir a instalação.

FAQ (Perguntas Frequentes)

1. Qual o custo de hospedar Firefly III em um VPS?

O custo de hospedar Firefly III depende do provedor de VPS que você escolher. Provedores como Hetzner Cloud oferecem planos a partir de 4,15 EUR/mês, tornando acessível para desenvolvedores e entusiastas de homelab. Considere também fatores adicionais, como tráfego esperado, necessidades de armazenamento e o uso de outros serviços no VPS.

2. Posso instalar Firefly III sem Docker?

Sim, é possível instalar Firefly III sem Docker; porém, usar Docker simplifica o processo e garante que todas as dependências sejam gerenciadas corretamente. Caso opte por instalar sem Docker, será necessário instalar manualmente PHP, Composer e um servidor web como Nginx ou Apache, o que pode ser mais complexo para usuários não familiarizados com configuração de servidores.

3. Como faço backup dos meus dados do Firefly III?

O backup dos seus dados pode ser feito de várias formas. O método mais simples é criar um backup do banco de dados MySQL e do volume de armazenamento da aplicação. Para procedimentos de backup, você pode usar:

docker exec <nome-do-container> mysqldump -u firefly -p firefly_iii > backup.sql

Depois, copie o volume de armazenamento:

docker cp <nome-do-container>:/var/www/html/storage caminho_do_diretorio_de_backup

Realizar backups regulares garante que você não perca dados importantes em caso de erros ou problemas no servidor.

Conclusão

Hospedar o Firefly III em um VPS oferece maior controle sobre seus dados financeiros e sua privacidade. Com a possibilidade de implantá-lo usando Docker, a configuração se torna mais simples, especialmente para desenvolvedores. Escolha um provedor que atenda às suas necessidades, siga os passos deste guia e em pouco tempo o Firefly III estará funcionando. Aproveite também para consultar fóruns como r/selfhosted para suporte comunitário e novidades sobre boas práticas. --- FIM ---