index.rst.txt 3.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160
  1. .. Netmaker documentation master file, created by
  2. sphinx-quickstart on Fri May 14 08:51:40 2021.
  3. You can adapt this file completely to your liking, but it should at least
  4. contain the root `toctree` directive.
  5. .. image:: images/netmaker.png
  6. :width: 100%
  7. :alt: Netmaker WireGuard
  8. :align: center
  9. .. role:: raw-html(raw)
  10. :format: html
  11. :raw-html:`<br />`
  12. =======================================
  13. Welcome to the Netmaker Documentation
  14. =======================================
  15. Netmaker is a platform for creating and managing fast, secure, and dynamic virtual overlay networks using WireGuard.
  16. This documentation covers Netmaker's :doc:`installation <./server-installation>`, :doc:`usage <./usage>`, :doc:`troubleshooting <./support>`, and customization, as well as reference documents for the :doc:`API <./api>`, UI and Agent configuration. All of the `source code <https://github.com/gravitl/netmaker>`_ for Netmaker is on GitHub.
  17. .. :raw-html:`<br />`
  18. .. .. raw:: html
  19. .. :file: youtube-1.html
  20. About
  21. ------
  22. A quick overview of Netmaker, explaining what it is, how it works, and why you should be using it.
  23. .. toctree::
  24. :maxdepth: 2
  25. about
  26. Architecture
  27. ---------------
  28. A technical overview of Netmaker, including design decisions and limitations.
  29. .. toctree::
  30. :maxdepth: 2
  31. architecture
  32. Quick Start
  33. ---------------
  34. A quick start guide to getting up and running with Netmaker and WireGuard as quickly as possible.
  35. .. toctree::
  36. :maxdepth: 2
  37. quick-start
  38. Server Installation
  39. --------------------
  40. A detailed guide to installing the Netmaker server (API, DB, UI, DNS), and configuration options.
  41. .. toctree::
  42. :maxdepth: 2
  43. server-installation
  44. Client Installation
  45. --------------------
  46. A detailed guide to installing the Netmaker agent (netclient) on devices and configuration options.
  47. .. toctree::
  48. :maxdepth: 2
  49. client-installation
  50. External Clients
  51. --------------------
  52. A detailed guide to give clients outside of the Netmaker network access to network resources.
  53. .. toctree::
  54. :maxdepth: 2
  55. external-clients
  56. Guides
  57. ----------------
  58. A handful of guides for use cases including site-to-site, Kubernetes, private DNS, and more.
  59. .. toctree::
  60. :maxdepth: 2
  61. usage
  62. API Reference
  63. ---------------
  64. A reference document for the Netmaker Server API, and example API calls for various use cases.
  65. **Coming Soon:** Swagger Documentation
  66. .. toctree::
  67. :maxdepth: 1
  68. api
  69. Troubleshooting
  70. ----------------
  71. Help with common Netmaker/netclient issues.
  72. .. toctree::
  73. :maxdepth: 2
  74. troubleshoot
  75. Support
  76. ----------------
  77. Where to go for help, and a FAQ.
  78. .. toctree::
  79. :maxdepth: 2
  80. support
  81. Contributing
  82. -----------------
  83. A guide on how to contribute to the Netmaker project.
  84. .. toctree::
  85. contribute.rst
  86. Code of Conduct
  87. -----------------
  88. A statement on our expectations and pledge to the community.
  89. .. toctree::
  90. conduct.rst
  91. Licensing
  92. ---------------
  93. A link to the Netmaker license.
  94. .. toctree::
  95. license.rst