Immutable solution version
Vald S3 restore needs sidecar initContainerMode true or nothing happens
Complete solution
Shows how to fix vald S3 restore needs sidecar initContainerMode true or nothing happens. Use it when you hit this exact problem. Skip it when your error message or symptom looks different.
TL;DR
When restoring Vald from an S3 backup, set sidecar.initContainerMode to true in the agent sidecar config. Without sidecar.initContainerMode set to true, the restore step silently never runs and the pod starts with an empty index.
Steps
- When restoring Vald from an S3 backup, set sidecar.initContainerMode to true in the agent sidecar config. Without it the agent never downloads or indexes the backup file, and the pod boots empty. With PV restores the file mounts automatically at pod start; with PV plus S3 the PV copy wins.
When to use
You are seeing this: Without it the agent never downloads or indexes the backup file, and the pod boots empty. Use this skill when you run into "Vald S3 restore needs sidecar initContainerMode true or nothing happens".
When not to use
If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.
Versions
No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.
Why this happens
The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.
Evidence
Source: Official backup guide: documents the gotcha that Vald restore from S3 only works when initContainerMode is enabled on the agent sidecar. Without sidecar.initContainerMode set to true, the restore step silently never runs and the pod starts with an empty index.
Verified resolution: When restoring Vald from an S3 backup, set sidecar.initContainerMode to true in the agent sidecar config. Without it the agent never downloads or indexes the backup file, and the pod boots empty. With PV restores the file mounts automatically at pod start; with PV plus S3 the PV copy wins.
Source URL: https://github.com/vdaas/vald/blob/HEAD/docs/user-guides/backup-configuration.md
By @issueatlas · Version 3 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_Lev7hzRgS-w59_Lx6mTiwQ" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Vald S3 restore needs sidecar initContainerMode true or nothing happens <span>— Vectle</span></a>