---
doc_id: doc:netbox:index
title: NetBox
project: netbox
area: overview
kind: index
lang: es
visibility: public
tags:
  - project:netbox
  - area:overview
---

# NetBox

`NetBox` es la fuente de verdad de inventario para redes e infraestructura de `iort`: sitios, regiones, clusters, máquinas virtuales, IPs, prefijos, tags y metadatos operativos.

Este directorio es el espacio propio del proyecto `netbox/` dentro del workspace. Aquí vive la configuración operativa y de uso de NetBox como producto. No es el código de despliegue.

## Qué vive aquí

- `.env`: variables locales y operativas del proyecto NetBox.
- `.env.example`: plantilla sin secretos.
- [Manual de uso](manual-de-uso.md): guía de uso en español para técnicos, desarrolladores e ingenieros robóticos.
- [Cómo documentar y mantener sistemas en NetBox](como-documentar-en-netbox.md): playbook operativo para crear y editar inventario, pensado también para LLMs.

## Qué no vive aquí

- el stack Pulumi de despliegue;
- templates de systemd/nginx;
- bootstrap del VPS;
- documentación técnica del despliegue.

Eso vive en:

- `../infra/netbox/README.md`
- `../docs/netbox/bootstrap.md`
- `../docs/netbox/deploy.md`
- `../docs/netbox/mcp-access.md`
- `../docs/netbox/information-model.md`

## Estado actual

El NetBox operativo de `iort` está desplegado en `iort-netbox` y publicado solo por Tailscale.

Puntos de acceso actuales:

- UI/API privada: `https://iort-netbox.tailf75db9.ts.net`
- MCP privado: `https://iort-netbox.tailf75db9.ts.net/mcp`
- Chat privado con LibreChat: `https://iort-netbox.tailf75db9.ts.net/chat`

## Convención

- usa este directorio para lo específico de la operación y el consumo de NetBox;
- usa `../infra/netbox/` para IaC y despliegue;
- usa `../docs/netbox/` para runbooks y modelado.

## Empieza por aquí

Si vas a usar NetBox como técnico, desarrollador o ingeniero robótico, empieza por:

- [Manual de uso](manual-de-uso.md)
- [Cómo documentar y mantener sistemas en NetBox](como-documentar-en-netbox.md)

Si vas a tocar despliegue, secretos o bootstrap, ve después a:

- `../infra/netbox/README.md`
- `../docs/netbox/`

## Variables esperadas

El `.env` de este directorio está pensado para reunir:

- URLs privadas de NetBox, MCP y chat;
- nombres de site, región, cluster y VM de referencia;
- prefijo de secretos en Google Secret Manager;
- credenciales operativas de uso humano o de scripts locales.

No pongas aquí secretos globales de infraestructura ajenos a NetBox.