Problemas
Encuentra soluciones seguras para fallos de instalación, configuración, motor y descubrimiento.
Esta página corresponde al vendedor gratuito de Docker de tu invitación. Ejecuta los comandos desde
~/gyblos-seller o tu carpeta elegida. Lee el código exacto antes de cambiar nada. Conserva la identidad
y los volúmenes existentes durante el diagnóstico.
Diagnóstico
cd ~/gyblos-seller
docker compose ps
docker compose exec seller gyblos seller statusCon STARTING, espera un momento y repite. Con FAILING, lee fase, código y consejo.
Con NOT_CONFIRMED, comprueba si el contenedor está activo. Con STOPPED, inicia con
docker compose up -d --force-recreate seller. RUNNING no demuestra publicación ni una solicitud externa.
Si exec informa que el servicio está detenido o reiniciándose:
cd ~/gyblos-seller
docker compose run --rm seller gyblos doctorDoctor consulta dependencias y muestra identidad pública, códigos y consejos. Para el caso local predeterminado,
comprueba primero Ollama. Usa --online solo cuando quieras añadir consultas remotas.
Instalación
Docker
| Síntoma o salida exacta | Solución |
|---|---|
Docker is not installed o Docker Compose v2 is missing | Instala Docker con el plugin de Compose v2.17 o posterior siguiendo el proceso habitual de la plataforma. |
Docker is not running | Inicia Docker Desktop o el servicio autorizado de Docker y repite el instalador. |
Docker Compose … is too old | Actualiza Docker o Compose a v2.17 o posterior. |
Ollama
| Síntoma o salida exacta | Solución |
|---|---|
Ollama did not start | Revisa docker compose logs ollama en privado; comprueba memoria, disco y estado de Docker. |
Instalador
| Síntoma o salida exacta | Solución |
|---|---|
The relay token is empty o must have 32 to 512 characters | Copia el token de la invitación sin texto adicional. No lo muestres ni lo pegues en el chat de soporte. |
That is the gyb_ invite code, not the relay token | Introdujiste el código de invitación. Repite sh install.sh con el token de relay de la invitación; usa el código gyb_ después en Registra y publica. |
El instalador se detiene con gyblos install: o FAIL | Corrige la causa indicada y repite sh install.sh donde lo guardaste. Se conservan archivos e identidad existentes. |
The image signature did not verify | No ejecutes esa imagen ni te saltes la comprobación. Descarga de nuevo el instalador desde https://gyblos.com/install.sh e informa la línea de la imagen por el canal de tu invitación. |
Configuración
cd ~/gyblos-seller
docker compose run --rm seller gyblos config validate --config /config/gyblos.tomlUsa la ruta de clave indicada, como offers[0].free.per_buyer_cap. Tras OK, ejecuta doctor si el inicio
sigue rechazando el archivo. Consulta intervalos y valores en la referencia de configuración.
| Código / síntoma | Solución |
|---|---|
FILE_NOT_FOUND al validar | Usa la ruta explícita del contenedor indicada arriba. El validador ignora GYBLOS_CONFIG al seleccionar el archivo. |
TOML_SYNTAX, UNKNOWN_KEY, WRONG_TYPE | Corrige sintaxis, quita claves desconocidas o usa el tipo requerido. No dupliques [discovery] ni la oferta del mismo modelo. |
INVALID_CAP | Usa enteros positivos; la cuota por comprador no puede superar la total diaria. |
INVALID_LIMIT | Respeta cada intervalo de capacidad y la restricción conexiones × tasa por comprador. |
INLINE_SECRET | Quita la credencial de TOML; usa nombre de variable y archivo privado de entorno. Rota una credencial expuesta mediante su emisor. |
RELAY_ONLY_CONFLICT | Quita la dirección externa o desactiva relay-only; considera también las variables que prevalecen sobre el archivo. |
SELLER_SETTING_UNSUPPORTED | Quita node.data_dir, node.rpc_url o node.payout_wallet procedentes del archivo; este vendedor usa el aprovisionamiento de datos/rol existente. |
SELLER_OFFERS_MISSING | Recupera al menos una oferta admitida. Una lista vacía válida para el esquema no puede servir. |
SELLER_OFFER_MODEL_UNSUPPORTED, SELLER_OFFER_ENGINE_UNSUPPORTED, SELLER_OFFER_REASONING_UNSUPPORTED | Vuelve a la oferta local admitida de Qwen3 con razonamiento off o revisa las restricciones antes de usar un motor avanzado. |
SELLER_OFFER_API_KEY_MISSING, SELLER_OFFER_API_KEY_UNSAFE | Los proveedores avanzados necesitan la variable correcta no vacía dentro del contenedor; usa un nombre distinto que no empiece por GYBLOS_ ni nombre el token de relay. |
MAINNET_UNSUPPORTED, SELLER_PAYMENT_ROLE_MISSING | Mantén devnet y una oferta gratuita en esta instalación; pagos/mainnet no forman parte de este inicio. |
Conexión
Motor
| Código / síntoma | Solución |
|---|---|
ENGINE_UNAVAILABLE, ENGINE_TIMEOUT | Comprueba Ollama y que qwen3:0.6b esté descargado. Revisa sus logs en privado. Conserva la URL de loopback suministrada. |
| El vendedor falla después de reiniciarse Ollama | Ejecuta docker compose restart seller y comprueba el estado; comparten espacio de red. |
Relay
| Código / síntoma | Solución |
|---|---|
SELLER_RELAY_OFFLINE | Comprueba internet saliente y el token de la invitación. Significa que ningún relay respondió en el plazo de inicio. |
CLOCK_SKEWED | Activa sincronización horaria automática en el anfitrión; los registros fechados en el futuro pueden rechazarse. |
Si solo necesitas reemplazar el token de relay, detén el vendedor, abre seller.env en un editor local
privado y cambia solo el valor del token por el correcto de tu invitación. Conserva las credenciales de proveedores.
Recrea con docker compose up -d --force-recreate seller para cargar el entorno cambiado. Nunca muestres
el archivo, pongas su contenido en una línea de comando ni borres el volumen de datos.
Publicación
Registro
| Código de descubrimiento / observación | Solución o interpretación |
|---|---|
DISCOVERY_IDENTITY_NOT_REGISTERED | Repite en terminal interactiva para la inscripción devnet. Revisa primero el coste y la aprobación en la guía de registro; owner necesita SOL de devnet. Conserva la invitación, que puede vencer. |
REGISTER_IDENTITY_UNAVAILABLE | La inscripción no se completó: lee el consejo sobre SOL faltante, simulación o resultado incierto. Sigue la guía antes de repetir. |
REGISTER_CANCELLED | Respondiste algo distinto de yes o y: no se firmó ni envió nada. Vuelve a ejecutar gyblos seller register. |
DISCOVERY_INVITE_INVALID | Código incorrecto, usado o vencido; pide otro por el canal de tu invitación. |
DISCOVERY_NODE_REVOKED | Contacta con Gyblos; no generes otra identidad para saltarte la retirada. |
DISCOVERY_RATE_LIMITED | Espera un minuto antes de repetir el registro. |
DISCOVERY_UNAVAILABLE | Prueba más tarde o contacta con Gyblos. Comprueba el origen del índice antes de enviar una invitación. |
Repetir el registro comprueba el estado guardado y puede reenviar la misma transacción ya aprobada sin otra pregunta. Conserva archivos y bloqueos. El vencimiento por sí solo no demuestra ausencia de transacción o comisión; un estado parcial/inconcluso necesita ayuda. Lee los límites de recuperación del registro antes de repetir. Nunca borres estado para forzar otro intento.
Visibilidad
Sigue Registra y publica: confirma registro, publish = true, recreación
tras el cambio y después seller status --online. Comprueba que consultas el índice donde te registraste
y que al menos una oferta esté lista.
| Código de descubrimiento / observación | Solución o interpretación |
|---|---|
not in the first 2000 sellers | Se agotó el límite de búsqueda; no demuestra ausencia. |
index unreachable | Estado de publicación desconocido; resuelve conectividad antes de sacar conclusiones. |
Solicitudes
La oferta reserva entrada más salida máxima en la admisión. Una solicitud puede superar el saldo diario o por comprador aunque queden tokens. La capacidad y el límite de compradores distintos también pueden rechazar solicitudes. Revisa Modelos y ofertas; no reinicies para saltarte cuotas. Una publicación no genera demanda por sí sola y el resumen de recibos de 24 horas no es un saldo de cuotas.
Identidad y recuperación
Conserva el volumen y pide ayuda. No borres bloqueos de secuencia, journals, archivos de rol ni llaves para
superar comprobaciones. No repitas setup en otro directorio de datos ni uses docker compose down -v.
Aquí no se documenta una restauración completa; consulta Identidad y datos privados.
Pide ayuda
Responde por el canal de tu invitación con el código relevante y estas salidas:
cd ~/gyblos-seller
docker compose exec seller gyblos seller status
docker compose images sellerSi exec no está disponible, comparte el código relevante de doctor. Revisa la salida antes de enviarla.
No envíes seller.env, códigos de invitación, logs completos, volcados del entorno, docker inspect, recibos ni volúmenes.