Qué necesitas

Taximeter corre en Docker sobre cualquier máquina encendida 24/7. Como los conductores y pasajeros se conectan por internet, el servidor debe ser accesible desde fuera de tu red local — lo más sencillo es un pequeño servidor en la nube (VPS) con dirección pública.

MínimoRecomendado
RAM4 GB8 GB
Disco20 GB libres40 GB libres
SistemaUbuntu 22 / Debian 12 / cualquier host DockerUn VPS pequeño
RedDirección pública que alcancen los teléfonosUn dominio + HTTPS
💡
Los teléfonos se vinculan escaneando un código QR con la URL de tu servidor, así que esa URL debe funcionar desde datos móviles — no solo en el WiFi de la oficina. Usa una IP fija o un dominio para que los QR nunca dejen de servir.

Paso 1 — Descarga Taximeter

El servidor es gratis y de código abierto (MIT). En una terminal del servidor:

git clone https://github.com/mnavas/taximeter
cd taximeter

Si no tienes Git, descarga el ZIP desde GitHub y descomprímelo en una carpeta llamada taximeter.

Paso 2 — Ejecuta el asistente

# Linux / Mac
./taximeter install

# Windows
taximeter install

El asistente te hace unas preguntas y luego hace todo automáticamente:

1

URL del servidor

Muestra una lista de direcciones. Elige la que alcanzarán conductores y pasajeros (en un servidor en la nube, la dirección pública o tu dominio). En una prueba local, http://localhost:3000.

2

Nombre de la empresa

Se muestra en el panel y en las apps. Lo puedes cambiar luego en Ajustes.

3

Correo y contraseña de administrador

Tu acceso al panel. Usa un correo real; la contraseña debe tener al menos 6 caracteres y se escribe dos veces.

Al terminar verás algo como:

✓ Taximeter is running!

  Dashboard: http://tu-servidor:3000/dashboard
  Studio:    http://tu-servidor:3001

Abre el enlace del panel e inicia sesión.

Paso 3 — Configura tu empresa

En Ajustes controlas todo:

AjusteQué hace
Datos de la empresaNombre, zona horaria, contacto.
Radio de disponibilidadQué tan cerca debe estar un taxi para contar como "cercano" (3 km por defecto).
Tiempo de solicitudCuánto dura una solicitud antes de expirar (60 s por defecto).
Cobro de esperaActívalo para cobrar el tiempo de espera y fija la velocidad bajo la cual se cobra tiempo en vez de distancia.
QR de pagoSi cada conductor muestra su propio QR, o toda la empresa usa uno.
Cuentas de pasajeroDesactivadas por defecto (se permite viajar de forma anónima). Actívalas para exigir cuenta verificada.
ℹ️
Las cuentas de pasajero se verifican por correo. Si las activas, configura SMTP — ver Administración. Una instalación anónima no necesita correo.

Paso 4 — Tarifas y tiers

En Tarifas tú defines cada monto. Taximeter trae los tiers de ejemplo Económico y SUV. Por cada tier fijas: banderazo, por km, por minuto de espera, recargo nocturno, cargo por solicitud y tarifa mínima. Más detalle en Flota y tarifas.

Paso 5 — Conductores y taxis

En Flota y Conductores registra tus vehículos (placa, modelo, color, foto, tiers que puede dar) y tus conductores (nombre, foto, licencia, teléfono y su QR de pago). Luego genera un QR de vinculación por conductor: lo escanea una vez en la app para enlazar su teléfono con tu servidor y su taxi. Ver Flota y tarifas.

Paso 6 — Prueba antes de salir en vivo

1

Revisa en el panel que tus tarifas, tiers, conductores y taxis estén bien.

2

Vincula un teléfono y pon el taxi en servicio — confirma que aparece en el Mapa en vivo con hora reciente.

3

Desde la app del pasajero pide una carrera y confirma que al conductor le llega y puede aceptarla.

ℹ️
Ya están listos: el servidor, el panel (flota, conductores, tarifas, ajustes), el mapa en vivo, la vinculación por QR y el despacho. Las apps de conductor y pasajero se están publicando, con el taxímetro y el cobro a continuación — esta guía describe el producto completo para que tu configuración esté lista.

Taximeter se reinicia solo tras un corte de luz (todos los servicios usan restart: unless-stopped). ¿Dudas de mantenimiento? Ve a Administración.