Beaker Docs
  • Welcome
  • Getting Started with Beaker
  • Joining the Social Network
  • Why use Beaker?
  • Beginner
    • Creating New Hyperdrives
    • Changing a Drive's Title or Thumbnail
    • Using the Editor
    • Detaching the Editor
    • Creating Files and Folders
    • Importing and Exporting Files
    • Sharing Hyperdrives
    • Hosting Hyperdrives
  • Intermediate
    • Your Profile Drive
    • Your Address Book
    • Your System Drive
  • Advanced
    • Webterm
    • Creating Mounts
    • Editing File Metadata
    • Forking Hyperdrives
    • Comparing and Merging Hyperdrives
  • APIs
    • beaker.capabilities
    • beaker.contacts
    • beaker.hyperdrive
    • beaker.markdown
    • beaker.peersockets
    • beaker.shell
    • beaker.terminal
  • Developers
    • Introduction to Hyperdrive
    • Index.json Manifest
    • Content-Type Negotiation
    • Frontends (.ui folder)
    • .Goto Files
  • Help
    • Hole-punchability
Powered by GitBook
On this page

Was this helpful?

  1. Help

Hole-punchability

Previous.Goto Files

Last updated 5 years ago

Was this helpful?

If your network is "not hole-punchable," you may have trouble connecting to other peers. This may be due to your network configuration.

Beaker's peer-to-peer networking relies on "hole-punching," a technique which makes your device accessible to people outside of your local network.

In some cases, hole-punching may fail. This will be indicated by Beaker in the top right:

This doesn't mean that all connections will fail, but it does mean that the odds of failed connection are higher.

Why does this happen and what can I do?

Some network routers and VPNs do not support hole-punching. If you're using a VPN, try disabling it. You may also need to try other networks.

We're working on ways to ensure connectivity even if hole-punching fails. Sorry if this is an ongoing problem for you!