-
Notifications
You must be signed in to change notification settings - Fork 2.3k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
4 changed files
with
59 additions
and
104 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,70 +1,63 @@ | ||
Mosquitto for Windows | ||
===================== | ||
|
||
Mosquitto for Windows comes in two flavours, win32 or Cygwin. The win32 version is only | ||
supported on Windows Vista or later. | ||
Mosquitto for Windows comes in 32-bit and 64-bit flavours. | ||
|
||
In all cases, the dependencies are not provided in this installer and must be installed | ||
separately in the case that they are not already available. | ||
In both cases, the dependencies are not provided in this installer and must be | ||
installed separately in the case that they are not already available. | ||
|
||
|
||
Capabilities | ||
------------ | ||
|
||
Some versions of Windows have limitations on the number of concurrent | ||
connections. Non-server versions have been reported to be limited to | ||
approximately 1024 connections. | ||
connections, set at approximately 2048 connections depending on the version of | ||
Windows you are using. | ||
|
||
|
||
Websockets | ||
---------- | ||
|
||
The broker executables provided in the installers do not have Websockets support enabled. | ||
If you wish to have a version of the broker with Websockets support, you will need to compile | ||
libwebsockets version v1.7 onwards because no Windows binaries are provided. | ||
The broker executables provided in the installers have Websockets support | ||
through a statically compiled version of libwebsockets and is being distributed | ||
under the Static Linking Exception (Section 2) of the License. As a result, the | ||
content is not subject to the LGPL 2.1. | ||
|
||
Please note that on Windows, libwebsockets limits connections to a maximum of 64 clients. | ||
|
||
Library Thread Support | ||
---------------------- | ||
|
||
Dependencies - win32 | ||
-------------------- | ||
|
||
* OpenSSL | ||
Link: http:https://slproweb.com/products/Win32OpenSSL.html | ||
Install "Win32 OpenSSL <version>" | ||
Required DLLs: libeay32.dll ssleay32.dll | ||
* pthreads | ||
Link: ftp:https://sourceware.org/pub/pthreads-win32 | ||
Install "pthreads-w32-<version>-release.zip | ||
Required DLLs: pthreadVC2.dll | ||
|
||
Please ensure that the required DLLs are on the system path, or are in the same directory as | ||
the mosquitto executable. | ||
libmosquitto on Windows is currently compiled without thread support, so | ||
neither of mosquitto_loop_start() nor "mosquitto_pub -l" are available. | ||
|
||
A better solution that the old pthreads-win32 is being looked into, so support | ||
will return in the future. If you need thread support, the code still supports | ||
it just fine. Support has been dropped to simplify installation. | ||
|
||
Dependencies - Cygwin | ||
--------------------- | ||
Dependencies | ||
------------ | ||
|
||
* OpenSSL | ||
Link: http:https://slproweb.com/products/Win32OpenSSL.html | ||
Install "Win32 OpenSSL <version>" | ||
* pthreads | ||
Link: ftp:https://sourceware.org/pub/pthreads-win32 | ||
Install "pthreads-w32-<version>-release.zip | ||
* Cygwin | ||
Link: https://www.cygwin.com/setup-x86.exe | ||
Required packages: libgcc1, openssl, zlib0 | ||
Install "Win32 OpenSSL 1.1.0* Light" or "Win64 OpenSSL 1.1.0* Light" | ||
Required DLLs: libssl-1_1.dll, libcrypto-1_1.dll or libssl-1_1-x64.dll, libcrypto-1_1-x64.dll | ||
|
||
Please ensure that the required DLLs are on the system path, or are in the same directory as | ||
the mosquitto executable - usually C:\Program Files (x86)\mosquitto or C:\Program Files\mosquitto. | ||
|
||
Windows Service | ||
--------------- | ||
|
||
If all dependencies are installed prior to the installer being run, the broker can be | ||
installed as a Windows service. | ||
|
||
You can start/stop it from | ||
the control panel as well as running it as a normal | ||
If you wish, mosquitto can be installed as a Windows service so you can | ||
start/stop it from the control panel as well as running it as a normal | ||
executable. | ||
|
||
When running as a service, the configuration in mosquitto.conf in the | ||
installation directory is used so modify this to your needs. | ||
When running as a service, the configuration file used is mosquitto.conf in the | ||
directory that you installed to. | ||
|
||
If you want to install/uninstall mosquitto as a Windows service run from the | ||
command line as follows: | ||
|
||
C:\Program Files\mosquitto\mosquitto install | ||
C:\Program Files\mosquitto\mosquitto uninstall |