Saltar al contenido

Instalación

Instala el servidor en tu hosting, activa tu licencia y prepara cada PC con el instalador de Trucks-MDT.

La instalación tiene dos partes: el servidor (una sola vez, en tu hosting o VPS) y el cliente de Windows (en el PC de cada conductor y del dueño). Recibes tres archivos: el paquete del servidor, el instalador del cliente y tu archivo de licencia.

Requisitos

RequisitoDetalle
ServidorHosting con Node.js 22.5 o superior (cPanel «Setup Node.js App») o un VPS. No necesitas instalar una base de datos: usa SQLite, incluida en Node.
DominioUn dominio o subdominio con HTTPS, por ejemplo https://trucks.tuempresa.com
CorreoUna cuenta SMTP para enviar la verificación de cuentas y las invitaciones
LicenciaEl archivo license.json emitido para la IP pública de tu servidor. Dile la IP a tu proveedor antes de recibirlo.
PC de WindowsWindows 10 u 11 de 64 bits y Microsoft Edge WebView2 Runtime (viene con Windows 11 y con Edge actualizado). El instalador ya incluye .NET.
JuegoEuro Truck Simulator 2 o American Truck Simulator, instalados con Steam (o indica la carpeta a mano)

Pasos de instalación

1. Instalar el servidor

Sube y extrae trucks-mdt-hosting-….zip en tu hosting. En cPanel, abre Setup Node.js App › Create Application con estos valores:

CampoValor
Node.js version22 o superior
Application modeProduction
Application rootbackend (la carpeta donde extrajiste el paquete)
Application URLTu dominio o subdominio
Application startup filepassenger.cjs

Crea el archivo backend/.env a partir de .env.example (mira Configuración) y pulsa Run NPM Install y después Restart. Comprueba que https://tu-dominio/api/health responde {"ok":true,…}.

En un VPS Linux los pasos equivalen a:

cd /opt/trucks/backend && npm install --omit=dev
cp .env.example .env && nano .env      # completa los valores
node src/cli.js secrets                # genera SESSION_SECRET y TOKEN_PEPPER
npm start                              # o un servicio systemd / pm2, detrás de un proxy HTTPS

La base de datos se crea sola en backend/var/ al primer arranque, aplicando las migraciones de database/migrations. No hay archivos SQL que subir ni importar.

2. Crear al dueño

Una sola vez, en la terminal del servidor y dentro de la carpeta backend:

node src/cli.js init dueno@tuempresa.com "Nombre Apellido" "UnaContraseñaLarga"

Crea la empresa y la cuenta del dueño. Con esa cuenta entras a la tablet y haces el resto desde Configuración.

3. Activar la licencia

El modo empresa (flota, trabajos, finanzas y conductores) solo funciona con una licencia válida para tu servidor. Los conductores no necesitan licencia. La licencia se ata a la IP pública del servidor: si lo cambias de IP o de proveedor, pide una nueva. Instálala de una de estas dos formas:

  • En la tablet, como dueño: Configuración › Licencia › Elegir archivo de licencia… › Instalar licencia.
  • O por terminal: node src/cli.js license /ruta/license.json. Con node src/cli.js license status ves el estado.

4. Instalar el cliente de Windows

Ejecuta TrucksMDT-Setup-….exe en cada PC. Arranca como una tablet: logotipo, saludos y pantalla de bienvenida, y después el asistente de cinco pasos:

  1. Comprobación del sistema: revisa Windows de 64 bits, WebView2, que el programa esté cerrado y el espacio en disco.
  2. Acuerdo de licencia: léelo y acéptalo para continuar.
  3. Opciones: elige la carpeta, escribe la dirección del servidor de tu empresa (el botón Comprobar confirma que responde y muestra el nombre de la empresa) y decide si quieres accesos directos e inicio con Windows.
  4. Instalación: copia los archivos con una barra de progreso.
  5. Finalizar: abre el programa si quieres.

El programa se instala en %LocalAppData%\Programs\Trucks-MDT, sin archivos sueltos de la tablet: la copia sin conexión va cifrada dentro de tablet.pak. Tu configuración queda aparte, en %AppData%\TrucksMDT, y sobrevive a las actualizaciones. Para muchos PCs existe la instalación silenciosa:

