Skip to content

fix(examples): pin HOME so plugin caches resolve under appuser#1522

Closed
u9g wants to merge 1 commit into
mainfrom
jl/dockerfile-example-home-env
Closed

fix(examples): pin HOME so plugin caches resolve under appuser#1522
u9g wants to merge 1 commit into
mainfrom
jl/dockerfile-example-home-env

Conversation

@u9g
Copy link
Copy Markdown
Contributor

@u9g u9g commented May 17, 2026

Summary

  • Docker's USER directive switches UID/GID but doesn't set $HOME from /etc/passwd, so plugin asset caches under $HOME/.cache (Silero VAD, the LiveKit turn detector, HuggingFace, etc.) land in /root instead of /app and the worker can't find them at startup.
  • Pinning ENV HOME="/app" makes the cache path deterministic for appuser.
  • This is the upstream version of a fix carried in the agent-starter-node template (livekit-examples/agent-starter-node#46).

Test plan

  • Build the example image and confirm download-files writes under /app/.cache/....
  • Deploy to LiveKit Cloud and confirm the worker boots without re-downloading plugin assets.

🤖 Generated with Claude Code

Docker's USER directive switches UID/GID but doesn't set $HOME from
/etc/passwd, so plugin asset caches under $HOME/.cache landed in /root
instead of /app and the worker couldn't find them at startup.
@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented May 17, 2026

⚠️ No Changeset found

Latest commit: f192310

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Copy link
Copy Markdown
Contributor

@devin-ai-integration devin-ai-integration Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 1 additional finding.

Open in Devin Review

@u9g u9g closed this May 17, 2026
@u9g u9g deleted the jl/dockerfile-example-home-env branch May 17, 2026 01:43
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.

1 participant