cómo instalar ConvertX en Docker - Convertidor de archivos autohospedado en Docker

ConvertX | File Converter | Docker

ConvertX: Convertidor de archivos autohospedado para 1000+ formatos en Docker

Convierte cualquier archivo a otro formato. Imágenes, documentos, vídeo, audio, 3D, vectores. Sin dependencias en la nube, datos en tu servidor, interfaz moderna.

¿Qué es ConvertX?

ConvertX es un convertidor de archivos open source autohospedado que soporta más de 1000 formatos diferentes. A diferencia de servicios online (Cloudconvert, Zamzar, Online-convert) que suben tus archivos a sus servidores, ConvertX procesa todo localmente en tu servidor sin enviar datos a terceros.

Compatible con todo: Imágenes (JPG, PNG, SVG, WEBP), documentos (PDF, Word, Excel, Markdown), vídeo (MP4, WebM, AVI), audio (MP3, WAV, FLAC), 3D (GLTF, STL, FBX), vectores (DXF, AI) y mucho más. Construido con TypeScript, Bun y Elysia. Interfaz web moderna con autenticación, historial, y soporte multi-usuario.

Privacidad garantizada: Los archivos se procesan en tu servidor. Nadie más tiene acceso. Control total sobre datos sensibles, documentos confidenciales, proyectos privados.

Características principales

1000+ formatos soportados

Imágenes, documentos, vídeo, audio, 3D, vectores y más.

Interfaz web moderna

UI intuitiva, responsive, arrastra y suelta archivos.

Sistema de cuentas

Autenticación JWT, múltiples usuarios, historial privado.

Historial de conversiones

Guarda historial de conversiones realizadas.

Conversiones por lotes

Convierte múltiples archivos a la vez.

Soporte FFmpeg

~472 formatos de vídeo y audio via FFmpeg.

ImageMagick e GraphicsMagick

245+ conversiones de imágenes con ImageMagick.

Pandoc para documentos

43+ formatos de documentos (Markdown, Word, PDF, etc).

Assimp para 3D

77+ formatos 3D (GLTF, FBX, STL, OBJ, etc).

Raster a vector

Potrace y VTracer para vectorizar imágenes.

Conversión de emails

Outlook MSG a EML y VCF a CSV.

Open Source

Código abierto, MIT License, auditoria transparente.

Formatos soportados

Imágenes (245+ formatos)

JPG, PNG, WEBP, GIF, TIFF, BMP, SVG, EPS, ICO, HEIC, AVIF, y más

Documentos (43+ formatos)

PDF, Word (DOC/DOCX), Excel (XLS/XLSX), PowerPoint (PPT), Markdown, TXT, RTF, ODT, EPUB, y más

Vídeo (~472 formatos)

MP4, WebM, AVI, MKV, MOV, FLV, WMV, ASF, 3GP, y más

Audio (~199 formatos)

MP3, WAV, FLAC, OGG, AAC, M4A, WMA, OPUS, y más

3D (77+ formatos)

GLTF, FBX, STL, OBJ, DAE, BLEND, 3DS, Collada, y más

Vectores

SVG, DXF, AI, EPS, PDF (como vector)

Requisitos del sistema

• Docker instalado
• 2+ GB de RAM mínimo para conversiones concurrentes
• 10+ GB de espacio en disco para caché y procesamiento
• Puerto 3000 disponible
• CPU: Más rápido con multi-core (aceleración en FFmpeg)
• Opcional: GPU para aceleración de vídeo

Nota importante: La imagen Docker es bastante grande (~2 GB) porque incluye todos los converters (FFmpeg, ImageMagick, Pandoc, etc). Primera descarga puede tomar tiempo.

Instalación con Docker

Opción 1: Docker Run (30 segundos)

docker run -d \ --name convertx \ -p 3000:3000 \ -v ./convertx-data:/app/data \ ghcr.io/c4illin/convertx:latest

Opción 2: Docker Compose (recomendado)

version: '3.8' services: convertx: image: ghcr.io/c4illin/convertx:latest container_name: convertx restart: unless-stopped ports: - "3000:3000" volumes: - ./convertx-data:/app/data environment: - JWT_SECRET=una-cadena-larga-y-secreta-muy-segura-1234567890 - ACCOUNT_REGISTRATION=false - ALLOW_UNAUTHENTICATED=false volumes: convertx-data:

