ConvertX | Docker | Self-Hosted

ConvertX: Conversor de archivos autohospedado con soporte para +1000 formatos

Convierte imgenes, videos, documentos, audios y ms de 1000 formatos diferentes desde una interfaz web moderna y fcil de usar. Toda la potencia en tu servidor.

Qu es ConvertX?

ConvertX es un conversor de archivos online autohospedado que soporta ms de 1000 formatos diferentes. Construido con TypeScript, Bun y Elysia, ofrece una experiencia rpida y fluida para convertir cualquier tipo de archivo sin depender de servicios de terceros.

En Docker: Desplegar ConvertX en un contenedor Docker es la forma ms sencilla de tener un conversor de archivos profesional en tu propio servidor. Sin lmites de uso, sin filas de espera y con total control sobre tus datos.

Ventaja principal: Convierte archivos de ms de 1000 formatos diferentes desde tu propio servidor, sin enviar nada a la nube. Documentos, imgenes, videos, audio y hasta modelos 3D.

Caractersticas principales

+1000 formatos

Soporta ms de mil formatos de imagen, vdeo, audio, documento y 3D.

Conversin masiva

Procesa mltiples archivos simultneamente sin lmites de uso.

Interfaz web moderna

Diseo limpio y responsive. Arrastra y suelta tus archivos.

Multi-cuenta

Soporte para mltiples usuarios con gestin de cuentas.

Historial de conversiones

Mantn un registro de todas las conversiones realizadas.

Contrasea protegida

Protege el acceso con autenticacin por contrasea.

Auto-eliminacin

Borra automticamente archivos antiguos para ahorrar espacio.

Self-hosted

Tus archivos nunca salen de tu servidor. Privacidad total.

Procesos simultneos

Configura el nmero mximo de conversiones concurrentes.

API REST

Interacta con ConvertX programticamente mediante su API.

Open Source

Licencia AGPL-3.0. Cdigo abierto y gratuito para siempre.

Actualizaciones automticas

Imagen Docker con soporte Renovate.

Requisitos del sistema

Docker e imagen Docker instalados
512 MB de RAM (1 GB recomendado para grandes volmenes)
1 GB de espacio en disco para la aplicacin y dependencias
Puerto 3000 disponible
Volmenes de host montados para persistencia de datos

Nota importante: Si el contenedor muestra el error unable to open database file, ejecuta chown -R $USER:$USER /ruta/a/los/datos para corregir los permisos.

Instalacin rpida con Docker Compose

Paso 1: Crear docker-compose.yml

version: '3.8' services: convertx: image: ghcr.io/c4illin/convertx:latest container_name: convertx restart: unless-stopped ports: - "3000:3000" environment: - JWT_SECRET=tuClaveSecretaLargaYSegura123 - TZ=Europe/Madrid # - HTTP_ALLOWED=true # Actvalo solo si accedes por HTTP # - ACCOUNT_REGISTRATION=true # Permite registro de nuevos usuarios volumes: - ./data:/app/data

Paso 2: Iniciar el contenedor

docker compose up -d

Paso 3: Acceder a ConvertX

Abre en tu navegador: http://localhost:3000

Crea la primera cuenta de inmediato, ya que cualquiera podra registrarse si el servicio est abierto al pblico.

IMPORTANTE: Si vas a exponer ConvertX a travs de HTTPS o un reverse proxy, NO actives HTTP_ALLOWED. Solo actvalo si lo usas localmente o en una red privada.

Configuracin avanzada

Variables de entorno disponibles

Variable	Valor por defecto	Descripci�n
JWT_SECRET	randomUUID()	Clave secreta para firmar los tokens JWT. Recomendado definirla.
ACCOUNT_REGISTRATION	false	Permite que nuevos usuarios se registren.
HTTP_ALLOWED	false	Permite acceso por HTTP sin HTTPS.
ALLOW_UNAUTHENTICATED	false	Permite conversin sin autenticacin.
MAX_CONVERT_PROCESS	0	Mximo de procesos concurrentes. 0 = ilimitado.
AUTO_DELETE_EVERY_N_HOURS	24	Borra archivos ms antiguos que N horas. 0 = desactivar.
LANGUAGE	en	Idioma de las fechas (etiqueta BCP 47).
HIDE_HISTORY	false	Oculta la pgina de historial.
WEBROOT	/	Ruta raz del sitio web.
FFMPEG_ARGS		Argumentos extra para ffmpeg (entrada).
FFMPEG_OUTPUT_ARGS		Argumentos extra para ffmpeg (salida).

