Troubleshooting¶

"Connection refused" / hangs¶

• Is the host reachable? Try ping or nc -zv host port outside Voltius.
• Some networks drop ICMP — toggle Disable ping in the connection form.
• Behind a corporate proxy? SSH won't traverse HTTP proxies; you'll need a jump host or SOCKS via port forwarding.

"Host key verification failed"¶

The remote's host key changed since you last connected. Either:

• Legitimate change (rebuild, key rotation) → Known Hosts → Edit the entry.
• Suspicious → resolve out-of-band before accepting.

See Known hosts.

Vault won't unlock¶

• OS keychain — your OS user may have changed (different account, fresh install). Restore the keychain entry or re-import the vault.
• Master password — there is no recovery. If you have a sync target, restore from there.

Plugin doesn't show up¶

• Check $APP_DATA/plugins/<id>/ — index.js and manifest.json must both exist.
• Settings → Plugins → Installed → Reload to retry without restarting.
• Console shows [plugin:<id>] ... messages — open the dev console with Ctrl+Shift+I.

SFTP transfer fails partway¶

Voltius retries idempotent operations. Repeated failures usually mean:

• Disk full on the destination.
• Server side TCP RST (firewall idle timeout) — split into smaller batches.

"Permission denied" on Linux serial port¶

sudo usermod -aG dialout $USER

Log out and back in.

Logs¶

The desktop client writes logs to:

Attach the most recent log to bug reports.

Still stuck¶

• GitHub issues — bugs and feature requests.
• Discussions — questions, share-your-setup.