Cómo instalar el software de presupuestación Actual en un servidor Debian 12

Actual Budget es un software de gestión financiera de código abierto enfocado en la privacidad y construido sobre el “Presupuesto Estilo Sobre”. Actual está escrito en Node.js y se puede instalar localmente en poco tiempo. Soporta sincronización entre múltiples dispositivos y cifrado de extremo a extremo opcional.

En este tutorial, te mostraremos cómo instalar el Sistema de Presupuestación Actual en el servidor Debian 12. Instalarás Actual con Nginx como un proxy inverso y lo asegurarás con HTTPS a través de Certbot y Letsencrypt.

Prerrequisitos

Para comenzar con este tutorial, asegúrate de tener:

• Un servidor Debian 12
• Un usuario no root con privilegios de administrador
• Un nombre de dominio apuntando a la dirección IP del servidor

Instalando Node.js y Yarn

Antes de instalar Actual, debes asegurarte de que Node.js, Git y el gestor de paquetes Yarn estén instalados en tu sistema. En este momento, Actual requiere Node v18 o superior, que se puede instalar desde el repositorio oficial de Debian.

Primero, ejecuta el comando ‘ apt ‘ a continuación para actualizar tu índice de paquetes de Debian e instalar paquetes básicos como Node.js, NPM y Git. Ingresa ‘ Y ‘ para confirmar la instalación.

sudo apt update  
sudo apt install nodejs npm git

Una vez que la instalación haya finalizado, instala el gestor de paquetes Yarn usando el comando ‘ npm ‘ a continuación. En este ejemplo, instalarás Yarn globalmente o a nivel del sistema.

npm install --global yarn

Cuando termines, verifica la versión de Node.js y Yarn con el comando a continuación.

node --version  
yarn --version

En la salida a continuación, puedes ver que Node.js 18 y Yarn 1.22 están instalados.

Descargando el código fuente de Actual Budget

Después de que las dependencias estén instaladas, estás listo para descargar el código fuente de Actual, instalar dependencias a través de Yarn, configurar Actual con el archivo ‘config.json’ y luego ejecutar Actual a través de la línea de comandos. Además, necesitas un usuario dedicado para instalar y ejecutar Actual en tu sistema.

Inicia sesión en tu usuario con el comando a continuación.

su - username

Descarga el código fuente de Actual Budget con el comando ‘ git ‘ a continuación.

git clone https://github.com/actualbudget/actual-server.git

Ve al directorio ‘ actual-server ‘ e instala las dependencias de JavaScript con el comando ‘ yarn ‘ a continuación.

cd actual-server  
yarn install

Puedes ver a continuación la instalación de dependencias de JavaScript a través del gestor de paquetes Yarn.

Una vez que la instalación esté completa, crea un nuevo archivo ‘ config.json ‘ usando el editor ‘ nano ‘.

nano config.json

Inserta la configuración a continuación para ejecutar Actual en la dirección IP local con el puerto predeterminado 5006.

{  
 "hostname": "127.0.0.1",  
 "port": 5006  
}

Guarda el archivo y sal del editor.

Por último, ejecuta el comando ‘ yarn start ‘ a continuación para iniciar el software actual. Esto abrirá el puerto 5006 en tu localhost o dirección ‘ 127.0.0.1 ‘ que será utilizado por la aplicación.

yarn start

Presiona Ctrl+c para terminar el proceso.

Ejecutando Actual en segundo plano como un servicio Systemd

Ahora que has instalado y configurado Actual, vamos a crear un nuevo archivo de servicio systemd para ejecutar Actual en segundo plano como un servicio systemd.

Crea un nuevo archivo de servicio systemd ‘ /etc/systemd/system/actual.service ‘ con el siguiente editor ‘ nano ‘.

sudo nano /etc/systemd/system/actual.service

Inserta la configuración a continuación para ejecutar Actual en segundo plano como un servicio systemd. Asegúrate de cambiar el ‘ User ‘ y ‘ Group ‘ predeterminados con tu nombre de usuario, luego cambia el ‘ WorkingDirectory ‘ con tu ruta adecuada.

