ATLAS/docs/guias/instalacion.md

# Guia de Instalacion

Esta guia cubre la instalacion completa del sistema FlotillasGPS en un servidor Proxmox.

## Requisitos Previos

### Hardware (VM en Proxmox)

| Recurso | Minimo | Recomendado |
|---------|--------|-------------|
| CPU | 2 cores | 4 cores |
| RAM | 4 GB | 8 GB |
| Disco Sistema | 40 GB SSD | 60 GB SSD |
| Disco Videos | 500 GB HDD | 2 TB HDD |

### Software

- Proxmox VE 7.x o superior
- ISO Ubuntu 22.04 LTS Server

### Red

- IP estatica para la VM
- Puerto TCP 5055 accesible desde internet (para GPS)
- Dominio configurado (para Cloudflare Tunnel)
- Cuenta en Cloudflare (plan gratuito funciona)

## Paso 1: Crear VM en Proxmox

### Desde la interfaz web de Proxmox:

1. Click en "Create VM"
2. **General**:
   - Name: `flotillas-server`
   - Start at boot: Si
3. **OS**:
   - ISO image: ubuntu-22.04-live-server-amd64.iso
4. **System**:
   - BIOS: Default
   - Machine: q35
5. **Disks**:
   - Disco 1: 60 GB (SSD/local-lvm)
   - Agregar disco 2: 2 TB (HDD para videos)
6. **CPU**:
   - Cores: 4
   - Type: host
7. **Memory**:
   - Memory: 8192 MB
8. **Network**:
   - Bridge: vmbr0
   - Model: VirtIO

### Instalar Ubuntu:

1. Iniciar VM y seguir instalador
2. Configurar IP estatica o DHCP con reserva
3. Crear usuario `admin`
4. Instalar OpenSSH server
5. Reiniciar

## Paso 2: Preparar el Sistema

Conectar por SSH:

```bash
ssh admin@IP_DE_TU_VM
```

Actualizar sistema:

```bash
sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl wget
```

## Paso 3: Clonar Repositorio

```bash
cd /opt
sudo git clone https://git.consultoria-as.com/tu-usuario/flotillas-gps.git flotillas
sudo chown -R $USER:$USER /opt/flotillas
cd /opt/flotillas
```

## Paso 4: Configurar Variables

Editar el script de instalacion para configurar tu dominio:

```bash
nano deploy/scripts/install.sh
```

Modificar las variables al inicio:

```bash
DOMAIN="flotillas.tudominio.com"  # Tu dominio
ADMIN_EMAIL="admin@tudominio.com" # Email del admin
```

## Paso 5: Ejecutar Instalacion

```bash
sudo ./deploy/scripts/install.sh
```

El script realizara automaticamente:

1. Instalar PostgreSQL 15 + TimescaleDB
2. Instalar Redis
3. Instalar Python 3.11 y Node.js 20
4. Instalar Traccar Server
5. Instalar MediaMTX (video streaming)
6. Instalar Mosquitto MQTT
7. Configurar la aplicacion
8. Crear servicios systemd
9. Configurar firewall
10. Generar credenciales

**Duracion estimada: 10-15 minutos**

## Paso 6: Configurar Cloudflare Tunnel

### En el Dashboard de Cloudflare:

1. Ir a **Zero Trust** > **Access** > **Tunnels**
2. Click **Create a tunnel**
3. Nombre: `flotillas`
4. Copiar el token del tunnel

### En tu servidor:

```bash
# El instalador ya instalo cloudflared
# Configurar con tu token
sudo cloudflared service install TOKEN_QUE_COPIASTE
```

### Configurar rutas en Cloudflare:

En el dashboard del tunnel, agregar Public Hostnames:

| Subdomain | Domain | Service |
|-----------|--------|---------|
| flotillas | tudominio.com | http://localhost:3000 |
| flotillas | tudominio.com | http://localhost:8000 (path: /api/*) |
| flotillas | tudominio.com | http://localhost:8000 (path: /ws/*) |

## Paso 7: Verificar Instalacion

### Verificar servicios:

```bash
sudo systemctl status flotillas-api
sudo systemctl status flotillas-web
sudo systemctl status traccar
sudo systemctl status mediamtx
sudo systemctl status cloudflared
```

Todos deben mostrar `active (running)`.

### Verificar acceso web:

Abrir en navegador: `https://flotillas.tudominio.com`

Deberia mostrar la pagina de login.

### Verificar puerto GPS:

```bash
# Desde otra maquina
nc -zv IP_DEL_SERVIDOR 5055
```

Debe mostrar "Connection succeeded".

## Paso 8: Credenciales

Las credenciales se generaron durante la instalacion.

Ver credenciales guardadas:

```bash
cat /opt/flotillas/.credentials
```

Ejemplo de salida:

```
=================================
CREDENCIALES DE ACCESO
=================================
Dashboard: https://flotillas.tudominio.com
Admin Email: admin@flotillas.tudominio.com
Admin Password: xK9mN2pL5qR8
Database Password: [guardado en .env]
=================================
```

**IMPORTANTE**: Guarda estas credenciales en un lugar seguro y cambia la contrasena del admin despues del primer login.

## Paso 9: Configurar DNS para GPS

Los dispositivos GPS necesitan conectarse al puerto 5055 de tu servidor.

### Opcion A: IP Publica directa

Si tu servidor tiene IP publica, configura los GPS con:
- Servidor: `IP_PUBLICA`
- Puerto: `5055`

### Opcion B: Port forwarding

Si el servidor esta detras de NAT:

1. En tu router, hacer port forward del puerto 5055 TCP hacia la IP de la VM
2. Configurar GPS con tu IP publica o dominio DDNS

### Opcion C: Dominio con registro A

1. Crear registro A: `gps.tudominio.com` → IP_PUBLICA
2. Configurar GPS con:
   - Servidor: `gps.tudominio.com`
   - Puerto: `5055`

## Solucion de Problemas

### El servicio no inicia

```bash
# Ver logs detallados
journalctl -u flotillas-api -n 100 --no-pager

# Verificar configuracion
cat /opt/flotillas/.env
```

### No puedo acceder al dashboard

```bash
# Verificar tunnel
cloudflared tunnel info flotillas

# Reiniciar tunnel
sudo systemctl restart cloudflared
```

### Los GPS no se conectan

```bash
# Verificar que el puerto esta abierto
sudo ufw status
sudo netstat -tlnp | grep 5055

# Ver logs de Traccar
journalctl -u traccar -f
```

## Siguientes Pasos

1. [Configurar el sistema](configuracion.md)
2. [Agregar vehiculos y dispositivos GPS](usuario-admin.md)
3. [Configurar camaras de video](video-streaming.md)
4. [Instalar app en celulares de conductores](usuario-conductor.md)