Support

Knowledge base

Answers to the questions people actually ask, grouped the way people actually ask them.

Half the answers are one command away

Most "it doesn't work" tickets end at openvlan status. It prints your peers, whether each path is direct or relayed, and what the ACL engine did with your last connection attempt — the three facts that resolve the majority of issues below.

  • ✓Both devices show connected? Layer 1 done
  • ✓Path says "direct"? Performance issues aren't the mesh
  • ✓Blocked by ACL? The fix is policy, not networking
openvlan status — read it like this
peers14/14 online✓HEALTHY
build-01direct · 12 msokDIRECT
nas-01relayed · 61 ms⚠RELAY
db-prodacl: deny eng → prod—POLICY

The other half have an escalation ladder

When an article doesn't solve it, the next rung depends on what's on fire. Production down and enterprise plan? That's a ticket, not a forum post. A weird NAT edge case at 2am? The forum has night owls on every timezone.

where to take what
install & setupdocumented, searchablehereKB
weird networkscrowd-tested answersforumCOMMUNITY
prod downhumans, fastticketSUPPORT
found a vulnnever public—DISCLOSURE

Getting started

How many devices can I add?

Each user can enroll up to 100 devices on every plan, including the free tier.

Does OpenVLAN work behind NAT or hotel wifi?

Yes. The mesh establishes connections through NAT without port-forwarding, and falls back through relays when direct paths are blocked. Café wifi, LTE, plane wifi — all workable.

Can I run my own coordination server?

A self-hosted coordinator is available on Enterprise agreements for teams with data-residency requirements.

Which ports does OpenVLAN need open?

None inbound. Outbound 443 for coordination is enough for connectivity; UDP 41641 improves direct-path success but is optional.

Troubleshooting

Two devices can't reach each other. Where do I start?

Run openvlan status on both. Check (1) both show "connected", (2) your ACLs allow this src→dst pair, (3) the service on the far side binds to the tailnet interface, not just localhost.

DNS names don't resolve.

Make sure MagicDNS is enabled in the DNS settings and your OS is using the tailnet resolver. On Linux, set --accept-dns=true when running openvlan up.

Connections work but feel slow.

openvlan status shows "direct" or "relayed". Relayed paths add latency — usually fixable by allowing UDP 41641 outbound on the relevant firewalls.

A server rebooted and dropped off the network.

Enable the system service so it reconnects at boot: systemctl enable --now openvland.

Security

Can OpenVLAN read my traffic?

No. Traffic is encrypted end-to-end between your devices with AmneziaWG; the coordination layer only distributes public keys and ACL decisions, never payload.

How are private keys stored?

Private keys are generated and stored on each device only. They are never transmitted, not even to your tailnet's coordination server.

How do I revoke access instantly?

Disable the user in your identity provider (with SCIM) or from the admin console. Their sessions and keys stop working within seconds.

Do you support 2FA / MFA?

MFA is enforced by your identity provider during login. Because OpenVLAN authenticates against it, your IdP's MFA policy applies to network access automatically.

Billing & accounts

What happens when the trial ends?

Your tailnet stays on; only paid features (SCIM, session recording, long audit retention) pause until you pick a plan.

Can I mix free and paid users?

Plans apply to the whole tailnet. For a mixed setup, keep a free personal tailnet and a separate team tailnet.

How do I delete my account and data?

Admin console → Settings → Delete tailnet. Node metadata is purged within 30 days; device-held keys are destroyed immediately.

About the KB

How current are these articles?
Every article carries a "last verified" stamp tied to a client release. Anything older than two releases gets re-tested or flagged — and the troubleshooting sections above are re-verified with each client that changes connection behavior.
Why do some answers link to the forum?
When the honest answer is "it depends on your network," the forum thread with a dozen real-world configs beats a single-article guess. We link the thread and summarize the takeaway — the discussion stays for the edge cases.
Something here is wrong. How do I get it fixed?
Every article links to its source in the docs repo. Open a PR with the correction — typos and dead links get merged same-week, technical corrections get verified against the code first.
Can I get KB updates without checking back?
The monthly digest email lists new and substantially updated articles. Subscribe once and the KB comes to you — no drip campaign, just the digest.
Do you have articles in other languages?
The KB is English-first, but the forum hosts active threads in Japanese, German, and Portuguese where community members answer in-language. Machine-translated article mirrors exist for the top 20 articles.

Didn't find it?

Check the docs for deep dives, or reach out.