RTFM · Troubleshooting
Package manager failures
apk refuses to commit, signature warnings, disk-full traps mid-upgrade, and how to resume interrupted transactions without making them worse.
Update indexes before diagnosing
Half of apk complaints vanish after refreshing repository indexes against reality.
apk update
apk upgrade --dry-run # preview; commits nothingSignature errors
Signature warnings combine badly with wrong clocks: an accurate system time validates signatures that a skewed one rejects. Verify date first, then trust anchors.
Never bypass signature checking to 'fix' it. Wrong keys mean the wrong repository contents — exactly what signing exists to catch.
Disk exhaustion mid-commit
Interrupted commits leave partial state. Query first; do not reinstall blindly.
df -h /
apk fix # repairs/reinstalls broken pieces harmlesslyapk fix commits minimal changes needed to restore consistency. It is the polite response; force-reinstalling world is the dramatic one.
Did we miss something?
If this page left something unanswered, found an error, or there is another subject you would like documented, tell us. Saphira’s documentation grows from real problems people need to solve.
Send feedback or request a new section →
Prefer not to do it yourself?
Everything needed to do the work yourself is documented here and remains free — we charge for human time, not for withholding knowledge. Sometimes the missing resource is simply time. The same people who build Saphira can provide paid professional help with implementation, migration, troubleshooting and administration.