[Unit]  
Description=Actual-Server (https://actualbudget.org)  
After=network.target  
  
[Service]  
User=flash  
Group=flash  
WorkingDirectory=/home/flash/actual-server/  
ExecStart=/usr/local/bin/yarn start  
Restart=on-watchdog  
  
[Install]  
WantedBy=multi-user.target

Guarda el archivo y sal del editor cuando termines.

Ahora ejecuta el comando ‘ systemctl ‘ a continuación para recargar el gestor systemd y aplicar tus cambios.

sudo systemctl daemon-reload

Y luego, inicia y habilita el ‘ actual.service ‘ usando el siguiente comando. Esto iniciará el ‘ actual.service ‘ en segundo plano y lo habilitará para que se ejecute automáticamente al iniciar el sistema.

sudo systemctl enable --now actual.service

Verifica el estado del ‘ actual.service ‘ con el comando a continuación. Deberías ver que el ‘ actual.service ‘ está en ejecución y habilitado en tu sistema.

sudo systemctl status actual.service

Configurando Nginx como un Proxy Inverso

En este punto, Actual está en funcionamiento en segundo plano como un servicio systemd. En esta sección, instalarás Nginx y lo configurarás como un proxy inverso para Actual. Después de eso, generarás certificados SSL para tu implementación de Actual a través de Certbot y Letsencrypt.

Primero, ejecuta el comando ‘ apt ‘ a continuación para instalar Nginx, Certbot y el complemento Python3 Certbot Nginx. Ingresa ‘ Y ‘ para proceder con la instalación.

sudo apt install nginx certbot python3-certbot-nginx -y

Una vez que la instalación haya finalizado, crea un nuevo archivo de bloque de servidor Nginx ‘ /etc/nginx/sites-available/actual-budget ‘ con el editor ‘ nano ‘.

sudo nano /etc/nginx/sites-available/actual-budget

Inserta la configuración a continuación y asegúrate de cambiar el parámetro ‘ server_name ‘ con tu nombre de dominio.

server {  
listen 80;  
server_name budget.howtoforge.local;  
  
location / {  
include /config/nginx/proxy.conf;  
include /config/nginx/resolver.conf;  
  
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
proxy_set_header Host $host;  
  
set $upstream_app 127.0.0.1;  
set $upstream_port 5006;  
set $upstream_proto http;  
proxy_pass $upstream_proto://$upstream_app:$upstream_port;  
}  
}

Cuando termines, guarda el archivo y sal del editor.

Ahora ejecuta el comando a continuación para activar el bloque de servidor ‘ actual-budget ‘ y verificar tus configuraciones de Nginx. Si no hay error, obtendrás una salida como ‘ syntax is ok - test is successful ‘.

sudo ln -s /etc/nginx/sites-available/actual-budget /etc/nginx/sites-enabled/  
sudo nginx -t

A continuación, ejecuta el comando a continuación para reiniciar y verificar el estado del servicio Nginx. Asegúrate de que el servidor web Nginx esté en funcionamiento.

sudo systemctl restart nginx  
sudo systemctl status nginx

Por último, ejecuta el comando ‘ certbot ‘ a continuación para generar certificados SSL y asegurar tu instalación de software Actual. Asegúrate de cambiar el nombre de dominio y la dirección de correo electrónico en el siguiente comando.

sudo certbot --nginx --agree-tos --redirect --hsts --staple-ocsp --email <[email protected]> -d budget.howtoforge.local

Cuando el proceso haya finalizado, tu instalación de Actual debería estar asegurada con HTTPS a través de Certbot y Letsencrypt. Tus certificados SSL están disponibles en el directorio ‘ /etc/letsencrypt/live/domain.com ‘ y HTTPS está habilitado automáticamente en tu archivo de bloque de servidor.

Accediendo a Actual Budget a través del Navegador Web

Visita el nombre de dominio de tu instalación de Actual como https://budget.howtoforge.local. Si tienes éxito, verás el mensaje de bienvenida a Actual y se te pedirá que configures una contraseña.

Ingresa tu nueva contraseña y repítela, luego haz clic en ‘ OK ‘.

Una vez que la contraseña esté configurada, ingresa tu contraseña para iniciar sesión en el Panel de Control de Actual.

Por primera vez, se te pedirá que veas datos de demostración o comiences de nuevo.

Si estás familiarizado con Actual, puedes hacer clic en ‘ Comenzar de nuevo ‘, pero si eres nuevo en Actual, haz clic en ‘ Ver demostración ‘ para tener una idea del uso básico de Actual.

A continuación se muestra un ejemplo de datos de demostración del Sistema de Presupuestación Actual.

Conclusión

¡Felicidades! Has completado la instalación de Actual, un software financiero enfocado en la privacidad, en un servidor Debian 12. Has puesto Actual en funcionamiento como un servicio systemd en segundo plano, que se ejecuta sobre el proxy inverso Nginx. Además, también has asegurado Actual con HTTPS a través de Certbot y Letsencrypt.