Desplegar FacturaScripts con Docker

Puesta en marcha

En tres pasos tienes FacturaScripts funcionando en contenedores.

Instala Docker

Si no conoces Docker, es mejor que evites este método de instalación. Docker no es para todo el mundo y puede resultar complicado si estás empezando. Aquí tienes la documentación oficial para instalar Docker según el sistema operativo que uses.

Despliega con docker-compose.yml

FacturaScripts necesita MySQL o MariaDB para almacenar los datos, así que además del contenedor de FacturaScripts necesitas uno de base de datos. Con docker compose puedes iniciar ambos de forma organizada: usa el docker-compose.yml oficial de FacturaScripts, que ya incluye todo lo necesario. Ejecuta estos comandos en una terminal:

wget https://raw.githubusercontent.com/FacturaScripts/docker-facturascripts/master/docker-compose.yml
sudo docker compose up -d

Con esta configuración se ejecuta un contenedor con FacturaScripts que guarda los datos en el directorio facturascripts y un contenedor con MySQL que los guarda en el directorio mysql.

Abre el instalador

Abre el navegador y entra en http://localhost
Escribe mysql como host base de datos
Escribe mypassword como contraseña base de datos
Si tienes problemas, consulta la sección de errores frecuentes.

Bueno saber

Otras formas de usar la imagen y detalles del contenedor oficial.

Solamente el contenedor

Si solo necesitas el contenedor de FacturaScripts, puedes descargar la imagen facturascripts/facturascripts desde Docker Hub. Ejecuta esto en una terminal:

sudo docker pull facturascripts/facturascripts
sudo docker run -d --name facturascripts -p 80:80 facturascripts/facturascripts:latest

Este comando ejecuta el contenedor de FacturaScripts y mapea el puerto 80 de localhost al puerto 80 del contenedor. Después puedes abrir tu navegador y entrar en http://localhost para acceder a FacturaScripts.

Versiones antiguas

Si quieres instalar una versión concreta de FacturaScripts, solo tienes que indicar la versión del contenedor, igual que con cualquier otra imagen de Docker. Aquí tienes un ejemplo instalando la versión 2022.4:

sudo docker pull facturascripts/facturascripts:2022.4
sudo docker run -d --name facturascripts -p 80:80 facturascripts/facturascripts:2022.4

Arquitecturas soportadas

Hasta la versión 2024 solo compilábamos las imágenes de Docker para arquitectura amd64 (procesadores Intel y AMD). Desde la versión 2024, compilamos imágenes para las arquitecturas amd64, arm64 y armv7:

AMD64: procesadores Intel y AMD
ARM64: procesadores Apple M1, M2, M3 y servidores ARM
ARMv7: Raspberry Pi 3, 4 y 5

Actualizaciones

Para actualizar FacturaScripts en Docker no tienes que hacer nada especial. Solo tienes que ir al menú Administrador > Actualizador e instalar las actualizaciones disponibles. No necesitas descargar una nueva imagen de Docker para actualizar y, aunque lo hicieras, no se actualizaría, ya que la versión que se ejecuta es la del volumen del contenedor y no la de la imagen del contenedor.

Ya lo tienes funcionando

Lo importante antes de ponerte a facturar, y ayuda por si algo falla.

Recuerda

Ya has desplegado FacturaScripts con Docker. Puedes acceder abriendo el navegador y escribiendo http://localhost en la barra de direcciones. Por defecto el usuario es admin y la contraseña es admin. Cámbiala cuanto antes y procura recordarla.

Te recomendamos nuestro curso gratuito de usuario, con decenas de lecciones en vídeo. Al completarlo obtienes un certificado.

Curso gratuito de usuario

Errores frecuentes

2002: php_network_getaddresses: getaddrinfo failed

No se ha podido conectar a la base de datos. Suele ocurrir cuando dejas localhost en lugar del nombre del Docker de la base de datos. Si usas nuestro docker-compose, escribe mysql como host de base de datos y mypassword como contraseña.

Cannot start service mysql: OCI runtime create failed (cgroups v2)

Probablemente estás usando Fedora. Para usar Docker en Fedora necesitas instalar la versión oficial de Docker, en lugar de la que proporciona Fedora.

Docker con XDEBUG

Si necesitas un Docker alternativo que incluya xdebug y phpMyAdmin, puedes usar el repositorio totva/docker-facturascripts.