Skip to content
Deployment

Run it in your AWS account, or on your own servers

The same software runs four ways. Most teams start with the AWS Marketplace appliance: one CloudFormation stack, about six minutes, and the recordings in a bucket you own. Sites that must keep video on their own hardware run it on a Linux or Windows server.

Last updated

Your account, your Region

The AWS Marketplace stack runs in any of these 8, and the recordings stay where you launch it.

  • Asia Pacific (Mumbai)ap-south-1
  • Asia Pacific (Singapore)ap-southeast-1
  • Asia Pacific (Sydney)ap-southeast-2
  • Asia Pacific (Tokyo)ap-northeast-1
  • Europe (Ireland)eu-west-1
  • Europe (Frankfurt)eu-central-1
  • US East (N. Virginia)us-east-1
  • US West (Oregon)us-west-2

Measured: 6 min 12 s from Create stack to a working console, on an m7i.xlarge on 26 October 2026.

Four ways to run it

Choose where the video lives

Each card says what has been released and run, in the same words as the product documentation.

  • Recommended

    AWS Marketplace appliance

    One EC2 instance in your own AWS account

    One CloudFormation stack creates the instance, an encrypted S3 bucket for recordings, an encrypted data volume, alarms and the first sign-in. Measured at about six minutes from Create stack to a working console.

    • Recordings in an encrypted S3 bucket in your account by default, or on an encrypted EBS volume
    • No licence key: the AWS Marketplace subscription is the licence, with no camera or user limit
    • Pay by the hour or a year upfront, per instance size, on your AWS bill
    • Shell access through AWS Systems Manager Session Manager; SSH stays closed
    • Updates are a stack update that keeps the data volume and the bucket
    Where the video goes
    An S3 bucket or EBS volume in your AWS account. Nothing is sent to HabileLabs.
    Licence
    Your AWS Marketplace subscription
    Fits
    Teams that want the recordings in their own cloud account, up to about 750 cameras on one instance
    Status
    Public on AWS Marketplace since 27 October 2026. Current version 4.4.0 (13 November 2026).
  • Self-hosted appliance

    One Linux server on your site or in any cloud

    The same software as a Docker Compose stack on one Linux server you run: on-premises, in a data centre, or on a virtual machine in any cloud. Recordings go to local disks or any S3-compatible store.

    • Local disks, a NAS, or any S3-compatible object store for recordings
    • Works without internet access: the licence is an offline file and releases install from a bundle
    • AI detection and the AI use cases, when the licence includes them
    • Linux on x86-64 or arm64
    Where the video goes
    Your own disks or object store, on your own network.
    Licence
    A signed licence file from HabileLabs: camera limit, user limit, expiry, AI features
    Fits
    One site, sites without internet access, or anyone who must keep video on their own hardware
    Status
    Released; current version 4.4.0. The Compose stack is verified end to end.
  • Windows Server

    Windows services, no containers, no internet needed

    From version 4.3.0 Habile iEYE installs and updates on a Windows server from an offline bundle, as Windows services, with no Docker and no internet access.

    • Installs and updates from an offline bundle
    • Runs as Windows services under the server's own name
    • ONVIF discovery, disk, load, CPU and memory monitoring work as on Linux
    Where the video goes
    The Windows server's own disks.
    Licence
    A signed licence file from HabileLabs
    Fits
    Sites standardised on Windows Server, including ones with no internet access
    Status
    Released in 4.3.0 (November 2026).
  • Multi-server and Kubernetes

    Several media and API servers, or several sites

    For many organisations or more cameras than one server should carry: several media servers, several API servers, and federation between sites so one console searches them all. Kubernetes manifests are included.

    • Several media servers and several API servers behind one console
    • Federation between sites: paired sites share a camera catalogue and a recording index
    • Kubernetes manifests for AWS (EKS) and for any cluster
    Where the video goes
    Your own cluster and storage.
    Licence
    A signed licence file from HabileLabs
    Fits
    More than about 750 cameras, high availability, or several sites under one console
    Status
    Sized and validated with you: the Kubernetes manifests are rendered and schema-checked but have not been run on a production cluster by us.
On AWS

What the stack creates in your account

Everything is in your account and your Region. The bucket and the data volume are kept when the stack is deleted and carried over when you update.

Your site

Your camerasAny RTSP or ONVIF camera, on your own network.
RTSP and ONVIF over your VPN, Direct Connect or peered VPC

Your AWS account, your Region

One EC2 instance: Habile iEYEThe server, the media server, PostgreSQL and the HTTPS proxy, from the AWS Marketplace image.
S3 bucket, encryptedRecordings, exports and timelapse frames.
EBS data volume, encryptedThe database, keys and certificates.
CloudWatch alarmsStatus checks, disk and CPU, to your e-mail.
Secrets ManagerThe first administrator's generated password.

Nothing is sent to HabileLabs.

HTTPS and WebRTC, from the address range you name

Your people

