> For the complete documentation index, see [llms.txt](https://docs.kiloiot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kiloiot.io/kilo-docs-es/kilo-center/kilo-mioty-service-center/getting-started/configuration-basics.md).

# Conceptos básicos de configuración

Archivos de configuración y ajustes base de KiloCenter — config.docker.yaml, KC-Core, KC-Gateway, asignaciones de puertos.

### Objetivo

Comprender y verificar la configuración de tiempo de ejecución de referencia para una implementación local.

### Archivos de configuración

* `kilocenter-modules/config/config.docker.yaml` -- configuración de KC-Core (modo contenedor)
* `kilocenter-modules/KC-Core/config.yaml` -- configuración de KC-Core (modo de desarrollo desde código fuente)
* `kilocenter-modules/KC-Gateway/config.yaml` -- configuración de KC-Gateway (modo de desarrollo desde código fuente)
* `kilocenter-modules/docker-compose.yml` -- definiciones de servicios y asignaciones de puertos

### Valores predeterminados del modo contenedor

En modo contenedor, KC-Core lee `config/config.docker.yaml`. Todas las direcciones de servicio usan nombres DNS de servicios de Docker (p. ej., `postgres`, `redis`, `mosquitto`). Las variables de entorno en `.env` anulan los valores predeterminados de compose.

### Valores predeterminados del modo de desarrollo desde código fuente

`kilocenter-modules/start-dev.sh` exporta variables de entorno y detecta automáticamente el puerto de PostgreSQL:

* Si el contenedor Docker `kilocenter-postgres` está en ejecución, usa el puerto `5433`.
* De lo contrario, recurre a `5432` para un PostgreSQL local en el host.

### Configuraciones para verificar antes de probar

* **Base de datos**: host, puerto, credenciales (valor predeterminado: `localhost:5433`, usuario `kilocenter`, contraseña `cámbiame`)
* **salud de KC-Core**: puerto `8086`
* **gRPC-web de KC-Gateway**: puerto `9090`
* **salud de KC-Gateway**: puerto `8087`
* **BSSCI**: puerto `5000`, rutas de certificados TLS
* **SCACI**: puerto `5001`, rutas de certificados TLS
* **MQTT**: host, puerto y credenciales del broker

### Rutas de certificados TLS

Las rutas de certificados TLS de BSSCI y SCACI se configuran en la `protocolo` sección en `KC-Core/config.yaml` (desarrollo desde código fuente) o `config/config.docker.yaml` (contenedor):

```yaml
protocolo:
  bsci_tls:
    enabled: true
    cert_file: "certificates/server.crt"
    key_file: "certificates/server.key"
    ca_file: "certificates/ca.crt"
    min_version: "1.2"
  scaci_tls:
    enabled: true
    cert_file: "certificates/server.crt"
    key_file: "certificates/server.key"
    ca_file: "certificates/ca.crt"
    min_version: "1.3"
```

Las rutas en la configuración de desarrollo desde código fuente son relativas al directorio de trabajo de KC-Core. La configuración del contenedor usa rutas absolutas (`/app/certificates/`). Genere los certificados antes del primer inicio; consulte la instalación de Docker Compose.

### Credenciales predeterminadas

Estos valores predeterminados existen por conveniencia en el desarrollo local. Cámbielos para cualquier implementación no local:

* PostgreSQL: usuario `kilocenter`, contraseña `cámbiame`
* Broker MQTT: usuario `admin`, contraseña `KiloCenter`
* Inicio de sesión de fábrica de la estación base AVA: `ubuntu` / `123456`

### Integración MQTT

MQTT está **deshabilitado de forma predeterminada** en `KC-Core/config.yaml`:

```yaml
mqtt:
  enabled: false
  host: "localhost"
  port: 1883
  username: "admin"
  password: "KiloCenter"
```

Para habilitar MQTT, establezca `enabled: true` y reinicie KC-Core. El broker Mosquitto debe estar en ejecución (está incluido en la pila de Docker Compose). Consulte Primeros pasos con MQTT para obtener detalles de integración.

### Lista de verificación de validación

* KC-Core se inicia sin errores y `/health` responde en el puerto `8086`
* KC-Gateway se inicia y `/health` responde en el puerto `8087`
* **Modo contenedor**: KC-Web se carga en `http://localhost/`
* **Modo de desarrollo desde el código fuente**: KC-Web se carga en `http://localhost:5173`
* KC-Web puede conectarse a KC-Gateway en el puerto `9090` (las solicitudes gRPC-web se completan correctamente en la consola del navegador)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.kiloiot.io/kilo-docs-es/kilo-center/kilo-mioty-service-center/getting-started/configuration-basics.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.