Minnow Server (Embedded HTTPS & WebSocket Server)

Embedded HTTPS & WebSocket Server

Minnow Server, a super small and fast embedded HTTPS (secure) WebSocket server, lets small microcontrollers with no external memory act as real-time web servers. The super small and secure Minnow Server is ideal for devices that are too small for standard web applications or our Barracuda Embedded Web Server.


The Minnow Server is available under either an open source license or commercial license. The Minnow Server is also included as a free optional component in the SharkSSL package. The open source licensed version is available on Github.

How does it work?

Minnow Server incorporates the HTML5 WebSocket specification, letting JavaScript applications open a persistent, bidirectional, full-duplex and asynchronous communication channel with the embedded device. The Minnow Server is specifically designed to facilitate the use of modern Single Page Applications (SPA) for device management and can be used with modern frameworks such as AngularJS, ReactJS, and Vue.js. See the video below for details.

Embedded WebSocket Server

The Minnow Server is ideal for most modern microcontroller-based systems, letting you web-enable even the tiniest device.

Web applications for Minnow Server are designed in JavaScript and can load on demand from any of the following:

  • the device (flash memory)
  • the browser's local file system
  • directly from a browser, such as a Chrome browser app
  • a cloud server

You decide where to store the web presentation logic by selecting one or all of the above options. Of course, the benefit of storing the web presentation logic off device is that it saves considerable space on the device and lets you easily modify the application without upgrading the firmware.

Get Started with the Minnow Server

WebSockets Design Book

Download Minnow Server from GitHub and start writing Minnow Server Apps. Our Minnow Server design book shows you how to easily and efficiently develop web applications for microcontrollers without running into the typical issues related to running a web server on a resource constrained device.

The GitHub download includes a reference example that can be used as a template for designing modern WebSocket based applications. An introduction to the reference example can be found on DZone by navigating to: IoT-Enabled Embedded Web Server Reference Example.

FreeRTOS/lwIP Example

The following video shows how to install the reference example on a FreeRTOS/lwIP powered ESP8266.

Super Easy TLS and Public Key Infrastructure

The Minnow Server comes pre integrated with our own TLS stack, SharkSSL, thus making it easy for you to use as a developer.

Embedded HTTPS Web Server

Installing SSL certificates in devices can be very difficult for the average end user; however, our optional automatic SSL certificate management service makes it super easy and effortless for your customers to use a secure Minnow Server powered product.

How the WebSocket Protocol Works

WebSocket Upgrade

The WebSocket protocol defined in RFC 6455 specifies how a standard HTTPS request/response pair can be upgraded to a secure and persistent full-duplex connection. HTML5 WebSocket-based applications enable real-time communication while placing less burden on the servers.

WebSockets vs HTTP/AJAX/REST

WebSockets is a relatively new standard that brings real-time communication to the web. WebSockets is supported by all modern browsers and is designed to provide a persistent full-duplex asynchronous communication channel over a single TCP connection.

Message Pattern
Service Push
Not supportedCore feature
Moderate to large for embedded systemsMinimal overhead per WebSocket message

Most embedded web device management applications currently operate by simply responding to user interactions. You click a button and this causes the browser to submit the data to the server. The server performs the command and responds with a new HTML page. This old technology works, but it is a very limiting model. You may have moved beyond the simple GET/POST submit button web design concept and embraced AJAX/REST. However, the fact remains that AJAX is still a one way asynchronous message sent from the browser to the server and any real-time updates you want to display in the browser require polling of server resources. You may still think AJAX and REST are the way to go; however, the entire AJAX protocol could be built using Websockets technology. This makes Websockets literally a superset of AJAX so it makes sense that we might abandon a limiting technology for a broader technology.

The fact that Websockets provides a bi-directional communication channel between the browser and server immediately opens up some very interesting opportunities for web based device management applications. Because the connection is persistent, the embedded web server can now initiate communication with the browser. The embedded web server can send alerts, updates, notifications, etc.. This adds a whole new dimension to the types of web based device management applications that can be constructed.

AJAX over WebSockets

You may have an application where AJAX is the preferred communication model. WebSockets enables us to multiplex data on the same connection, thus we can easily implement an AJAX library on top of WebSockets and still use the same WebSockets connection for bi-directional real-time data transfer. See our AJAX over WebSockets tutorial if you are interested in learning more about this technique.

Application Areas:

The Minnow Server is primarily designed for small micro controllers such as the Cortex-M3/M4 family, where internal memory is limited and using a full application server, such as the Barracuda Application Server, is not an option. Minnow Server is not recommended for larger embedded systems where a full application server can fit into the memory.


Out-of-the-box operating system (OS) support includes INTEGRITY™, MQX™, SMX™, ThreadX™, embOS™, VxWorks™, QNX™, FreeRTOS™, uCLinux™, MDK-ARM™, Microchip, mbed™, Mediatek™, lwIP, Linux, and Windows™.


Out-of-the-box support for lwIP in event driven mode.

Please send us an email if you have any questions on which applications best fit Minnow Server and when to use it.