usage.html 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492
  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta charset="utf-8" />
  5. <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  6. <meta name="viewport" content="width=device-width,initial-scale=1">
  7. <meta http-equiv="x-ua-compatible" content="ie=edge">
  8. <meta name="lang:clipboard.copy" content="Copy to clipboard">
  9. <meta name="lang:clipboard.copied" content="Copied to clipboard">
  10. <meta name="lang:search.language" content="en">
  11. <meta name="lang:search.pipeline.stopwords" content="True">
  12. <meta name="lang:search.pipeline.trimmer" content="True">
  13. <meta name="lang:search.result.none" content="No matching documents">
  14. <meta name="lang:search.result.one" content="1 matching document">
  15. <meta name="lang:search.result.other" content="# matching documents">
  16. <meta name="lang:search.tokenizer" content="[\s\-]+">
  17. <link href="https://fonts.gstatic.com/" rel="preconnect" crossorigin>
  18. <link href="https://fonts.googleapis.com/css?family=Roboto+Mono:400,500,700|Roboto:300,400,400i,700&display=fallback" rel="stylesheet">
  19. <style>
  20. body,
  21. input {
  22. font-family: "Roboto", "Helvetica Neue", Helvetica, Arial, sans-serif
  23. }
  24. code,
  25. kbd,
  26. pre {
  27. font-family: "Roboto Mono", "Courier New", Courier, monospace
  28. }
  29. </style>
  30. <link rel="stylesheet" href="_static/stylesheets/application.css"/>
  31. <link rel="stylesheet" href="_static/stylesheets/application-palette.css"/>
  32. <link rel="stylesheet" href="_static/stylesheets/application-fixes.css"/>
  33. <link rel="stylesheet" href="_static/fonts/material-icons.css"/>
  34. <meta name="theme-color" content="#3f51b5">
  35. <script src="_static/javascripts/modernizr.js"></script>
  36. <title>External Guides &#8212; Netmaker 0.10.0 documentation</title>
  37. <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
  38. <link rel="stylesheet" type="text/css" href="_static/material.css" />
  39. <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
  40. <script src="_static/jquery.js"></script>
  41. <script src="_static/underscore.js"></script>
  42. <script src="_static/doctools.js"></script>
  43. <link rel="author" title="About these documents" href="about.html" />
  44. <link rel="index" title="Index" href="genindex.html" />
  45. <link rel="search" title="Search" href="search.html" />
  46. <link rel="next" title="UI Reference" href="ui-reference.html" />
  47. <link rel="prev" title="Integrating OAuth" href="oauth.html" />
  48. </head>
  49. <body dir=ltr
  50. data-md-color-primary=indigo data-md-color-accent=light-blue>
  51. <svg class="md-svg">
  52. <defs data-children-count="0">
  53. <svg xmlns="http://www.w3.org/2000/svg" width="416" height="448" viewBox="0 0 416 448" id="__github"><path fill="currentColor" d="M160 304q0 10-3.125 20.5t-10.75 19T128 352t-18.125-8.5-10.75-19T96 304t3.125-20.5 10.75-19T128 256t18.125 8.5 10.75 19T160 304zm160 0q0 10-3.125 20.5t-10.75 19T288 352t-18.125-8.5-10.75-19T256 304t3.125-20.5 10.75-19T288 256t18.125 8.5 10.75 19T320 304zm40 0q0-30-17.25-51T296 232q-10.25 0-48.75 5.25Q229.5 240 208 240t-39.25-2.75Q130.75 232 120 232q-29.5 0-46.75 21T56 304q0 22 8 38.375t20.25 25.75 30.5 15 35 7.375 37.25 1.75h42q20.5 0 37.25-1.75t35-7.375 30.5-15 20.25-25.75T360 304zm56-44q0 51.75-15.25 82.75-9.5 19.25-26.375 33.25t-35.25 21.5-42.5 11.875-42.875 5.5T212 416q-19.5 0-35.5-.75t-36.875-3.125-38.125-7.5-34.25-12.875T37 371.5t-21.5-28.75Q0 312 0 260q0-59.25 34-99-6.75-20.5-6.75-42.5 0-29 12.75-54.5 27 0 47.5 9.875t47.25 30.875Q171.5 96 212 96q37 0 70 8 26.25-20.5 46.75-30.25T376 64q12.75 25.5 12.75 54.5 0 21.75-6.75 42 34 40 34 99.5z"/></svg>
  54. </defs>
  55. </svg>
  56. <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer">
  57. <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search">
  58. <label class="md-overlay" data-md-component="overlay" for="__drawer"></label>
  59. <a href="#usage" tabindex="1" class="md-skip"> Skip to content </a>
  60. <header class="md-header" data-md-component="header">
  61. <nav class="md-header-nav md-grid">
  62. <div class="md-flex navheader">
  63. <div class="md-flex__cell md-flex__cell--shrink">
  64. <a href="index.html" title="Netmaker 0.10.0 documentation"
  65. class="md-header-nav__button md-logo">
  66. <i class="md-icon">&#xe869</i>
  67. </a>
  68. </div>
  69. <div class="md-flex__cell md-flex__cell--shrink">
  70. <label class="md-icon md-icon--menu md-header-nav__button" for="__drawer"></label>
  71. </div>
  72. <div class="md-flex__cell md-flex__cell--stretch">
  73. <div class="md-flex__ellipsis md-header-nav__title" data-md-component="title">
  74. <span class="md-header-nav__topic">Netmaker Docs</span>
  75. <span class="md-header-nav__topic"> External Guides </span>
  76. </div>
  77. </div>
  78. <div class="md-flex__cell md-flex__cell--shrink">
  79. <label class="md-icon md-icon--search md-header-nav__button" for="__search"></label>
  80. <div class="md-search" data-md-component="search" role="dialog">
  81. <label class="md-search__overlay" for="__search"></label>
  82. <div class="md-search__inner" role="search">
  83. <form class="md-search__form" action="search.html" method="get" name="search">
  84. <input type="text" class="md-search__input" name="q" placeholder="Search"
  85. autocapitalize="off" autocomplete="off" spellcheck="false"
  86. data-md-component="query" data-md-state="active">
  87. <label class="md-icon md-search__icon" for="__search"></label>
  88. <button type="reset" class="md-icon md-search__icon" data-md-component="reset" tabindex="-1">
  89. &#xE5CD;
  90. </button>
  91. </form>
  92. <div class="md-search__output">
  93. <div class="md-search__scrollwrap" data-md-scrollfix>
  94. <div class="md-search-result" data-md-component="result">
  95. <div class="md-search-result__meta">
  96. Type to start searching
  97. </div>
  98. <ol class="md-search-result__list"></ol>
  99. </div>
  100. </div>
  101. </div>
  102. </div>
  103. </div>
  104. </div>
  105. <div class="md-flex__cell md-flex__cell--shrink">
  106. <div class="md-header-nav__source">
  107. <a href="https://github.com/gravitl/netmaker/" title="Go to repository" class="md-source" data-md-source="github">
  108. <div class="md-source__icon">
  109. <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 24 24" width="28" height="28">
  110. <use xlink:href="#__github" width="24" height="24"></use>
  111. </svg>
  112. </div>
  113. <div class="md-source__repository">
  114. Netmaker
  115. </div>
  116. </a>
  117. </div>
  118. </div>
  119. <script src="_static/javascripts/version_dropdown.js"></script>
  120. <script>
  121. var json_loc = ""versions.json"",
  122. target_loc = "../",
  123. text = "Versions";
  124. $( document ).ready( add_version_dropdown(json_loc, target_loc, text));
  125. </script>
  126. </div>
  127. </nav>
  128. </header>
  129. <div class="md-container">
  130. <nav class="md-tabs" data-md-component="tabs">
  131. <div class="md-tabs__inner md-grid">
  132. <ul class="md-tabs__list">
  133. <li class="md-tabs__item"><a href="index.html" class="md-tabs__link">Netmaker 0.10.0 documentation</a></li>
  134. </ul>
  135. </div>
  136. </nav>
  137. <main class="md-main">
  138. <div class="md-main__inner md-grid" data-md-component="container">
  139. <div class="md-sidebar md-sidebar--primary" data-md-component="navigation">
  140. <div class="md-sidebar__scrollwrap">
  141. <div class="md-sidebar__inner">
  142. <nav class="md-nav md-nav--primary" data-md-level="0">
  143. <label class="md-nav__title md-nav__title--site" for="__drawer">
  144. <a href="index.html" title="Netmaker 0.10.0 documentation" class="md-nav__button md-logo">
  145. <i class="md-icon">&#xe869</i>
  146. </a>
  147. <a href="index.html"
  148. title="Netmaker 0.10.0 documentation">Netmaker Docs</a>
  149. </label>
  150. <div class="md-nav__source">
  151. <a href="https://github.com/gravitl/netmaker/" title="Go to repository" class="md-source" data-md-source="github">
  152. <div class="md-source__icon">
  153. <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 24 24" width="28" height="28">
  154. <use xlink:href="#__github" width="24" height="24"></use>
  155. </svg>
  156. </div>
  157. <div class="md-source__repository">
  158. Netmaker
  159. </div>
  160. </a>
  161. </div>
  162. <ul class="md-nav__list">
  163. <li class="md-nav__item">
  164. <a href="about.html" class="md-nav__link">About</a>
  165. </li>
  166. <li class="md-nav__item">
  167. <a href="architecture.html" class="md-nav__link">Architecture</a>
  168. </li>
  169. <li class="md-nav__item">
  170. <a href="install.html" class="md-nav__link">Install</a>
  171. </li>
  172. <li class="md-nav__item">
  173. <a href="quick-start.html" class="md-nav__link">Quick Install</a>
  174. </li>
  175. <li class="md-nav__item">
  176. <a href="getting-started.html" class="md-nav__link">Getting Started</a>
  177. </li>
  178. <li class="md-nav__item">
  179. <a href="external-clients.html" class="md-nav__link">Ingress + External Clients</a>
  180. </li>
  181. <li class="md-nav__item">
  182. <a href="egress-gateway.html" class="md-nav__link">Egress Gateway</a>
  183. </li>
  184. <li class="md-nav__item">
  185. <a href="relay-server.html" class="md-nav__link">Relay Servers</a>
  186. </li>
  187. <li class="md-nav__item">
  188. <a href="https://k8s.netmaker.org" class="md-nav__link">Kubernetes</a>
  189. </li>
  190. <li class="md-nav__item">
  191. <a href="server-installation.html" class="md-nav__link">Advanced Server Installation</a>
  192. </li>
  193. <li class="md-nav__item">
  194. <a href="client-installation.html" class="md-nav__link">Advanced Client Installation</a>
  195. </li>
  196. <li class="md-nav__item">
  197. <a href="oauth.html" class="md-nav__link">Integrating OAuth</a>
  198. </li>
  199. <li class="md-nav__item">
  200. <input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="__toc">
  201. <label class="md-nav__link md-nav__link--active" for="__toc"> External Guides </label>
  202. <a href="#" class="md-nav__link md-nav__link--active">External Guides</a>
  203. <nav class="md-nav md-nav--secondary">
  204. <label class="md-nav__title" for="__toc">Contents</label>
  205. <ul class="md-nav__list" data-md-scrollfix="">
  206. <li class="md-nav__item"><a href="#usage--page-root" class="md-nav__link">External Guides</a><nav class="md-nav">
  207. <ul class="md-nav__list">
  208. <li class="md-nav__item"><a href="#video-tutorials" class="md-nav__link">Video Tutorials</a>
  209. </li>
  210. <li class="md-nav__item"><a href="#written-tutorials" class="md-nav__link">Written Tutorials</a>
  211. </li></ul>
  212. </nav>
  213. </li>
  214. </ul>
  215. </nav>
  216. <ul class="md-nav__list">
  217. <li class="md-nav__item">
  218. <a href="#video-tutorials" class="md-nav__link">Video Tutorials</a>
  219. </li>
  220. <li class="md-nav__item">
  221. <a href="#written-tutorials" class="md-nav__link">Written Tutorials</a>
  222. </li></ul>
  223. </li>
  224. <li class="md-nav__item">
  225. <a href="ui-reference.html" class="md-nav__link">UI Reference</a>
  226. </li>
  227. <li class="md-nav__item">
  228. <a href="api.html" class="md-nav__link">API Reference</a>
  229. </li>
  230. <li class="md-nav__item">
  231. <a href="upgrades.html" class="md-nav__link">Upgrades</a>
  232. </li>
  233. <li class="md-nav__item">
  234. <a href="troubleshoot.html" class="md-nav__link">Troubleshooting</a>
  235. </li>
  236. <li class="md-nav__item">
  237. <a href="support.html" class="md-nav__link">Support</a>
  238. </li>
  239. <li class="md-nav__item">
  240. <a href="conduct.html" class="md-nav__link">Code of Conduct</a>
  241. </li>
  242. <li class="md-nav__item">
  243. <a href="license.html" class="md-nav__link">License</a>
  244. </li>
  245. </ul>
  246. </nav>
  247. </div>
  248. </div>
  249. </div>
  250. <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
  251. <div class="md-sidebar__scrollwrap">
  252. <div class="md-sidebar__inner">
  253. <nav class="md-nav md-nav--secondary">
  254. <label class="md-nav__title" for="__toc">Contents</label>
  255. <ul class="md-nav__list" data-md-scrollfix="">
  256. <li class="md-nav__item"><a href="#usage--page-root" class="md-nav__link">External Guides</a><nav class="md-nav">
  257. <ul class="md-nav__list">
  258. <li class="md-nav__item"><a href="#video-tutorials" class="md-nav__link">Video Tutorials</a>
  259. </li>
  260. <li class="md-nav__item"><a href="#written-tutorials" class="md-nav__link">Written Tutorials</a>
  261. </li></ul>
  262. </nav>
  263. </li>
  264. </ul>
  265. </nav>
  266. </div>
  267. </div>
  268. </div>
  269. <div class="md-content">
  270. <article class="md-content__inner md-typeset" role="main">
  271. <h1 id="usage--page-root">External Guides<a class="headerlink" href="#usage--page-root" title="Permalink to this headline">¶</a></h1>
  272. <p>Netmaker has many use cases, from a basic virtual network to an office gateway VPN to a Kubernetes underlay. It can be a bit overwhelming to figure out where to start. If you don’t find your use case here, but think Netmaker is a good fit, let us know!</p>
  273. <h2 id="video-tutorials">Video Tutorials<a class="headerlink" href="#video-tutorials" title="Permalink to this headline">¶</a></h2>
  274. <ul class="simple">
  275. <li><p><a class="reference external" href="https://youtu.be/PWLPT320Ybo">Intro/Overview</a>: Tutorial on first-time usage, setting up a mesh network.</p></li>
  276. <li><p><a class="reference external" href="https://youtu.be/krCKBJhwwDk">Site-to-Site Gateway</a>: Tutorial on setting up site-to-site connections, allowing peers to access external networks via gateways.</p></li>
  277. <li><p><a class="reference external" href="https://youtu.be/b4diaKWUcXI">IPv6 and Private DNS</a>: Tutorial on dual-stack IPv6 in Netmaker and Private DNS management (separate topics).</p></li>
  278. <li><p><a class="reference external" href="https://youtu.be/z2jvlFVU3dw">Kubernetes Networking</a>: Tutorial on setting up cross-cloud Kubernetes clusters using Netmaker.</p></li>
  279. </ul>
  280. <h2 id="written-tutorials">Written Tutorials<a class="headerlink" href="#written-tutorials" title="Permalink to this headline">¶</a></h2>
  281. <ul class="simple">
  282. <li><p><a class="reference external" href="https://itnext.io/how-to-deploy-a-single-kubernetes-cluster-across-multiple-clouds-using-k3s-and-wireguard-a5ae176a6e81">K3s Cross-cloud cluster</a>: Tutorial on setting up cross-cloud K3s clusters using Netmaker.</p></li>
  283. <li><p><a class="reference external" href="https://itnext.io/how-to-deploy-a-cross-cloud-kubernetes-cluster-with-built-in-disaster-recovery-bbce27fcc9d7">MicroK8s Cross-cloud cluster</a>: Tutorial on setting up cross-cloud MicroK8s clusters using Netmaker.</p></li>
  284. <li><p><a class="reference external" href="https://afeiszli.medium.com/how-to-enable-secure-access-to-your-hosted-services-using-netmaker-and-wireguard-1b3282d4b7aa">Secure access to private services</a>: Tutorial on setting up secure Nextcloud with Netmaker.</p></li>
  285. </ul>
  286. </article>
  287. </div>
  288. </div>
  289. </main>
  290. </div>
  291. <footer class="md-footer">
  292. <div class="md-footer-nav">
  293. <nav class="md-footer-nav__inner md-grid">
  294. <a href="oauth.html" title="Integrating OAuth"
  295. class="md-flex md-footer-nav__link md-footer-nav__link--prev"
  296. rel="prev">
  297. <div class="md-flex__cell md-flex__cell--shrink">
  298. <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
  299. </div>
  300. <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
  301. <span class="md-flex__ellipsis">
  302. <span
  303. class="md-footer-nav__direction"> Previous </span> Integrating OAuth </span>
  304. </div>
  305. </a>
  306. <a href="ui-reference.html" title="UI Reference"
  307. class="md-flex md-footer-nav__link md-footer-nav__link--next"
  308. rel="next">
  309. <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"><span
  310. class="md-flex__ellipsis"> <span
  311. class="md-footer-nav__direction"> Next </span> UI Reference </span>
  312. </div>
  313. <div class="md-flex__cell md-flex__cell--shrink"><i
  314. class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
  315. </div>
  316. </a>
  317. </nav>
  318. </div>
  319. <div class="md-footer-meta md-typeset">
  320. <div class="md-footer-meta__inner md-grid">
  321. <div class="md-footer-copyright">
  322. <div class="md-footer-copyright__highlight">
  323. &#169; Copyright 2021, Alex Feiszli.
  324. </div>
  325. Created using
  326. <a href="http://www.sphinx-doc.org/">Sphinx</a> 4.3.0.
  327. and
  328. <a href="https://github.com/bashtage/sphinx-material/">Material for
  329. Sphinx</a>
  330. </div>
  331. </div>
  332. </div>
  333. </footer>
  334. <script src="_static/javascripts/application.js"></script>
  335. <script>app.initialize({version: "1.0.4", url: {base: ".."}})</script>
  336. </body>
  337. </html>