# Autoalojar el servidor de Trackio

Puedes ejecutar el panel y la API de Trackio en tu propia máquina (o en cualquier host que controles) y enviar métricas desde los scripts de entrenamiento a ese servidor a través de HTTP. Esta es una alternativa a registrar en un Hugging Face Space mediante `space_id`.

## Ejecutar el servidor localmente

Instala Trackio y luego inicia el panel de control. De forma predeterminada, escucha en `127.0.0.1` y utiliza el puerto de `GRADIO_SERVER_PORT` si está definido, de lo contrario **7860** (consulta [Iniciar el panel de control](launch)).

```sh
trackio show
```

```py
import trackio

trackio.show()
```

Deja ese proceso en ejecución mientras entrenas. La terminal imprime una URL base para la interfaz de usuario y una URL que incluye un **write token**; cualquier persona que pueda acceder a esa URL con el token puede realizar operaciones de escritura admitidas por el servidor (por ejemplo, renombrar ejecuciones), así que trátalo como un secreto en redes no confiables.

## Escuchar en todas las interfaces

Para acceder al panel de control desde otra máquina de su red (o desde contenedores), vincúlese a todas las interfaces:

```sh
trackio show --host 0.0.0.0
```

```py
import trackio

trackio.show(host="0.0.0.0")
```

Asegúrate de que tu firewall y tus políticas de seguridad permitan el tráfico que pretendes.

## Apunta el código de entrenamiento a tu servidor

En su script de entrenamiento, pase un `server_url` y proporcione el **token de escritura**: ya sea incrustando `write_token` en la cadena de consulta (la misma URL que imprime el panel para el acceso de escritura, o el valor devuelto `full_url` de `trackio.show()`), o pasando una URL base como `http://127.0.0.1:7860/` y estableciendo la variable de entorno `TRACKIO_WRITE_TOKEN` en ese token. También puede establecer `TRACKIO_WRITE_TOKEN` en el servidor de Trackio antes de lanzar `trackio.show()` para elegir el token de escritura del servidor en lugar de usar el token aleatorio generado al inicio. La ingesta de métricas y las cargas requieren este token cuando el servidor no está en Hugging Face Spaces. También puede establecer `TRACKIO_SERVER_URL` en lugar de pasar `server_url` en el código.

```py
import trackio

trackio.init(
    project="my-project",
    server_url="http://127.0.0.1:7860?write_token=YOUR_TOKEN",
)
trackio.log({"loss": 0.25})
trackio.finish()
```

Precedencia: **`space_id` / `TRACKIO_SPACE_ID` siempre tiene prioridad** sobre `server_url` / `TRACKIO_SERVER_URL` cuando ambos están definidos (en el código o en el entorno). Trackio se comporta entonces como si solo se hubiera configurado el Space.

Las opciones específicas de Hugging Face, como `dataset_id` (obsoleto; use `bucket_id` en su lugar) y `bucket_id`, solo se aplican al registrar en un Space. Cuando solo está en vigor `server_url`, configure la persistencia en la máquina donde se ejecuta el servidor (por ejemplo, mediante `TRACKIO_DIR` en ese host). Consulte [Variables de entorno](environment_variables).

## Relacionado

- [Iniciar el Dashboard](launch) — opciones de CLI, puerto y acceso remoto
- [Variables de entorno](environment_variables) — `TRACKIO_SERVER_URL`, `TRACKIO_DIR` y otras

