5 ms·

> but I believe Wireguard is held back by its lack of documentation. Indeed having good documentation is super important. I'm not so arrogant as to proclaim, "

by zx2c4 8y ago

> but I believe Wireguard is held back by its lack of documentation. Indeed having good documentation is super important. I'm not so arrogant as to proclaim, "I don't have time to write docs! Understand it yourself!", but I am stretched super thin, and I suspect that often times documentation from somebody who _isn't_ the creator winds up being a bit better, because exterior perspectives are useful. So it's my hope that somebody can chip in and help out writing tutorials and docs and walkthroughs and whatnot. We really do need it. From the sound of your message, though, I wonder if maybe you haven't found the man pages (primary documentation source): https://git.zx2c4.com/WireGuard/about/src/tools/man/wg.8 https://git.zx2c4.com/WireGuard/about/src/tools/man/wg.8 https://git.zx2c4.com/WireGuard/about/src/tools/man/wg-quick.8 https://git.zx2c4.com/WireGuard/about/src/tools/man/wg-quick...

StavrosK 8y ago
I had, indeed, not found the man pages, thank you. I also intend to write up how to deploy Wireguard with a simple "access the home LAN from the outside" configuration in the next few days, which will hopefully be useful to people.
- lighttower 8y ago
  Please do! And can you come back to this thread and let us know?
  - StavrosK 8y ago
    I'll make a new post here, I'm guessing a few people will want to know.
    - cbluth 8y ago
      Yes, we'd all love to see it when you're done.
      - StavrosK 8y ago
        If you don't want to wait, I posted the configuration in a sibling comment. It's pretty much that, along with some more details on how to add it and run it.
- harshreality 8y ago
  If you want to document "How I access my home network remotely" but you're really spending a few paragraphs repeating the wireguard docs before moving on to other things like your choice of IPs, your logging setup, how to retrieve mail, how to ssh places, and stuff like that, please realize that none of that other stuff has anything to do with wireguard. You could just as easily be documenting those things with an OpenVPN or IPsec vpn or even an unencrypted tunnel. That's why those things are not in the wireguard docs. If there's something that involves wireguard itself that's missing from or unclear in the docs, could you please clarify?
  - StavrosK 8y ago
    > none of that other stuff has anything to do with wireguard Sure, none of it is specific to Wireguard, but my personal use case was "hey, Wireguard looks cool, maybe I could use it to access my home LAN when I'm away. Hmm, how do I talk to the other machines from the VPN server?". It's like saying "if you want to bake a cake, none of the baking has anything to do with our flour". You're technically right, but it'll benefit you to put a recipe on the box.
    - harshreality 8y ago
      "How do I talk to the other machines from the vpn server" The same way you would if everything on your side of the VPN tunnel was on the other side of the VPN tunnel, there was no VPN, and the VPN server was just a router joining the two subnets.
      - StavrosK 8y ago
        "I don't know how to do that, oh well, too bad, Wireguard would have been nice"

by zx2c4 8y ago

StavrosK 8y ago

I had, indeed, not found the man pages, thank you. I also intend to write up how to deploy Wireguard with a simple "access the home LAN from the outside" configuration in the next few days, which will hopefully be useful to people.

lighttower 8y ago
Please do! And can you come back to this thread and let us know?
- StavrosK 8y ago
  I'll make a new post here, I'm guessing a few people will want to know.
  - cbluth 8y ago
    Yes, we'd all love to see it when you're done.
    - StavrosK 8y ago
      If you don't want to wait, I posted the configuration in a sibling comment. It's pretty much that, along with some more details on how to add it and run it.
harshreality 8y ago
If you want to document "How I access my home network remotely" but you're really spending a few paragraphs repeating the wireguard docs before moving on to other things like your choice of IPs, your logging setup, how to retrieve mail, how to ssh places, and stuff like that, please realize that none of that other stuff has anything to do with wireguard. You could just as easily be documenting those things with an OpenVPN or IPsec vpn or even an unencrypted tunnel. That's why those things are not in the wireguard docs. If there's something that involves wireguard itself that's missing from or unclear in the docs, could you please clarify?
- StavrosK 8y ago
  > none of that other stuff has anything to do with wireguard Sure, none of it is specific to Wireguard, but my personal use case was "hey, Wireguard looks cool, maybe I could use it to access my home LAN when I'm away. Hmm, how do I talk to the other machines from the VPN server?". It's like saying "if you want to bake a cake, none of the baking has anything to do with our flour". You're technically right, but it'll benefit you to put a recipe on the box.
  - harshreality 8y ago
    "How do I talk to the other machines from the vpn server" The same way you would if everything on your side of the VPN tunnel was on the other side of the VPN tunnel, there was no VPN, and the VPN server was just a router joining the two subnets.
    - StavrosK 8y ago
      "I don't know how to do that, oh well, too bad, Wireguard would have been nice"