TrucksMDT-Setup-….exe /S /SERVER=https://trucks.tuempresa.com

# opcionales: /D=carpeta  /NODESKTOP  /NOMENU  /RUNATLOGON

Para desinstalar: Configuración de Windows › Aplicaciones › Trucks-MDT › Desinstalar. No se borran los datos de la empresa, que están en el servidor.

5. Iniciar sesión y vincular el equipo

Abre el acceso directo e inicia sesión desde la tablet con tu cuenta. Si eres dueño verás el escritorio de empresa; si eres conductor, el de conductor. Para que el equipo envíe la telemetría del juego, vincúlalo generando un token: Configuración › Cliente ETS2 y seguridad › Generar token de instalación, o con el atajo Ctrl + Mayús + F9. No tienes que copiar ni pegar nada.

6. Preparar el juego

Con el juego cerrado, el cliente ubica la carpeta de ETS2 o ATS, instala el plugin de telemetría y activa las partidas en texto para leer el mercado de fletes. Se hace solo al abrir el cliente; si el juego estaba abierto, se omite y se reintenta la próxima vez, o puedes forzarlo en Ajustes › Preparación del juego › Preparar ahora.

Si Steam no encuentra el juego, elige la carpeta a mano en esa misma pantalla.

7. Jugar

Pulsa Jugar en la tablet para lanzar ETS2 o ATS por Steam. En cuanto el juego corra, la telemetría empieza a llegar a la tablet. Durante la partida abre la tablet con F8.

Actualizar

QuéCómo
Servidor y tabletSube y extrae el paquete nuevo encima del anterior, sin borrar backend/var/ ni backend/.env, y pulsa Restart en Node.js App. La tablet muestra un aviso de actualización a cada equipo al abrirse.
Cliente de WindowsEjecuta el instalador nuevo: actualiza encima y conserva tu configuración.

Solucionar problemas

La tablet no recibe datos

Cierra el juego por completo y pulsa Preparar ahora. Si el juego estaba abierto, el plugin no pudo actualizarse.

No encuentra el juego

Indica la carpeta de instalación en Ajustes › Preparación del juego. Debe contener bin\win_x64\eurotrucks2.exe o amtrucks.exe.

La tablet no aparece sobre el juego

Si el juego está en pantalla completa exclusiva, cámbialo a Pantalla completa sin bordes o En ventana. Comprueba también que la tecla rápida no esté ocupada por otro programa.

«Falta la licencia» o «Esta licencia es para otro servidor»

Abre Configuración › Licencia. «Otro servidor» significa que la IP pública de tu servidor no coincide con la de la licencia: pide una licencia nueva con la IP correcta. «Sin verificar» indica que el servidor no pudo consultar su propia IP: revisa su conexión a internet.

«Origen no permitido» al iniciar sesión

Abre siempre la misma dirección que pusiste en PUBLIC_URL, con https y sin cambiar de dominio.

El instalador dice que falta WebView2

Instala Microsoft Edge WebView2 Runtime y pulsa Volver a comprobar.

Próximos pasos

  • Personaliza el nombre, el logotipo y los colores en Configuración › Marca
  • Configura la tecla rápida o el botón del volante en Configuración
  • Activa la pantalla del camión si tienes PrismTextureStreamer
  • Consulta el Monitor de viaje para ver la telemetría en vivo

Preguntas frecuentes

¿Necesito conocimientos técnicos?

Para el servidor necesitas saber usar el administrador de archivos y la sección Node.js App de tu hosting, o una terminal si usas un VPS; los pasos están arriba. Para los PCs, no: ejecutas el instalador, inicias sesión y el resto se prepara solo.

¿Funciona sin internet?

La tablet puede abrir una copia local para probar la interfaz, pero para sincronizar datos con la empresa necesita conexión con el servidor.

¿Modifica mi juego?

Instala un plugin de telemetría en la carpeta de plugins del juego y cambia una opción de config.cfg, haciendo antes una copia de seguridad.

¿Puedo usar la misma licencia en dos servidores?

No. Cada licencia es para la IP pública de un servidor. Si cambias de servidor, pide una licencia nueva.