[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"problem-detail-warning-nuxt-app-restarts-because-its-users-file-cannot":3},{"stack":4,"error":5,"seoName":6,"seoStack":7,"seo":8,"breadcrumb":10,"titlePrefix":17,"titleAccent":18,"lead":19,"facts":22,"why":37,"log":51,"fix":84,"engine":108,"related":116,"pitch":124},"nuxt","nuxt-app-restarts-because-its-users-file-cannot","Nuxt app restarts because its users file cannot be initialized","Nuxt",{"description":9},"The application started but did not answer on any port it publishes. The deploy log has the per-port result; a worker or queue-only app can ignore this. | The a",[11,14,16],{"label":12,"href":13},"App Installations","\u002Fapps",{"label":7,"href":15},"\u002Fapps\u002Fstacks\u002Fnuxt",{"label":6},"Nuxt app restarts because ","its users file cannot be initialized",[20],{"text":21},"The application started but did not answer on any port it publishes. The deploy log has the per-port result; a worker or queue-only app can ignore this. | The application is restarting, not running. Docker reports app (Restarting (1) 28 seconds ago). Nothing answered on any published port because the process keeps exiting. Read the container output with container_service_logs; the reason it exits is there.",[23,28,31,33],{"label":24,"value":25,"tone":26,"tooltip":27},"Type","Warning","warn","An issue PanelAlpha Engine catches around a deploy that does not break it. It tells you, before or after, that you may need to do something.",{"label":29,"value":30},"Seen","1 times",{"label":32,"value":7},"Where",{"label":34,"value":35,"tooltip":36},"Status","Observed","Our team will look into this soon, verify the cause and try to fix it in an upcoming release.",{"heading":38,"body":39},"Why it happens",[40,42,45,47,49],{"text":41},"The Nuxt build completes, but the application exits during startup and enters a restart loop. It cannot find the example users file at ",{"text":43,"code":44},"\u002Fapp\u002F.examples\u002Fusers.json",true,{"text":46},", so it cannot create ",{"text":48,"code":44},"\u002Ftmp\u002F.clyo\u002Fusers.json",{"text":50},". The health check then fails because nothing remains listening on port 3000.",{"heading":52,"block":53},"What the log looks like",{"header":54,"lines":55},"Deploy log",[56,60,64,68,72,76,80],{"segments":57},[58],{"text":59},"Application compiled",{"segments":61},[62],{"text":63},"Starting application (docker compose up -d)",{"segments":65},[66],{"text":67},"Health check: http:\u002F\u002F[ip]:3000\u002F did not answer — Failed to connect to [ip] port 3000",{"segments":69},[70],{"text":71},"app-1  | Users file not found, copying example file...",{"segments":73},[74],{"text":75},"app-1  | Source example file does not exist: \u002Fapp\u002F.examples\u002Fusers.json",{"segments":77},[78],{"text":79},"app-1  | Fatal: Users file could not be initialized at \u002Ftmp\u002F.clyo\u002Fusers.json",{"segments":81},[82],{"text":83},"app-1  | ...container restarting...",{"heading":85,"steps":86,"block":105},"How to fix it",[87],[88,90,92,94,95,97,99,101,103],{"text":89},"Ensure ",{"text":91,"code":44},".examples\u002Fusers.json",{"text":93}," is included in the deployed image and available at ",{"text":43,"code":44},{"text":96},", or configure the application with a valid existing users-file path. If ",{"text":98,"code":44},"\u002Ftmp\u002F.clyo",{"text":100}," is intended to persist, mount durable storage and initialize ",{"text":102,"code":44},"users.json",{"text":104}," before restarting the app. Review the container logs after redeploying; the missing JWT secret is a separate warning, not the reported startup failure.",{"header":106,"lines":107},"Fix by hand",[],{"heading":109,"body":110,"block":113},"How PanelAlpha Engine solves it",[111],{"text":112},"For Nuxt deployments, Engine could surface the container's fatal startup line as the primary failure and distinguish it from the generic health-unknown result. It could also warn when required runtime files referenced by startup scripts are absent from the built image.",{"header":114,"lines":115},"",[],{"heading":117,"items":118},"Apps affected",[119],{"title":120,"badge":121,"tone":122,"href":123},"sink","1 occurrence","err","\u002Fapps\u002Fmiantiao-me\u002Fsink",{"heading":125,"body":126,"footNote":127,"docsLabel":128,"docsHref":129},"Try PanelAlpha Engine yourself.","The easiest way to turn your server into a safe, controlled environment for your AI agent. Deploy, manage and maintain any project from Claude Code, Cursor, Codex or any other MCP client. Open source under Apache 2.0, free to run.","Requires Ubuntu 24.04 or 26.04 · 2 GB RAM · 1 CPU","Read the documentation","https:\u002F\u002Fpanelalpha.com\u002Fdocs"]