A web browserLive video, recordings, alerts and health.
  • One EC2 instance

    From the Habile iEYE AMI (Ubuntu 24.04 LTS): the server, the media server, PostgreSQL and the HTTPS proxy.

  • An encrypted S3 bucket

    For recordings, exports and timelapse frames. It blocks all public access and accepts only HTTPS.

  • An encrypted EBS data volume

    For the database, the keys and the certificates, or for everything if you choose EBS.

  • A security group

    Open only to the address range you name. There is no default, and SSH stays closed.

  • Four CloudWatch alarms

    System status, instance status, the data volume over 85%, and CPU over 90% for half an hour.

  • A Secrets Manager secret

    Holds the first administrator's generated password, which you change at first sign-in.

Your data

Where everything is kept

Where Habile iEYE keeps each kind of data on the AWS Marketplace edition
WhatWhere
Recordings, exports, timelapse framesThe S3 bucket in your account (or the encrypted EBS volume, if you choose EBS)
The database: cameras, users, events, auditThe encrypted EBS data volume
Camera credentialsIn the database, encrypted
The appliance's own secrets and keysOn the data volume, generated on the first instance
LogsOn the instance, capped in size, with no credentials and no stream URLs

Nothing is sent to HabileLabs

The appliance's only outbound connections

  • Your cameras
  • Your own S3 bucket
  • The notification services you configure
  • Ubuntu and Docker package mirrors, for security updates

There is no usage reporting and no licence server to call. Your AWS Marketplace subscription is the licence.

Before you start

What you need on AWS

  • A subscription to Habile iEYE on AWS Marketplace

    AWS will not launch the AMI without one.

  • A VPC and a subnet

    A public subnet for an internet-facing console; a private subnet with a NAT gateway otherwise.

  • A network path to your cameras

    The appliance reaches cameras over RTSP (usually port 554) and ONVIF. Cameras on a site network need a VPN, AWS Direct Connect or a peered VPC.

  • The address range your viewers come from

    The stack asks for it and has no default.

  • An instance size for your cameras

    From about 24 cameras on large to about 750 on 4xlarge.

  • A current browser with WebRTC

    Live video goes to the browser over WebRTC.

Reaching your cameras is your side of the deployment

Cameras on a site network are not reachable from AWS until you connect the two: a site-to-site VPN, AWS Direct Connect or a peered VPC. Recording also depends on that link staying up. If your site's uplink cannot carry the video, run the self-hosted appliance on site instead.

Sizing

How many cameras per instance

Camera counts are design targets at 2 MP and 15 fps, for recording and viewing. Size from your cameras' real bitrates and leave headroom.

Cameras per instance size, as design targets
SizevCPU / memoryCameras at 2 MP, 15 fps
large2 / 8 GiBabout 24
xlarge4 / 16 GiBabout 64
2xlarge8 / 32 GiBabout 256
4xlarge16 / 64 GiBabout 750

750 cameras on one appliance is the ceiling the product is designed to, not a limit the software enforces. Above it, run more than one appliance or plan a multi-server deployment with us. Storage is a separate sum: see what AWS charges.

Questions

About deploying

How do I deploy Habile iEYE on AWS?
Subscribe on AWS Marketplace, choose the Appliance with CloudFormation delivery option, and launch the stack with your VPC, subnet, viewer address range and instance type. The stack creates the instance, an encrypted S3 bucket, an encrypted data volume, alarms and the first sign-in, and was measured at about six minutes (6 min 12 s on an m7i.xlarge) from Create stack to a working console.
How do my cameras reach an instance in AWS?
The appliance connects out to each camera over RTSP (usually port 554) and ONVIF. Cameras on a site network need a route from the VPC: a site-to-site VPN, AWS Direct Connect or a peered VPC. Setting up that path is your side of the deployment.
What happens to my data when I update to a new version?
The new version takes over the same data volume and bucket, so cameras, users, recordings and settings stay. Recording stops for a few minutes while the new instance takes over, and if the new instance cannot start the appliance, the update rolls back to the old one.
What happens to my recordings if I delete the stack?
Deleting the stack keeps the data volume and the recording bucket. A new stack can pick both up again and carry on with the same cameras, users, recordings and settings. You delete them yourself when you no longer need the footage.
Can I launch the AMI without the CloudFormation template?
Yes. The image configures itself from instance metadata and prints the first sign-in to the system log. The template is recommended because it also creates the bucket, the data volume, the security group and the alarms.

The full deployment and operating guide covers certificates, monitoring, backup and updates.

Get started

See it on your own cameras

Start the free trial from AWS Marketplace and have a console in about six minutes, or book thirty minutes with a HabileLabs engineer to walk through the console and size a deployment for your cameras.

Or email support@habilelabs.io · Monday to Friday, 10:00–19:00 IST

  1. Subscribe on AWS Marketplace30 days with no software charge on one instance; AWS bills the instance and storage.
  2. Launch the stackPick a Region and a size. A working console in about six minutes.
  3. Add your camerasGive the stack a route to your site (a VPN, Direct Connect or a peered VPC) and add each camera by its address.