Console commands

When you access Xeoma in a Terminal, you’ll get these regular commands displayed:

Usage: Xeoma.app [-command] [-argument]
Commands:
-help (show this help)
-core (run server only)
-client (run client only)
-licenses : run License Server
-cloudservice : run cloud as service
-install [-argument] (working with argument only)
-install -allmanual (install Server and client with manual start)
-install -allauto (install Server and client with auto start)
-install -coreauto (install Server (autoStart) and client (manualStart)
-install -hiddenmode (install Server (autoStart) hidden mode used)
-install -cloudauto : install Cloud with auto start
-install -removeall (remove all, include Archive and config files)
-install -removeexe (remove program. Leave Archive and config files)
-install -licauto : install License Server with auto start
-activateOnline : online activation (separate Serials with ‘;’. For example: -activateOnline ‘Serial1;Serial2’)
-licenseServer [LicenseServer] : license server for online activation. For example: 192.168.0.1::8090
-activateRequest [Serial] : (offline activation)
-activateResponce [ActivationData] :(offline activation)
-showpassword : (show current password and set enable network access)
-startdelay [seconds] : (delay before starting in seconds)
-log : (enable log for server events)
-lang [Language] : (for English: en, for Russian: ru, etc.)
-clientIndex [ClientIndex] : (client ID can contain only letters and numbers (no spaces, maximum 16 characters)
-individualsettings : (store personal settings individually for each client)
-cloud : (start Cloud server with auto restart on crashes)
-noguard : (use this parameter with -cloud to run Cloud without restart guard)
-sampleconfig : (use this parameter with -cloud to generate sample config in Cloud mode)
-nohup : (ignore the HUP (hangup) signal)
-noscan : (disable camera scanning)
-noscanptzandaudio : disable scanning for ptz and audio url
-proxy [ProxyServerURL] : (Set proxy server address)
-proxyclear : (Remove stored proxy server address)
-noarchivedb : (Disable archive database (search in archive will be not available).
-activateRetranslator [Serial] : (online activation of retranslator (separate Serials with ‘;’. For example: -activateRetranslator ‘Serial1;Serial2’)
-noautoupdate : (forced restriction of auto updates for the server part)
-sslconnection : use only secure connection between client and server. To do that, generate and place the certificates into the Server and Client folders. See Xeoma folder > Security > Certificate > Readme.txt for details

Note: for -activateOnline if you want to use “;” instead of “,” as a delimiter, please put serials into ‘ ‘. For example: ./xeoma -activateOnline ‘LKB6CWP10WBPVW5KFGRЕ226UV;NK5XWLJUVММ9TММХСХDLV24E6’

Here are some additional commands you could take advantage of:

-setpassword MYPASS (set MYPASS or another password for Administrator profile, the password that is used for remote access)

-serverport 777 (set 777 as Xeoma port instead of the default 8090, can be any number). Attention: doesn’t work for servers installed to autostart. If you need Xeoma to always work on another port constantly, you will need to edit the autostart script manually:

for Linux: /etc/init.d/XeomaCoreService
for Mac: /Library/LaunchDaemons/XeomaCoreService.plist
for Windows: in the settings of services (Administrative Tools)
Edit it with admin rights. Restart the server part thereafter.

-noscan (cancel initial search for cameras). Attention: doesn’t work for servers installed to autostart. See -serverport to learn how to make it work.

For a detailed instruction on how to work with Xeoma on Linux (with or without graphical shell), please see this article (troubleshooting included).

Changing camera layouts via configuration file

Starting from Xeoma 14.5.13, layouts can be controlled without the visual part via configuration file. For example, when integrated to your home automation system, it will help you choose camera layouts switch between live camera previews simply by pressing a button on a remote controller.

Changes should be applied to the Preview configuration file in Preview configuration folder in Xeoma’s directory:

# Use PreviewMode variable for setting preview mode, TabNumber for setting tab number.
# PreviewMode possible values are:
# 0 for all cameras
# 1 for 1×1
# 2 for 2×1
# 3 for 2×2
# 4 for 3×2
# 5 for 3×3
# 6 for 4×3
# 7 for 4×4
# 8 for 5×4
# 9 for 5×5
# 10 for 8×8
PreviewMode=0
TabNumber=0

Replace 0 in PreviewMode=0 with 1 to enable the 1х1 layout (one camera on screen at a time), with 2 to enable the 2х1 layout, etc. Replace 0 in TabNumber=0 with the number of a tab you’d like to open. Please note: Xeoma should be launched and working when you apply those changes.

for Linux, Mac OS, Android, and Windows will help you change default port and password, and cancel automated search for cameras.