Gyblosdocs
Ayuda

Problemas

Encuentra soluciones seguras para fallos de instalación, configuración, motor y descubrimiento.

Ver Markdown

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 status

Con 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 doctor

Doctor 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 exactaSolución
Docker is not installed o Docker Compose v2 is missingInstala Docker con el plugin de Compose v2.17 o posterior siguiendo el proceso habitual de la plataforma.
Docker is not runningInicia Docker Desktop o el servicio autorizado de Docker y repite el instalador.
Docker Compose … is too oldActualiza Docker o Compose a v2.17 o posterior.

Ollama

Síntoma o salida exactaSolución
Ollama did not startRevisa docker compose logs ollama en privado; comprueba memoria, disco y estado de Docker.

Instalador

Síntoma o salida exactaSolución
The relay token is empty o must have 32 to 512 charactersCopia 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 tokenIntrodujiste 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 FAILCorrige la causa indicada y repite sh install.sh donde lo guardaste. Se conservan archivos e identidad existentes.
The image signature did not verifyNo 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.toml

Usa 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íntomaSolución
FILE_NOT_FOUND al validarUsa la ruta explícita del contenedor indicada arriba. El validador ignora GYBLOS_CONFIG al seleccionar el archivo.
TOML_SYNTAX, UNKNOWN_KEY, WRONG_TYPECorrige sintaxis, quita claves desconocidas o usa el tipo requerido. No dupliques [discovery] ni la oferta del mismo modelo.
INVALID_CAPUsa enteros positivos; la cuota por comprador no puede superar la total diaria.
INVALID_LIMITRespeta cada intervalo de capacidad y la restricción conexiones × tasa por comprador.
INLINE_SECRETQuita la credencial de TOML; usa nombre de variable y archivo privado de entorno. Rota una credencial expuesta mediante su emisor.
RELAY_ONLY_CONFLICTQuita la dirección externa o desactiva relay-only; considera también las variables que prevalecen sobre el archivo.
SELLER_SETTING_UNSUPPORTEDQuita node.data_dir, node.rpc_url o node.payout_wallet procedentes del archivo; este vendedor usa el aprovisionamiento de datos/rol existente.
SELLER_OFFERS_MISSINGRecupera 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_UNSUPPORTEDVuelve 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_UNSAFELos 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_MISSINGMantén devnet y una oferta gratuita en esta instalación; pagos/mainnet no forman parte de este inicio.

Conexión

Motor

Código / síntomaSolución
ENGINE_UNAVAILABLE, ENGINE_TIMEOUTComprueba 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 OllamaEjecuta docker compose restart seller y comprueba el estado; comparten espacio de red.

Relay

Código / síntomaSolución
SELLER_RELAY_OFFLINEComprueba internet saliente y el token de la invitación. Significa que ningún relay respondió en el plazo de inicio.
CLOCK_SKEWEDActiva 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ónSolución o interpretación
DISCOVERY_IDENTITY_NOT_REGISTEREDRepite 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_UNAVAILABLELa inscripción no se completó: lee el consejo sobre SOL faltante, simulación o resultado incierto. Sigue la guía antes de repetir.
REGISTER_CANCELLEDRespondiste algo distinto de yes o y: no se firmó ni envió nada. Vuelve a ejecutar gyblos seller register.
DISCOVERY_INVITE_INVALIDCódigo incorrecto, usado o vencido; pide otro por el canal de tu invitación.
DISCOVERY_NODE_REVOKEDContacta con Gyblos; no generes otra identidad para saltarte la retirada.
DISCOVERY_RATE_LIMITEDEspera un minuto antes de repetir el registro.
DISCOVERY_UNAVAILABLEPrueba 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ónSolución o interpretación
not in the first 2000 sellersSe agotó el límite de búsqueda; no demuestra ausencia.
index unreachableEstado 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 seller

Si 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.

En esta página