Como instalar o Firefly III na Saplo (orçamento e finanças sem aplicação bancária)

Quem tem contas em dois ou três bancos conhece este problema: para ter uma visão geral das finanças, é preciso iniciar sessão em várias aplicações bancárias e somar os valores na cabeça ou numa folha de cálculo separada. Uma folha de cálculo resolve isto apenas parcialmente, porque cada transação tem de ser introduzida manualmente e, após alguns meses, as categorias deixam de corresponder, as fórmulas estragam-se e o orçamento doméstico deixa de estar atualizado. O Firefly III é uma aplicação open source para o orçamento e finanças pessoais ou empresariais, contas, categorias, orçamentos, tags e relatórios num só lugar, com a possibilidade de importar extratos CSV através de uma aplicação adicional, o Data Importer, que instalas no teu próprio Box em vez de numa aplicação bancária de terceiros ou numa folha de cálculo desorganizada. Abaixo, um guia passo a passo sobre como instalar o Firefly III na Saplo.

Porquê o Firefly III em vez de uma aplicação bancária e uma folha de cálculo

A aplicação bancária e a folha de cálculo são gratuitas, mas têm desvantagens que só se revelam após uma utilização mais prolongada, e não logo no início:

• a aplicação bancária mostra apenas um banco, por isso, com contas em várias instituições, não há um único local com uma visão completa das despesas, poupanças e orçamento,
• a folha de cálculo requer a introdução manual de cada transação, e quanto mais tempo é utilizada, mais fácil é cometer um erro na fórmula ou esquecer uma categoria,
• os dados financeiros na aplicação bancária estão sob o controlo do banco, não da pessoa que os introduz, e o histórico do orçamento de há anos geralmente não pode ser exportado de forma útil.

O Firefly III não tem nenhuma dessas limitações, porque funciona como um conjunto de contentores Docker na tua própria Box: agrega qualquer número de contas, elabora orçamentos e categorias com base nas transações introduzidas, e os dados permanecem no teu servidor, e não na cloud de outra pessoa.

Requisitos

Para instalar o Firefly III na Saplo, precisas de:

• Uma Box com o Docker em execução (o motor ativa-o automaticamente ao instalar a partir do catálogo, é necessário aninhamento no contentor, o que a Saplo tem por padrão),
• Mínimo de 512 MB de RAM livres na Box e 2 GB de espaço em disco, o que significa que o plano Box S por 27 € anuais é suficiente,
• Um domínio ou subdomínio *.saploapp.pl incluído em cada plano, onde o painel do Firefly III será alojado,
• Não precisas de configurar uma base de dados separada manualmente, o Firefly III obtém a sua própria base de dados vazia no MySQL partilhado da Saplo, o motor transmite os dados de acesso automaticamente.

Podes encontrar uma descrição completa da aplicação e o seu lugar no catálogo na página do Firefly III na Saplo.

Instalação passo a passo

1. No painel da Saplo, vai a Catálogo de aplicações e escolhe Firefly III.
2. Indica uma Box com pelo menos 512 MB de RAM livre, onde a aplicação será instalada, e o domínio ou subdomínio onde o painel irá funcionar.
3. Confirma a instalação. O motor cria dois contentores: a aplicação a partir da imagem oficial fireflyiii/core, exposta apenas ao loopback da Box e ligada a um nginx com SSL gratuito, e um contentor cron leve separado (alpine), que uma vez por noite ativa a tarefa responsável por transações recorrentes e regras automáticas, de acordo com a documentação oficial do Firefly III.
4. Após o início dos contentores, o motor verifica se a aplicação está realmente a funcionar. A migração do esquema da base de dados na primeira inicialização pode demorar mais do que os habituais dez segundos.
5. Após a conclusão da instalação, o painel Firefly III está disponível no domínio indicado.

Primeira configuração

O Firefly III não cria automaticamente uma conta de administrador, porque não tem uma API integrada para isso quando o contentor é iniciado.

1. Acede ao endereço do domínio e clica em registar. A primeira pessoa a criar uma conta obtém automaticamente os privilégios de proprietário.
2. Na secção Accounts, adiciona contas de ativos, uma por cada conta bancária ou dinheiro que queiras controlar.
3. Nas secções Categories e Budgets, configura as tuas próprias categorias de despesas e limites orçamentais mensais, adaptados às tuas finanças.
4. Adiciona as transações manualmente no painel de controlo. A importação de ficheiros CSV requer uma aplicação separada, o Firefly III Data Importer, que esta receita não instala. A simples execução do Firefly III não garante a importação de CSV nem a obtenção automática de extratos bancários.
5. As transações recorrentes e as regras automáticas (por exemplo, uma transferência de renda permanente) são acionadas automaticamente graças a um contentor cron separado, que aciona o endpoint apropriado uma vez por noite, sem necessidade de ativação manual.

Firefly III na Saplo vs. aplicação bancária e folha de cálculo

Perguntas frequentes

O Firefly III importa extratos bancários automaticamente? Não. Na instalação descrita, adicionas as transações manualmente. A importação de ficheiros CSV também requer o Firefly III Data Importer, que a receita do Saplo não instala. Consulta as instruções oficiais para importação de CSV.

Quantas contas bancárias posso adicionar? Não há limite, o número de contas patrimoniais no Firefly III não é limitado por nada além dos recursos da Box.

Preciso de criar a base de dados sozinho? Não, o motor cria uma base de dados vazia no MySQL partilhado do Saplo e transmite os dados de acesso ao contentor automaticamente durante a instalação.

Quem recebe as permissões de administrador? A primeira pessoa que se registar no site logo após a instalação recebe automaticamente as permissões de proprietário, por isso é aconselhável criar uma conta logo após a conclusão da instalação.

As transações recorrentes e as regras automáticas funcionam sozinhas? Sim, graças a um contentor cron separado, que aciona o endpoint apropriado da aplicação todas as noites, exatamente como recomendado pela documentação oficial do Firefly III.

Firefly III é uma das mais de 160 aplicações que podes executar no Saplo a partir do catálogo. Explicamos como funciona o alojamento de aplicações numa única Box numa página separada.

Se estás cansado de alternar entre as aplicações de vários bancos e preencher manualmente as tuas folhas de cálculo, escreve-nos, nós vamos ajudar-te a escolher a Box e a configurar o Firefly III.