Adding cameras
Add a camera by network discovery or by its address, choose the main stream and the substream, and use Test stream before saving: it reports the codec, the picture size, the frame rate and whether there is audio. Never retry a refused camera login by hand: many recorders lock out an address for about half an hour after a few failures, and Habile iEYE holds such a camera for that reason.
Certificates
The appliance serves HTTPS from the first minute with a certificate it issued itself, which browsers warn about. For regular use, set Your host name to a name that points at the stack and Certificate to lets-encrypt, or install your own certificate on the data volume.
Live video and the network
Live video goes from the media server to the browser over WebRTC on port 8189, UDP with a TCP fallback, which the stack opens to the same address range as the console. Viewers behind strict NAT need a STUN or TURN server, set in the appliance's environment file.
Recording storage
With s3 (the default) recordings go to an encrypted bucket and the data volume holds only the database and segments waiting to upload: 200 GiB suits most sites. With ebs everything is on the volume, sized for your whole retention. In a private subnet, give the stack the subnet's route table so uploads use a free S3 endpoint instead of the NAT gateway.
Monitoring
The stack creates four CloudWatch alarms on one SNS topic: system status, instance status, the data volume over 85%, and CPU over 90% for half an hour. Subscribe your on-call to the topic. The console keeps its own camera health and sends a daily digest.
Backup and recovery
The data volume and the recording bucket are the state. Snapshot the volume on your own schedule, for example with AWS Backup. If the instance or the whole stack is lost, create the stack again and name the old volume and bucket: the new instance carries on with the same cameras, users, recordings and settings.
Updating
Subscribe to the new version, then update the stack with the new template and your existing parameters. A new instance takes over the data volume and the bucket; recording stops for a few minutes, so choose a quiet window. If the new instance cannot start the appliance, the update rolls back.
Getting a shell and getting help
Use AWS Systems Manager Session Manager: aws ssm start-session --target <InstanceId>. On the instance, sudo vms-support makes a diagnostic bundle for support@habilelabs.io with no video, no credentials and no database contents.