Ejemplo completo con variables

services: convertx: image: ghcr.io/c4illin/convertx:latest container_name: convertx restart: unless-stopped ports: - "3000:3000" environment: - JWT_SECRET=TuClaveSecretaMuyLarga1234567890 - TZ=Europe/Madrid - ACCOUNT_REGISTRATION=false - HTTP_ALLOWED=false - AUTO_DELETE_EVERY_N_HOURS=12 - MAX_CONVERT_PROCESS=4 - LANGUAGE=es volumes: - /ruta/convertx/data:/app/data

Formatos y conversores soportados

ConvertX integra las herramientas ms potentes de cdigo abierto para ofrecerte una compatibilidad masiva:

Conversor	Categora	Formatos de entrada	Formatos de salida
ImageMagick	Imgenes	245	183
FFmpeg	Vdeo / Audio	~472	~199
GraphicsMagick	Imgenes	167	130
Assimp	3D / Assets	77	23
LibreOffice	Documentos	41	22
Pandoc	Documentos	43	65
Calibre	E-books	26	19
Vips	Imgenes	45	23
libjxl	JPEG XL	11	11
VTracer	Raster a Vector	8	1
Potrace	Raster a Vector	4	11
Inkscape	Vectoriales	7	17
Markitdown	Documentos	6	1
Dasel	Archivos de datos	5	4
dvisvgm	Vectoriales	4	2

Formatos destacados: MP4, AVI, MKV, MOV, GIF, PNG, WEBP, JPEG, SVG, HEIC, PDF, EPUB, MOBI, DOCX, XLSX, PPTX, TXT, CSV, JSON, OBJ, FBX, GLTF, WAV, MP3, AAC, FLAC y cientos ms.

Primeros pasos

1. Crear la primera cuenta

Accede a http://localhost:3000
Haz clic en Register
Introduce un nombre de usuario y contrasea
Inicia sesin con tus credenciales

2. Subir y convertir un archivo

Arrastra un archivo al rea de subida o haz clic para seleccionarlo
Selecciona el formato de salida deseado
Haz clic en Convert
Descarga el archivo convertido

3. Revisar el historial

Ve a la seccin History
Consulta las conversiones anteriores con fecha y formato
Descarga nuevamente si es necesario

Configurar HTTPS con Caddy

convertx.tudominio.com { reverse_proxy localhost:3000 }

Accede de forma segura desde tu dominio con certificado SSL automtico.

Gestin y mantenimiento

Ver logs

docker compose logs -f convertx

Reiniciar contenedor

docker compose restart convertx

Detener

docker compose down

Actualizar a la ltima versin

docker compose pull docker compose up -d

Backup de datos

docker run --rm \ -v convertx-data:/app/data \ -v $(pwd):/backup \ alpine tar czf /backup/convertx-backup-$(date +%Y%m%d).tar.gz -C /app/data .

Casos de uso

Desarrollo web: Convierte imgenes a WebP o AVIF para optimizacin de pginas
Edicin de vdeo: Extrae audio de videos o convierte entre formatos
Diseo grfico: Convierte SVG a PNG o rasteriza vectores a alta resolucin
Automatizacin: Usa la API REST para integrar conversiones en pipelines
E-books: Transforma entre EPUB, MOBI, PDF y otros formatos de lectura
Modelado 3D: Convierte entre OBJ, FBX, GLTF para proyectos 3D
Documentos ofimticos: DOCX a PDF, XLSX a CSV, PPTX a imgenes
Procesamiento por lotes: Convierte cientos de imgenes o documentos masivamente

Referencias oficiales

Apoya el canal GENBYTE

Suscrbete al canal de YouTube Suscrbete a la newsletter semanal vltame un Ko-fi genbyte@proton.me

Cómo instalar ConvertX en Docker - Conversor de archivos autohospedado en Docker