Iniciar

docker compose up -d

Acceder

Abre http://localhost:3000 en tu navegador. Se mostrará pantalla de login. Crea tu primer usuario.

Nota de seguridad: No dejes ConvertX configurado sin cuidado. Siempre requiere login (ALLOW_UNAUTHENTICATED=false) cuando accedes desde HTTP (no localhost).

Configuración y variables de entorno

Variables principales

JWT_SECRET=tu-cadena-secreta-larga # Para firmar tokens (muy importante) ACCOUNT_REGISTRATION=false # false = solo admin crea usuarios ALLOW_UNAUTHENTICATED=false # false = requiere login siempre HTTP_ALLOWED=false # false = solo HTTPS o localhost HIDE_HISTORY=false # Oculta página de historial si true

Configuración FFmpeg (aceleración de vídeo)

FFMPEG_INPUT_ARGS=-hwaccel vaapi # Aceleración de hardware FFMPEG_OUTPUT_ARGS=-preset veryfast # Preset de velocidad

Limitaciones de procesamiento

MAX_CONVERT_PROCESS=4 # Máximo 4 conversiones simultáneas (0 = sin límite)

Primeros pasos

1. Crear primer usuario (administrador)

1. Abre http://localhost:3000
2. Click en "Sign up" o "Register"
3. El primer usuario registrado se convierte automáticamente en admin
4. Completa el formulario y crea cuenta

2. Convertir tu primer archivo

1. Login con tu cuenta de admin
2. Haz click en "Convert" o arrastra archivo
3. Selecciona el archivo a convertir
4. Elige formato de destino
5. Click "Convert"
6. Descarga el archivo convertido

3. Crear usuarios adicionales

1. Si ACCOUNT_REGISTRATION=false, solo admin puede crear usuarios
2. Ve a Settings → Users (si tienes acceso admin)
3. Crea nuevo usuario con email y contraseña
4. El usuario puede verlo en su historial privado

4. Explorar historial

1. Click en "History"
2. Ves todas tus conversiones anteriores
3. Puedes descargar conversiones anteriores sin repetir
4. Opción para eliminar registros si HIDE_HISTORY=false

Casos de uso

• Conversión masiva: Convierte 100+ imágenes a WEBP para web
• Procesamiento de vídeos: Comprime vídeos, cambia codec, bitrate
• Edición de documentos: PDF a Word, Markdown a PDF, EPUB a PDF
• Trabajo con 3D: GLTF a FBX, STL para impresión 3D
• Datos sensibles: Convierte documentos confidenciales sin subir a Internet
• Serverless/API: Usa ConvertX como backend de conversión para otras apps
• Automatización: Scripts que convierten automáticamente archivos entrantes

HTTPS con Caddy (acceso remoto seguro)

Configuración Caddyfile

convertx.tudominio.com { reverse_proxy localhost:3000 }

Importante: Habilitar HTTP para HTTPS

Si accedes via HTTPS (con Caddy), debes dejar HTTP_ALLOWED=false (valor por defecto). ConvertX automáticamente detectará HTTPS y permitirá login.

Acceso remoto seguro

1. Configura Caddy con tu dominio
2. HTTPS se habilita automáticamente con Let's Encrypt
3. Accede desde cualquier lugar: https://convertx.tudominio.com
4. Login y usa normalmente

Gestión y mantenimiento

Ver logs

docker compose logs -f convertx

Entrar al contenedor

docker exec -it convertx bash

Arreglar permisos de archivos

sudo chown -R $USER:$USER ./convertx-data

Limpiar caché de conversiones antiguas

docker exec convertx rm -rf /app/data/cache/*

Backup de configuración y historial

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

Actualizar a la última versión

docker compose pull docker compose up -d

Reiniciar servicio

docker compose restart convertx

---

Referencias oficiales

• ConvertX - GitHub Repository
• ConvertX - Docker Hub
• ConvertX - GitHub Container Registry
• Releases - Historial de versiones
• Issues - Reportar bugs o solicitar formatos

Apoya el canal GENBYTE

Suscríbete al canal de YouTube Suscríbete a la newsletter semanal Invítame a un Ko-fi genbyte@proton.me

Sígueme en mis redes sociales

Telegram Discord YouTube GitHub Blog Twitter