Streaming Server Configuration
Get permanent access to live streaming and archive video, no matter where you are in the world. The Macula Streaming Server allows quick and easy access to your cameras via web browser and/or native mobile applications.
Macula Streaming Server is a part of Macula software integrated into the Macula Server core. It is designed for video streaming to multiple web-browsing platforms such as Mozilla Firefox and Google Chrome. Some major Macula Streaming Server features are: video stream live view, archive playback, Pan-Tilt-Zoom control. The Macula Streaming Server optimises video streaming for web or mobile clients, to a degree dependent on connection speed and device viewing capabilities.
If you are using AD/LDAP user accounts for the Web client login, we strongly recommend that you turn on HTTPS for enhanced security
Macula Streaming Server configuration on the Macula Console side is simple and only consists of HTTP port for streaming connections. To access the Macula Streaming Server setup in Macula Console, go to the Configuration section and then click Servers in the menu on the left; double-click the target server to bring up the configuration dialog box and switch to the Connections tab.
You only need to define a HTTP port for Macula Streaming Server; the default port is 8080. On top of that, you can secure your connection and use a HTTPS port for the same purpose. Secure HTTP will require a valid digital certificate, either a self-generated (generate on the fly, will require trust confirmation everywhere) or issued by authority (paid, bound to your domain).
Please make sure that your chosen HTTP port:
is opened on the target server firewall;
is properly configured for port forwarding on all intermediate network equipment, if necessary;
is not being used by any other application or service on the target server.
If you are using HTTPS with your own CA certificate (bound to your domain name), remember these important guidelines for the mobile app setup:
when connecting via local network, use server IP address
when connecting over internet (4G etc.), use the hostname instead of IP (main domain must be the same as in the certificate)
if port forwarding is used (local HTTPS port is different from external), enter the port number as the "Internet port" in the server connection configuration
If you are using your own CA certificates, create a .pem file with your certificate chain as described here:
https://www.digicert.com/ssl-support/pem-ssl-creation.htm
This is necessary for the certificate to be recognized correctly by all HTTP clients - Web browsers and Macula mobile applications. If you simply apply your CA certificate in Macula Console, there is a chance it is not recognized because some applications require the entire certificate chain.
Then, apply the .pem file as the certificate together with your key when the importing certificate into Macula Console.
Once you are done with the settings, click OK to save and close the dialog box. Your Macula Streaming Server will now be set up and accessible via a local - and, if used, external - IP. You can immediately check the connection at once: just open your browser and type: <local IP>:<HTTP port>; for example, server configuration for the snapshot above will require 192.168.1.83:8080.
User Permissions for Macula Streaming Server
If you are going to create a non-administrative user account for Macula Streaming Server access (designated or combined with other permissions sets), the following user permissions should be granted in the user properties dialog box:
for Web browser and API login: under Administration profile > Client permissions > Login via HTTP
for the Macula Mobile access: Login via Mobile
to allow editing HTTP connection properties: Console permissions >Manage servers (this will automatically enable Macula Console login, and also grant access to other server settings)
In the Resources tab, select channels and features you wish to grant access to. There are separate permissions for live and archive access, PTZ, audio, and bookmarks.
Last updated