Home / Docs

Cloud Device Adapter Installation

How can we help you?

View Categories

Cloud Device Adapter Installation

The Cloud Device Adapter is local software that connects cameras from your local network to Camlocus.

Use it when:

  • cameras are behind NAT or firewall
  • direct RTSP access from the cloud is not available
  • you want to connect local cameras without exposing them directly to the internet

Recommended operating system: Ubuntu


Step 1 – Create Cloud Device in Camlocus

Open:

   Cloud Devices -> Add

Enter:

  • Name
  • Distribution Type

After saving, Camlocus will generate a unique installation key. You will need this key during adapter
installation.



Step 2 – Install Dependencies on Debian / Ubuntu

Run:

sudo apt-get update
sudo apt install npm
sudo apt-get install -y nodejs

Install FFmpeg:

sudo apt update
sudo apt install ffmpeg


Step 3 – Download and Install Adapter on Debian / Ubuntu

Download the adapter package:

wget https://s1.camlocus.com/storage/uploads/adapters/camlocus-adapter.deb

Install the adapter:

sudo dpkg -i camlocus-adapter.deb

If the file is not in the current directory, replace camlocus-adapter.deb with the correct file path.

During installation, enter the installation key generated in Camlocus.


Step 4 – Restart Adapter

If the adapter needs to reconnect to Camlocus, run:

sudo service camlocus-adapter restart

After restarting, check the Cloud Devices page in Camlocus. The adapter should appear online.


Step 5 – Uninstall Adapter on Debian / Ubuntu

To remove the adapter, run:

sudo dpkg –purge camlocus-adapter


RedHat / CentOS / Fedora Installation

Step 1 – Install Node.js

Run:

sudo yum install https://rpm.nodesource.com/pub_16.x/nodistro/repo/nodesource-release-
nodistro-1.noarch.rpm -y
sudo yum install nodejs -y –setopt=nodesource-nodejs.module_hotfixes=1


Step 2 – Install FFmpeg

Run:

sudo yum install epel-release
sudo yum localinstall –nogpgcheck https://download1.rpmfusion.org/free/el/rpmfusion-free-
release-7.noarch.rpm
sudo yum install ffmpeg ffmpeg-devel

FFmpeg may also be installed using the preferred method for the selected RedHat/CentOS/Fedora distribution.


Step 3 – Download and Install Adapter

Download the adapter package:

wget https://s1.camlocus.com/storage/uploads/adapters/camlocus-adapter-1.0-1.noarch.rpm

Install the adapter using your Camlocus installation key:

sudo INSTALLATION_KEY=value rpm -ivh camlocus-adapter-1.0-1.noarch.rpm

Replace value with the actual installation key from the Cloud Devices page.

Place screenshot here


Step 4 – Restart Adapter

If the adapter needs to reconnect to Camlocus, run:

sudo service camlocus-adapter restart


Step 5 – Uninstall Adapter on RedHat / CentOS / Fedora

To remove the adapter, run:

sudo rpm –verbose –erase camlocus-adapter


Verify Installation

After installation:

  • Open Camlocus.
  • Go to Cloud Devices.
  • Confirm that the adapter status is online.
  • Open adapter details.
  • Scan the local network for cameras.


Troubleshooting

If cameras are not detected:

  • confirm the camera is on the same local network
  • check that the camera RTSP stream works locally
  • ping the camera IP address from the adapter server
  • restart the adapter service
  • run the network scan again in Camlocus


Assign Camera to Cloud Device

Open:

   Cameras -> Actions -> Edit -> Settings -> Video Icon

Set:

   Video Source: Cloud Device (Adapter)

Then select:

  • Cloud Device
  • detected camera IP address
  • local RTSP URL

Click:

   Update