Shinobi

Managing Multiple Shinobi from a Central Panel

Shinobi now has a Management Portal. View and Manage all your Shinobi servers from one panel.

At the time of release of this article our Management Server is in open beta and the connected Shinobi servers require the latest dev branch. While this dashboard provides similar experience to the dashboard bundled with Shinobi itself, it is currently inferior to operation performance of the original dashboard.

Additionally, Pairing a Shinobi requires that the Shinobi server is Activated with a Shinobi Pro license.

This application is currently only tested with Ubuntu 24.04 and Raspberry Pi OS (2025-01-09).

For support with this application you may post in our Forum on Reddit or in our Community Chat on Discord.

1. Download and install from our CDN.

This method will also ask you to create a user. You will be asked to create a user at the end of the installation.

By default it will install to /home/mgmt.

apt install curl -y
sh <(curl -s https://cdn.shinobi.video/apps/downloadAndInstallMgmtServer.sh)

OPTIONAL : You can tell it to install at a different location by including an absolute path at the end of the command as shown below.

sh <(curl -s https://cdn.shinobi.video/apps/downloadAndInstallMgmtServer.sh) /home/mgmt2

2. Login to the Superuser panel of your Shinobi server and create a user , If one already exists you do not need to do this. This will be used by the Management Server.

Run the installer again. Remember to include the installation path if you installed at a different location.

sh <(curl -s https://cdn.shinobi.video/apps/downloadAndInstallMgmtServer.sh) /home/mgmt2

This assumes you will have one account created in the Superuser panel. This account will be automatically accessed by the Management Server. The Management Server will also have complete access to the Superuser panel.

1. Login to the Shinobi Superuser panel

Edit Shinobi Server Configuration in Superuser panel. Add the following parameter.

"enableMgmtConnect": true,

2. Restart Shinobi and refresh the page.

Open Controls and Logs tab and Restart Core. Then refresh the page. Now the Central Management tab will be enabled in the Superuser panel.

3. Fill the two fields

  • Server URL : The IP Address of your Managment Server. Ensure port 8663 is available on this server.
  • P2P API Key : This is gotten from your Shinobi Shop account. Review our Easy Remote Access guidelines for more information on getting one.

4. Save and your Shinobi server should appear in your Management Server's interface.

1. Shinobi Server must have the following parameters added before following this method.

"enableMgmtConnect": true,

2. Restart Shinobi and refresh the page.

Open Controls and Logs tab and Restart Core. Then refresh the page. Now the Central Management tab will be enabled in the Superuser panel.

3. Login to the Management Server and navigate to the Servers tab and click Plus (+) icon and fill the pairing form.

  • Shinobi Server IP : IP of the Shinobi server.
  • P2P API Key : This is gotten from your Shinobi Shop account. Review our Easy Remote Access guidelines for more information on getting one.
  • Management Server IP : The address of your Management server. This can be left blank to automatically use the value shown within it.

4. Save. You should now see the Server Connected.

This currently must be done from the terminal (command line). During the open beta all users created this way will have the same level of access. Which is complete access to any Shinobi server associated to the Management Server.

1. Enter the Management Server app directory. By default this is /home/mgmt .

cd /home/mgmt

2. Run the following command to create the user.

node tools/addNewUser.js USERNAME PASSWORD
  • USERNAME : replace this portion with your desired Username.
  • PASSWORD : replace this portion with your desired Password.

You can click the Monitor name in the Side Menu to launch the Live Stream in the Live Grid tab.

The best choice for Live Stream is Poseidon over Websocket with Video Codec set as copy . Audio Codec is disabled by default and must be enabled manually. We recommend setting Audio Codec to AAC .

If you cannot see the option to set Connection Type to Websocket you must toggle Simple to Advanced in the bottom right corner of the Monitor Settings tab.

Poseidon over Websocket will have low latency as well as offer H.265 Playback in Chrome on a Windows 11 Client device.

More Information here : https://hub.shinobi.video/articles/view/DoqdG2mdBsvMctn

You can open the Monitor Settings tab then select the Server you want to list Monitors from. Then below that selector you can choose which Monitor to edit.

Adding them with ONVIF Scanner

You can open the ONVIF Scanner tab then select the Server that you want to Scan from and Add to. Input the IP Address Range to scan and put the Camera(s) Username and Password. Port can be left blank.

Example IP Range : 10.0.0.1-10.0.1.254

Manually Adding them

You can open the Monitor Settings tab then select the Server you want to add Monitors to. Then below that selector you can choose Add New . This will clear the form of any previously selected Monitors to prepare it for adding a new one with default settings.

By default the options are geared for an H.264 stream coming from the camera. Just change the Stream Type to Poseidon and Connection Type to Websocket to set it for an H.265 stream.

Open the Monitors tab. Select the Monitors you wish to Move then in the bottom right corner open the menu and select Move . A confirmation window will appear allowing you to choose which server to move them to.

The Move feature will NOT move recorded footage to the other server AND will delete any footage saved on the Server that it will be moved from.

Similar to the Move feature, open the Monitors tab and select the Monitors you want to delete. Then in the bottom right menu select Delete.

The recorded content that is viewable from the Management server is not stored on the Management Server. All data remains on the respective Shinobi server.

ShinobiDocs

All content is property of their respective owners.