README-windows.txt 2.4 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576
  1. Mosquitto for Windows
  2. =====================
  3. Mosquitto for Windows comes in 64-bit and 32-bit flavours. All dependencies are
  4. provided in the installer.
  5. Installing
  6. ----------
  7. Running the installer will present the normal type of graphical installer. If
  8. you want to install without starting the graphical part of the installer, you
  9. can do so by running it from a cmd prompt with the `/S` switch:
  10. ```
  11. mosquitto-2.0.12-install-windows-x64.exe /S
  12. ```
  13. You can override the installation directory with the `/D` switch:
  14. ```
  15. mosquitto-2.0.12-install-windows-x64.exe /S /D=:\mosquitto
  16. ```
  17. Capabilities
  18. ------------
  19. Some versions of Windows have limitations on the number of concurrent
  20. connections due to the Windows API being used. In modern versions of Windows,
  21. e.g. Windows 10 or Windows Server 2019, this is approximately 8192 connections.
  22. In earlier versions of Windows, t his limit is 2048 connections.
  23. Websockets
  24. ----------
  25. The broker executables provided in the installers have Websockets support
  26. through a statically compiled version of libwebsockets and is being distributed
  27. under the Static Linking Exception (Section 2) of the License. As a result, the
  28. content is not subject to the LGPL 2.1.
  29. Library Thread Support
  30. ----------------------
  31. libmosquitto on Windows is currently compiled without thread support, so
  32. neither of mosquitto_loop_start() nor "mosquitto_pub -l" are available.
  33. A better solution that the old pthreads-win32 is being looked into, so support
  34. will return in the future. If you need thread support, the code still supports
  35. it just fine. Support has been dropped to simplify installation.
  36. Windows Service
  37. ---------------
  38. If you wish, mosquitto can be installed as a Windows service so you can
  39. start/stop it from the control panel as well as running it as a normal
  40. executable.
  41. When running as a service, the configuration file used is mosquitto.conf in the
  42. directory that you installed to.
  43. If you want to install/uninstall mosquitto as a Windows service run from the
  44. command line as follows:
  45. C:\Program Files\mosquitto\mosquitto install
  46. C:\Program Files\mosquitto\mosquitto uninstall
  47. Logging
  48. -------
  49. If you use `log_dest file ...` in your configuration, the log file will be
  50. created with security permissions for the current user only. If running as a
  51. service, this means the SYSTEM user. You will only be able to view the log file
  52. if you add permissions for yourself or whatever user you wish to view the logs.