Skip to content

docs: add Windows Docker TTS-ASR troubleshooting guide - #620

Draft
ChuChenlyc wants to merge 1 commit into
duixcom:mainfrom
ChuChenlyc:agent/windows-docker-troubleshooting
Draft

docs: add Windows Docker TTS-ASR troubleshooting guide#620
ChuChenlyc wants to merge 1 commit into
duixcom:mainfrom
ChuChenlyc:agent/windows-docker-troubleshooting

Conversation

@ChuChenlyc

Copy link
Copy Markdown

Summary

  • Add a Windows Docker troubleshooting guide for TTS/ASR connection failures.
  • Document the expected ASR hostname and the network alias required when local Compose service names are customized.
  • Document a validation sequence for Compose YAML, container readiness, DNS, TCP, WebSocket, bind mounts, and the preprocess API.
  • Explain why the SQLite binding error is a secondary symptom of failed training.

Root cause

The TTS image connects to FunASR at duix-avatar-asr:10095. A local Compose file that renames the ASR service to heygem-asr without adding the duix-avatar-asr network alias causes the WebSocket connection to fail. The resulting NoneType send error is later followed by a misleading SQLite binding error when the client persists an invalid voice ID.

The guide also covers the Windows host-path versus container-path distinction that can produce file not exists errors.

Validation

Closes #619

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Documentation] Windows Docker troubleshooting for TTS-ASR connection failures

1 participant