Despliega FacturaScripts con Docker

Docker te permite automatizar el despliegue de aplicaciones dentro de contenedores de software, añadiendo una capa extra de abstracción sobre el sistema operativo. Puedes usar nuestro Docker oficial de FacturaScripts en Docker Hub para desplegar FacturaScripts. Este contenedor ya incluye Apache, PHP y todas las extensiones necesarias.

Instalación de 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.

FacturaScripts necesita MySQL o MariaDB para almacenar los datos. Por eso necesitas uno de estos contenedores, además del de FacturaScripts, para poder trabajar. Tenlo en cuenta al desplegarlo con Docker o, si lo prefieres, usa nuestro docker-compose.yml, que ya incluye todo lo necesario.

docker-compose.yml

Con docker compose puedes iniciar varios contenedores de forma organizada, lo que resulta perfecto para poner en marcha tanto FacturaScripts como MySQL con todos los parámetros necesarios. Usa el docker-compose.yml oficial de FacturaScripts para desplegar FacturaScripts y MySQL. 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.

Para continuar

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.

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.

Recuerda

Ya has instalado FacturaScripts en tu Docker. Por defecto, el usuario es admin y la contraseña también es admin. Si la cambias, procura recordarla.

También puede interesarte nuestro curso de usuario, totalmente gratis. Aprende a usar FacturaScripts con nuestras lecciones en vídeo: crear productos, clientes, hacer una factura, una devolución, etc.

Curso de usuario

Errores frecuentes

2002: php_network_getaddresses: getaddrinfo failed: Name or service not known
- Este error suele indicar que no se ha podido conectar al servidor de base de datos. Normalmente ocurre cuando dejas localhost en lugar del nombre del Docker de la base de datos. Si estás usando nuestro docker-compose, recuerda que debes escribir mysql como host de base de datos y mypassword como contraseña.
ERROR: for root_mysql_1 Cannot start service mysql: OCI runtime create failed: this version of runc doesn't work on cgroups v2: unknown
- Si te aparece este error, 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.

XDEBUG

Si necesitas un Docker alternativo que incluya xdebug y phpMyAdmin, puedes usar este repositorio: https://github.com/totva/docker-facturascripts