Arobin AI Vision Book a demo

User manual

The complete Arobin user manual. Every Arobin server also includes it, at /help/, so it opens without internet.

Arobin 1.0 — English. The Kurdish and Arabic editions are translations of this text.

Draft awaiting review

1. What Arobin is and what the packages include

Arobin is a video recorder with artificial intelligence, made by Aron Fund. It is a small server on your premises that records your cameras, watches the pictures for people, vehicles and other objects, and lets you see, search and export the recordings from any computer or phone with a web browser.

Everything happens on the server itself. Recordings, face photos and the words you type in the search stay on your premises; only the event alerts you set up carry the event's picture to your email or Telegram. Arobin works without internet; the internet is needed only for email and Telegram alerts, phones that connect from outside, online updates and, when an owner turns it on, the contracts' writing assistant (OpenAI), which gets contract texts without the employee's details. The web interface is in Kurdish (Sorani), Arabic and English. Its main pages are Live, Review, Explore (search), Export and System status.

The server

An Arobin OS server has two network ports: one for your router (the customer port), one for the switch that powers the cameras (the camera port). The cameras are on their own network: they get their address and the time from the Arobin server and cannot reach the internet or your office network. The server can also join your router by Wi-Fi; the cameras never use Wi-Fi. The server never sleeps.

A screen and a keyboard connected to the server show a small English text menu, the console. Before Arobin is set up it installs Arobin or restores a backup; afterwards it is used only for Wi-Fi, the network ports, updates, restarting or switching off, the switch that lets Arobin Support sign in, and a new administrator password when the old one is lost.

Packages S, M and L

PackageObject detectionSearch in Arabic
SStandard model, on the server's built-in graphicsBuilt-in glossary
MStandard model, on the server's built-in graphicsMachine translation on the server; the glossary as fallback
LLarger model, on the graphics processorMachine translation on the server; the glossary as fallback

Search in Kurdish uses the glossary in every package. The hardware of each package, the number of cameras it handles and the days of recordings it keeps are to be confirmed after the field test. The number of cameras you may enable is set by your license (section 10).

2. First sign-in

The setup page

The screen at the server shows the web address of Arobin and the address of the first-steps page (the server's address followed by /setup/). Open it on a computer in your network. The buttons at the top switch between Kurdish, Arabic and English. It has three steps: Install the security certificate, Log in and Documentation and support.

Installing the root certificate

Arobin's certificate is made by your own server, so a browser warns until the device trusts the server's root certificate, named Arobin Local Root CA. Install it once on every computer and phone you use for Arobin. The installer showed its fingerprint (SHA-256); compare it before you trust the certificate. Press Download the certificate, then follow the line for your device:

  • Windows: open the file, choose Install Certificate and place it in Trusted Root Certification Authorities.
  • Android: Settings › Security › Install a CA certificate.
  • iPhone / iPad: open the file, install the profile, then trust it in Settings › General › About › Certificate Trust Settings.
  • macOS: open the file in Keychain Access and choose Always Trust.

Restart the browser afterwards.

Changing the administrator password

  1. Press Open Arobin. Sign in with Username admin and the initial Password (shown once at the end of the installation), then press Login.
  2. Open the user menu (Current User: admin) and choose Set Password.
  3. Enter the Current Password and the New Password twice (At least 12 characters), and save.

Nobody can read a password back later. Keep it in a safe place; if you forget it, see section 14. In the same menu, Languages offers کوردی (Central Kurdish), العربية (Arabic) and English (English); Kurdish is the default.

3. Live view

Open Live in the menu. The cameras are shown in a grid. On a phone the same page adapts to the small screen.

Cameras and groups

  • All Cameras shows the cameras on one dashboard; a camera can be left out of it with Show on Live dashboard in its settings.
  • Camera Groups keep a few cameras together. Press Add Camera Group, give it a Name, choose the Cameras and an Icon.
  • A camera's name is set in Settings → Camera management under Display Name; alerts and the System status page use the same name.

A single camera

Press a camera to open it on its own. Its toolbar offers Fullscreen, Download instant snapshot (saves the current picture), Enable Recording / Disable Recording, Turn Camera Off (the camera stops recording and detecting until you press Turn Camera On or the video engine restarts; it is shown as Camera is off) and Show historical footage, which jumps to this camera's recordings.

Streaming and sound

Each group has Camera Streaming Settings. Smart Streaming (recommended) shows a picture that refreshes once a minute while nothing happens and switches to live video when something moves.

Sound is available only when the camera sends it and the stream was set up for it; the stream settings of a single camera say Audio is available for this stream or Audio is not available for this stream. When it is available, the toolbar has Enable Camera Audio; Mute All Cameras and Unmute All Cameras act on the whole grid.

4. Review and playback, exporting a clip

The Review page

Open Review in the menu. It lists the day's events, newest first, with a preview. At the top choose Alerts (the important events; unless your provider set it up differently, every person and every car), Detections (the other recognised objects) or Motion (every moment with movement). The Calendar chooses the day (Last 24 Hours is the default); Filter narrows the list to cameras or zones. A camera appears here only when Show in Review is on in its settings.

Open an event to play it. The Timeline shows the hours of the day with the events marked; drag it to move through the recording. After looking at an event press Mark as Reviewed; reviewed items are hidden until you turn on Show Reviewed. Download Video saves the clip of one review item to your device.

Exporting a clip

  1. On the Review page, open the camera's recording and press Export.
  2. Choose the time: Last Hour, Custom with a Start Time and an End Time, or Select from Timeline. With the timeline, drag the two ends of the range and press Use This Range.
  3. Name the file under Name the Export (optional) and press Export. Arobin answers "Successfully started export. View the file in the exports page."
  4. Open Export in the menu. The file appears with its progress. When it is ready, press Download video.

5. Search in Kurdish, Arabic and English

Open Explore in the menu. The box at the top (Search…) accepts a description in Kurdish, Arabic or English. Arobin translates Kurdish and Arabic to English on the server itself, then searches the pictures of all recognised objects. English is understood as it is.

Examples

Kurdish:

  • ئۆتۆمبێلی ڕەش — a black car
  • پیاوێک بە چاکەتی شین — a man in a blue jacket
  • ئۆتۆمبێلێکی سپی لە پارکینگ — a white car in the parking lot
  • دوێنێ پیاوێک لە بەردەم دەرگا وەستاوە — a man standing in front of the door, yesterday

Arabic:

  • سيارة حمراء — a red car
  • رجل يرتدي سترة زرقاء — a man wearing a blue jacket
  • بايسكل أحمر — a red bicycle
  • سيارة بيضاء في موقف السيارات — a white car in the parking lot

What the glossary understands

The built-in glossary knows more than three hundred words used to describe camera pictures: colours, clothing, vehicles, objects and people, actions, places, relations (in front of, next to), time and numbers. It knows common Iraqi words too, for example بايسكل, بيكب, دشداشة, لابس, البارحة, يم and بزونة.

  • Spelling variants are treated alike: ي and ی, ك and ک, ة and ە, the hamza seats, vowel marks, Eastern or Western digits.
  • Kurdish and Arabic endings (‎-ەکە, ‎-ەکان, ‎-ێک, ‎ال-), plurals and the dual are handled; a number makes the object plural.
  • Words are put in English order: ئۆتۆمبێلی سپیی گەورە becomes big white car; a verb at the end and a time word move to their English place.

In packages M and L, Arabic is translated by a machine translation service on the server; the glossary steps in when it is not available.

Tips

  • Short phrases work best: a colour and an object, an object and a place, a person and a piece of clothing.
  • Set the interface to the language you type: in a Kurdish interface, Arabic-keyboard spellings are read as Kurdish.
  • A Kurdish or Arabic word the glossary does not know is left out of the search; words in Latin letters and numbers (a plate, a brand) are kept as they are, and when the glossary knows no word at all, the text is searched as typed. Try a simpler word if the results are poor.
  • Narrow the results with Cameras, Labels, Zones, Time Range, Before and After.
  • The menu of a result offers Download video, Download snapshot and Find similar. Save search keeps a frequent search under Saved Searches.

A record of each translation stays on the server; nothing is sent anywhere.

6. Alerts

Open Settings, then Alerts in the Arobin section. Alerts for events (a person at the door at night) need the Email and Telegram alerts module in your license; health alerts and the notices about support access do not need it. Under This site, set the Site name, the Arobin address used for the link in each alert, and the Time zone.

Email

  1. Turn on Enabled.
  2. Enter the SMTP server, Port and Security of your mail provider (STARTTLS (port 587), TLS (port 465) or None), the User name, Password and Sender. None works only with a mail server that needs no user name: Arobin never sends a password without encryption.
  3. Enter the Recipients, separated by commas, and the Message language: Kurdish (Sorani), Arabic or English.
  4. Press Send a test message. Arobin answers "Test message sent." or says why not.
  5. Press Save.

Attendance and HR email

To send the attendance and HR messages from a mailbox of their own (for example hr@ of your company), turn on Enabled under Attendance and HR email and fill in its fields as for the email above, with that mailbox's user name, password and sender, and HR's recipients. Press Send a test message, then Save. From then on the daily summaries, attendance alerts, monthly reports and contracts or documents ending go through it; camera and system alerts stay with the email above. Turned off, everything goes through the email above again.

Telegram

  1. Turn on Enabled.
  2. Enter the Bot token: "Create a bot with @BotFather and add it to the chat or channel."
  3. Enter the Chat IDs of the chats the bot may write to, separated by commas.
  4. Choose the Message language, press Send a test message, then Save.

Alert rules

"A rule sends an alert when an event matches its cameras, objects, zones and hours. Each event is sent only once." Press Add a rule. A new rule watches persons, sends Alerts by both channels and waits 5 minutes between alerts from the same camera. For each rule set:

  • Name; Cameras, Objects and Zones ("Nothing selected means all.").
  • Events: Alerts, Detections or Alerts and detections.
  • Minutes between alerts from the same camera.
  • Days, and the hours From and To: "Leave both empty for all day. 22:00 to 06:00 runs overnight."
  • Send by: Email, Telegram or both.

Press Save.

System health alerts

The server checks itself every 30 seconds. Under System health alerts turn on Enabled, choose the channels and set Disk warning (%) (80 by default), Disk critical (%) (95), Temperature limit (°C) (85) and Camera disconnected for (minutes) (2). The same problems appear on the System status page under Needs attention:

  • Camera … is disconnected: no pictures for the set minutes. "Camera … is connected again" follows when it is back.
  • The recording disk is …% full, The recording disk is almost full (…%): the two levels. Arobin deletes the oldest recordings by itself to make room.
  • The recording disk keeps only … of the … days set for recordings: the disk is too small for the days that were set.
  • The server is running hot (… °C): check the airflow and the dust.
  • Errors on disk …: the disk may need replacing; tell your provider.
  • Recordings cannot be written to the disk: recording may have stopped; tell your provider at once.
  • The recording disk is not connected; recordings are going to the system disk (Arobin OS): the second disk prepared for recordings is unplugged, failed or was not found at start. The server checks every five minutes; the alert comes when two checks in a row find the disk missing. Check the disk and its cable, then restart the server. "The recording disk is connected again" follows when it is back.
  • Security updates were installed; restart the server from its screen to finish them (recording pauses for about two minutes) (Arobin OS): section 12.
  • The video engine does not answer: recording may have stopped: no answer for 90 seconds. An Arobin OS server restarts it by itself.
  • The last backup failed, No backup in the last two days: section 9.
  • The server hardware changed; contact support to renew the license, The license is not valid; no more cameras can be enabled: section 10.
  • Alert messages are not reaching …: … waiting since the connection failed: see below.

When the internet is down

A message that cannot be sent waits on the server for up to a day and goes out when the connection is back. The Delivery card shows, per channel: Nothing sent yet, All messages delivered; the last one at …, … messages waiting since …; the connection is tried again, or … messages could not be delivered within a day (last attempt …). Messages a channel refuses for good (a wrong token or password, an unknown chat) are dropped at once; turning a channel off discards its waiting messages. After ten minutes of waiting, the System status page lists the channel under Needs attention.

7. Users and roles

Open Settings → Users.

Roles

  • Admin: "Full access to all features." An administrator changes the settings; the owner settings (support access, Arobin Connect, face recognition, updates, attendance settings) are for the owners only (see below).
  • Viewer: "Limited to Live dashboards, Review, Explore, and Exports only." A viewer sees all cameras and changes no settings.
  • A custom role: a viewer who sees only certain cameras.

Adding a user

Press Add User, enter the Username (letters, numbers, periods and underscores only), the Password and Confirm Password (at least 12 characters), choose the role and save. In the table, Change user role moves a user between roles, Reset Password gives a user a new password, Delete user removes the account.

Camera access per user

  1. Open Settings → Roles (Viewer Role Management) and press Add Role.
  2. Enter the Role Name and tick the Cameras: "Select cameras this role has access to. At least one camera is required."
  3. Back in Users, give the role to the user with Change user role.

The user then sees only those cameras everywhere, in the search too. Edit Cameras changes the list later. If a role is deleted, its users become ordinary viewers with all cameras.

Owners and attendance roles

Open Settings → Owners and roles.

  • Owner: the administrators that existed when this page first started are the owners. An administrator you create later is an owner only when an owner ticks Owner. Only an owner changes support access, Arobin Connect, face recognition, updates, the attendance settings and these roles. The last owner cannot be removed.
  • HR: the attendance of every employee: employees and photos, schedule, holidays, leave, review, reports and closing months.
  • Payroll (with HR ticked): also sees and works out pay (Attendance → Payroll). The owners always may; HR without it sees no pay.
  • Manager of the departments: the board, the review, manual punches, leave and reports of the ticked departments only. Other employees do not appear for this account anywhere.

An HR or department manager account can be a viewer account. Only an owner can change the password, role or account of an owner or of an account with a role; a user still changes its own password. If no owner can sign in, at the server's console: arobin-agent people owner add NAME (the account must be an administrator).

The employee page

Each employee can have an account of their own on the employee page, at the Arobin address followed by /me/ (for example 192.168.1.20/me/). It shows only that employee's days, times and annual leave balance; the employee asks for leave there, and, if allowed, checks in and out from there when working outside the office. An employee has no Arobin account and never sees a camera.

  1. HR or an owner opens the employee (Attendance → Employees) and, under Employee page, presses Make an account. Tick "May check in and out from the page" only for those who work outside the office.
  2. A setup code appears once (for example ABCDE-23456). Copy puts a short message with the address, the employee code and the setup code on the clipboard. The code works once, for 7 days.
  3. The employee opens the page, presses "First time", types the employee code, the setup code and a password of at least 10 characters.

A forgotten password: New setup code (the old password stops working). Disable stops the account without deleting it. After 5 wrong passwords the account waits 15 minutes.

Leave requests appear in Attendance → Leave requests for HR, the owners and the manager of the employee's department. Approve records the leave (as if HR had entered it); Refuse asks for an answer, which the employee sees. A check-in from the page waits in Review until someone confirms it.

Contracts and documents

With the HR module of the license, Attendance → Contracts and documents (owners and HR only; a department manager does not see it):

  1. Ending soon at the top lists the contracts, probation periods and documents that end in the next 60 days, and those already past. Press a row to open the employee.
  2. Choose the employee. Under Contracts, Add a contract: the kind (permanent, fixed term, probation, daily wage), the dates, and if you like the weekly hours and the notice period. A renewal is a new contract: keep the old one as history. Fill Ended early on and Why it ended only when a contract ended before its date.
  3. Under Documents, Add a document: the type (signed contract, national ID, passport, residency, certificate, medical certificate, CV, other), the number and expiry date if it has one, and the file (PDF, JPEG or PNG, at most 10 MB). Open shows the file; each opening is recorded in the activity log.

When the attendance messages are on, Attendance → Settings → Contract or document ending in (days) sends an alert that many days before (30 by default, 0 for none) and again on the day. The employee sees their own contracts and documents on the employee page, without changing them.

Contract templates

With the HR module, the owners and HR write each kind of contract once, under Attendance → Contracts and documents → Contract templates → Show templates:

  1. The company letterhead: the company name, its address and who signs for it (name and title), which every contract prints, and its phone, email, website, registration number, a main and a second colour and a line for the footer (for example "Confidential"). Upload the logo (PNG or JPEG, at most 10 MB): a white background and the empty margin around it are taken away by themselves, and its colours are offered as round buttons next to the colours (they also fill colours not chosen yet). Every PDF (contracts, time sheets, payslips, reviews) then carries the logo at the top, a band in the company's colours, and the contact details and that line in the footer; a contract also gets a reference number (HR-00012). See a contract on the letterhead shows how it looks.
  2. New template: a name, the department it is for (pick one or type a new name; empty for all departments), the kind of contract, and the defaults a contract made from it gets: its length in months (fixed term or probation), the probation months, the weekly hours and the notice days.
  3. Write the title and the text in کوردی, العربية and/or English (at least one). Each line is a paragraph; a line starting with "# " is a heading. Press a field under the text (Name, National ID, Start, Salary...) to put it in: it is filled in from the employee's records when a contract is made. A field with nothing recorded prints as a line to fill in by hand. The salary is filled in only for the owners and HR accounts with Payroll.
  4. A template no longer used can be archived; one used by a contract cannot be deleted.

For an employee, fill in Personal details (national ID, birth date, nationality, phone, email and its language, address, emergency contact): they are kept encrypted and fill in the contracts. Then Add a contract and choose the Contract template: it fills in the kind, hours, notice and dates from the start date; check them and Save. On the contract, Contract PDF downloads it to print and sign, Email to the employee sends the PDF to the employee's own email address (through the attendance and HR mailbox; never by Telegram), and Make the text again fills the template in anew after a change. The employee can also download it on the employee page.

New employees through the Telegram bot

With the HR module, a new employee can register themselves in the site's Telegram bot (the one set up under Settings → Alerts → Telegram), and HR approves what they sent, under Attendance → Onboarding. Each site needs its own bot: a bot token also used by another program or another Arobin server makes them take each other's messages.

  1. New invitation: who it is for (only for you), the bot's language, and the department, position, contract template and start date. Make the link gives a link and a QR code: send the link to the person (WhatsApp, SMS, email) or let them scan the code. It is shown only once and works once, for one person, for 14 days.
  2. In Telegram the person picks their language, agrees to what is collected, answers the questions (name, birth date, national ID, phone, email, address, emergency contact...), sends photos of both sides of their ID card, their documents (passport, residency, certificates, CV...), and, if they agree to face recognition, 5 selfies the bot checks. Then they press Send.
  3. Under To check, open the registration: the answers, the ID card, documents and selfies. Then:
  • Approve: type the employee code, check the department, position, template and start, and choose what to do: make the contract from the template, email it to the employee, enrol the face from the selfies, make the employee page account. The employee is made with everything; the bot tells them, with their employee page code. The contract goes by email only, never by Telegram.
  • Ask for a part again (personal details, ID card, documents, selfies), with a note: the bot asks them again.
  • Refuse, with a reason the bot sends them.
  1. Cancel the invitation stops a link that is no longer needed. What was sent is kept encrypted and deleted when you decide, or after 90 days.

Changing one employee's contract

On a contract made from a template, Change the text opens its text in each language, with the fields such as {{name}} that are filled in with the employee's details. Change it by hand, or write in your own words, in any language, what to change (for example "for this employee the working week is 30 hours, and add a clause about the company car") and press Ask the assistant: it changes the text in each of the contract's languages and says what it changed. Check it, press Show as it will print to see it with the employee's details, then Save; nothing is kept before. Make the text again goes back to the template and drops these changes.

The writing assistant uses OpenAI with your company's own API key. An owner enters it under Contracts and documents → Contract templates → Show templates → Writing assistant (OpenAI), with the model (empty for the default). Only the contract's text with its fields goes to OpenAI, with what you wrote; the employee's name, ID, phone and salary never do. Without a key, the text can still be changed by hand.

Payroll

With the HR module, Attendance → Payroll is for the owners and for HR accounts with Payroll ticked under Settings → Owners and roles. Other accounts never see pay.

  1. Salaries: choose the employee and Enter the salary: from which month, the currency (IQD or USD), the basic salary and any fixed monthly allowances (transport, housing). A raise is a new salary from its month. Under Email for pay notices, type the employee's own email address and the language of their emails.
  2. Pay rules (once): days in a month and hours in a day (a day's pay is the salary / 30, an hour's a day's / 8 by default), which absences and lateness are deducted, the overtime rate (1.5 by default), social security and tax.
  3. During the month, under Additions and deductions: choose the employee and the kind: Bonus, Overtime (hours), Fine, Hours not worked, Days not worked, Advance on pay, or another addition or deduction. Type the amount, or for hours and days their number (Arobin works out the amount from the salary), and a reason. With Email the employee about it now ticked, the employee gets an email at once with the amount and the month's net pay as it stands. The email goes through the attendance and HR mailbox (Alerts page), or the main email while that one is off.
  4. After the month, close it on the Report tab, check the Payslips (press a row for its lines) and press Approve the pay. The payslips are kept as they are; each employee sees theirs on the employee page. Payslips (PDF) and Payroll register (PDF) download them. To correct an approved month, Withdraw the approval with a reason, change it and approve again.

Staff reviews

With the HR module, Attendance → Staff reviews is for the owners, HR, and a department manager for the employees of its departments.

  1. Due soon lists the reviews due in the next 30 days or already late: the end of probation (from the employee's current contract) and the yearly review (a year from the start date, then from the last yearly review). Press Start the review on a row.
  2. Or under Start a review, choose the employee, the kind (yearly, end of probation, other), the period and the due date. With Ask the employee for a self-review first ticked, the employee first scores themselves on the employee page (tab "My reviews") and sends it.
  3. Press a review in the list to open it. Score each criterion from 1 (poor) to 5 (outstanding), write your comments and the goals for the next period, and for the end of probation choose the outcome (confirmed, probation extended, employment ends). Save the draft keeps it; Finish the review closes it, and the employee then sees it on the employee page. PDF downloads it to print and sign.
  4. The owners and HR set the criteria once under Review criteria (six by default: quality of work, productivity, attendance and punctuality, teamwork, communication, initiative; add your own, up to 15). A finished review can be reopened only by the owners or HR, with a reason.

Equipment, letters and warnings

With the HR module, three more parts appear for an employee under Attendance → Contracts and documents (owners and HR only):

  1. Equipment: Hand over equipment records what the employee receives from the company (laptop, phone, SIM card, keys, vehicle, access card, tool, uniform...), with its serial number, value and the day. Handover receipt (PDF) prints the list for the employee to sign. When it comes back, Record its return with the day and the state (good, damaged, lost); Return receipt (PDF) prints what came back. The notes are for HR only. The employee sees their equipment on the employee page.
  2. Letters: an employee asks on the employee page for an employment certificate, a salary certificate or an experience letter, in Kurdish, Arabic or English, for whom (a bank, an embassy) and why. The requests appear at the top of Contracts and documents under Letters employees asked for: Issue makes the letter on the company letterhead with today's facts (position, start date, salary), or Refuse with an answer the employee sees. HR can also Write a letter directly. An issued letter keeps its facts as they were; Download PDF prints it to sign and stamp, Email to the employee sends it to their own address. A salary certificate needs an account that sees pay.
  3. Warnings: Record a warning: the level (verbal, written, final), the day, the reason and what is expected. Download PDF prints the warning letter for the employee to sign; Email to the employee sends it. The employee confirms on the employee page that they received it, with a comment if they wish (confirming is not agreeing); after that it can no longer be changed.

Leaving and job history

Job history shows, in order, the start, each salary (with the raise, for accounts that see pay), each promotion or transfer and the leaving. Record a change: the kind (promotion, transfer, change of title), the day it starts, the new department and position. A change from today or earlier is made at once; a later one on its day. A change already made cannot be edited: record a new one.

Leaving: Record leaving with the reason (resignation, dismissal, end of contract), the day notice was given and the last working day. Arobin compares the notice with the contract (for example 10 days); for a resignation without that notice, the company rule deducts those days' pay. Tick the Clearance list as each step is done; "All company equipment returned" is ticked by itself when nothing is out. The Final settlement is worked out for you (the days of the last month, the annual leave not taken, the notice, the equipment not returned); Change the amounts to correct or add a line, Work out again after a change. Settlement PDF prints it for the employee, the manager and HR to sign. Complete: the employee leaves marks the employee as left (their face data is deleted and their employee page closes); it needs the equipment back first. Employees with a leaving in progress are listed at the top of Contracts and documents.

HR at a glance and company policies

At the top of Contracts and documents, HR at a glance shows the employees working, by department; who joined and left in each of the last twelve months; the birthdays (from the personal details) and work anniversaries of the next 30 days; and what waits for you: contracts and documents ending, leavings in progress, letters asked for, warnings not confirmed, equipment out and policy confirmations missing. Choose a name to open that employee.

Company policies: Write a policy with its title and text (each line a paragraph), for every employee or only some departments. Tick Employees must confirm reading it for rules they must sign for, and In force to show it to them. Employees read the policies on their employee page and press I have read it and will follow it. Who confirmed lists each employee and their answer. Changing the title or text makes a new version, and the employees confirm it again. Download PDF prints a policy on the company letterhead.

The support account

The list in Users includes the Arobin Support account (normally arobin.support). Nobody can delete it or change its password or role from the web: the attempt is refused and logged as Change to the support account refused. You control it with the support access switch (section 8).

8. Support access

Open Settings → Support access in the Arobin section (the Support entry in the menu opens the same page). "Arobin Support can sign in to this system only while you allow it. Access lasts 24 hours, and you can end it at any time. You are told about every support sign-in by email or Telegram, and it is listed below."

The 24-hour switch

  • Allow Arobin Support for 24 hours opens the window. The page shows On until … and Turned on by ….
  • Extend to 24 hours from now restarts the 24 hours.
  • End support access now closes it at once; every support session ends with it.

Only your administrators can use these buttons; Arobin Support cannot open or extend its own access, and while the window is closed a support sign-in is refused. The console at the server has the same switch: 6) Arobin Support: allow sign-in for 24 hours, then a) Allow Arobin Support to sign in for 24 hours or e) End support access now. Being at the server counts as your consent.

What Arobin Support can see

During the window, Arobin Support signs in with its own account and sees everything you see, plus the technical pages of the recording software (its logs, processes and settings). It cannot change accounts, passwords or roles (the attempt is refused and logged), so it cannot set a new administrator password either (section 14). It cannot change Arobin Connect, face recognition, the support access switch or the list of support accounts, and it cannot install updates.

You are told by email and Telegram of every change of support access, every support sign-in and every support sign-in refused because support access was off. The System status page shows Arobin Support access and the Last support sign-in.

The activity log

The Activity card lists, with Time, Event, Account and From: Support access turned on by …, Support access turned off by …, Support access ended (24 hours), Arobin Support signed in, Sign-in refused: support access was off, Sign-in failed: wrong password, Change to the support account refused, the changes to your accounts (Account created by …, Account deleted by …, Password changed by …, Role changed by …), Administrator password set anew at the server (console) and the face recognition changes.

9. Backups

Open Settings → Backup in the Arobin section. "Every night at 02:30 Arobin makes an encrypted backup of its settings, users, license and database on the recording disk and keeps the last 14."

What is in a backup

The cameras and their settings, the users, the events, the license, the alert settings, the support accounts, the Arobin Connect phones, the activity log, the root certificate and, on Arobin OS, the Wi-Fi settings. The recordings are not in the backup: they are too large. The Face Library photos are not in it either: after a restore, add the people again. Each new backup is also copied to the server's system disk, which keeps the newest seven. The Backups card shows Last successful backup, Last attempt, the Newest backup file and Backups kept.

The USB drive labelled AROBIN-BKP

To keep a copy outside the server, connect a USB drive whose name (its file system label) is AROBIN-BKP. "The newest backup is copied to it every night." The drive keeps the newest 30. The USB copy card shows the time of the last copy, or No USB drive.

The recovery key

The backups are encrypted with your site's backup key. The installer showed it once, as a recovery key that looks like ARB1-XXXXX-…: "Backup recovery key. Write it down and keep it safe; it is needed to restore on new hardware". Keep it away from the server, for example with your license agreement. Without it no backup can be restored, and on an Arobin OS server it is not shown again.

Restoring from the console

A restore is done at the server, not in the web interface:

  1. Connect the USB drive labelled AROBIN-BKP with the backup (the console looks for backup files on a drive with this label only, at its top or in its arobin folder) and the Arobin OS installer USB drive, and start the server from the installer. When the installation is finished the server switches off: remove the installer drive, keep the AROBIN-BKP drive connected, and switch the server on again.
  2. On the console's setup screen choose 2) Restore a backup (USB drive AROBIN-BKP, or the copy kept on this server).
  3. The console lists the backups, newest first, each marked USB drive or this server. Answer Backup to restore with the number (Enter takes the first).
  4. The console says "Installing Arobin. This takes a few minutes; do not switch the server off." and asks for the key at Backup recovery key (ARB1-…). A damaged file or a wrong key restores nothing. The cameras and users come back as they were, with the Wi-Fi settings; a backup made by another Arobin release restores too. On new hardware the license enters its 14-day grace period (section 10).

10. License

Open Settings → License in the Arobin section. The Current license card shows the state — Valid, Grace period, Not valid or No license — with the Customer, License number, Cameras, Modules, Issued and Updates until. The System status page shows the state too, with the customer, the cameras enabled out of the limit and Updates until.

What never stops, and the camera limit

"The license never stops recording or live view." Without a valid license, the cameras already enabled keep recording and streaming, health alerts keep coming, and every page stays open. What a missing or invalid license stops: enabling one more camera, event alerts by email and Telegram, face recognition, and new updates. The Aron Fund relay for phones needs the license too (section 11).

The license sets how many cameras may be enabled at the same time. Enabling a camera beyond the limit is refused; disabling a camera is always allowed, and the limit never stops a camera that already runs. The optional modules are Email and Telegram alerts and Face recognition; without a module its feature is off. Arabic machine translation for the search comes with packages M and L and does not depend on the license, even when the license lists Arabic search translation.

Getting and installing a license

  1. Under License request, press Copy. "Send this code to Aron Fund to receive the license file for this server." The code holds the site name and a fingerprint of the hardware, no serial numbers.
  2. Send the code to your Arobin provider. You receive a file ending in .lic, made for this server only.
  3. Under Install a license file, press Choose license file and pick the file. Arobin answers License installed. No internet is needed.

The 14-day grace period

When the server's hardware changes — the disks moved to a new server, a restore on new hardware — the license keeps working for 14 days. The page shows Grace period with the date it ends, the System status page shows Grace period until …, and a health alert is sent. Send a new license request within those days. Afterwards the license is Not valid until the new file is installed; recording and live view continue even then. Replacing a single disk or network card does not start the grace period.

11. Arobin Connect for phones

Open Settings → Arobin Connect in the Arobin section. "See your cameras from your phone, from anywhere, through an encrypted WireGuard connection to this server. Each phone gets its own key and is added with a QR code. Phones reach only the Arobin web interface, never the cameras or your network directly."

Relay and direct

  • Through the Aron Fund relay: the server opens an encrypted connection to Aron Fund's relay and your phones reach it through there. Nothing changes on your router. The relay passes only encrypted packets and cannot see your cameras or pages. It needs this server's license: without one the page says The relay needs this server's license. Install the license first.
  • Direct (public address): your site has a fixed public address or a dynamic DNS name, and your router forwards UDP port 51820 to the server. Enter it under Public address of this site. On Arobin OS the port is always 51820.

If the page shows no relay switch, no relay is set up for this server; only the direct way is available.

Turning it on and adding a phone

  1. Turn on Arobin Connect on. Leave Through the Aron Fund relay on, or enter the Public address of this site, or both. Press Save. The page shows Arobin Connect is on. Phones open … and, with the relay, Connected to the relay: phones can reach this site without a public address.
  2. Install the WireGuard app on the phone (App Store or Google Play).
  3. Under Phones, type a Phone name and press Add phone.
  4. A window Connect … shows a QR code: "This code contains the phone's key and is shown only now. Scan it, then close this window." With both ways set up, two codes appear: "Add both to the WireGuard app. Use "Through the relay"; if the relay is not available, switch to "Direct"."
  5. In the WireGuard app, add a tunnel by scanning the code, and turn it on.
  6. Open the Arobin Connect address 10.77.0.1 in the phone's browser (install the root certificate on the phone first, section 2). Press Done.

Each phone has its own key, kept only in the code (or the Download configuration file); the server keeps the public half, so a code cannot be shown again. Up to 50 phones can be added. The list shows last connected … or never connected for each.

Removing a phone

Press Remove phone and confirm "Remove …? It will no longer be able to connect." Do it at once for a lost or sold phone. Only your administrators can turn Arobin Connect on or off and add or remove phones; every change is logged and reported by email and Telegram.

12. Updates

Arobin OS servers install signed updates from Aron Fund. Only what changed is downloaded; recordings, settings and the license stay. A server without Arobin OS is updated with the installer; its System status page says so.

The System page

Open System status. The Updates card shows the Installed version and the last check: This is the newest version. or Arobin … is available (released …). with the release notes. The server checks once a day by itself but never installs on its own.

  1. Press Check for updates (online) or Check the USB drive.
  2. Press Install update. Arobin asks: "Install Arobin …? Recording pauses for a few minutes while the services restart. If the new version does not work, the server goes back to this version by itself."
  3. The card shows Downloading the update…, Installing the update…, Checking the new version… and, if needed, The new version did not work: going back…. You can close the browser; the update continues on the server.

Only your administrators can install.

The USB drive labelled AROBIN-UPD

Without internet, an update comes on a USB drive named AROBIN-UPD with the update files from Aron Fund. Connect it and press Check the USB drive. The console offers the same under 3) Updates: check for a new Arobin version, or install it: c) Check for an update on the internet, u) Check the USB drive (label AROBIN-UPD) and, when an update is available, i) Install the update.

What pauses

Recording continues while the update is downloaded and prepared. It pauses only for a few minutes at the switch to the new version: Recording continues; it pauses only for a few minutes at the switch. The operating system's security fixes install daily by themselves and never restart the server on their own. Some of them (a new kernel or a core library) are in use only after a restart; the server checks for this every hour. Then the System status page lists Security updates were installed; restart the server from its screen to finish them (recording pauses for about two minutes), one alert is sent, and until you restart, the console shows "! Security updates were installed that need a restart: choose "Restart"." Restart with 4) Restart on the console; a notice tells you when the security updates are complete.

When an update is not installed

  • Your license includes updates released until …: the update is newer than that date; everything keeps working, and renewing the license brings new updates.
  • This server has no valid license: updates are installed only with a license. Everything else keeps working.
  • The update server cannot be reached. Check the internet connection, or use a USB drive (AROBIN-UPD).
  • The update is not signed by Aron Fund. It was not installed.

13. Face recognition

Face recognition is off by default. Open Settings → Face recognition in the Arobin section. It writes the names of the people you add on the Face Library page on the events; "face photos and recognitions stay on this server". The Status card shows two checks: The license includes face recognition. and The approved face models are installed. Both must be ticked before it can be turned on.

The consent checklist

Face recognition processes biometric data. Under Before turning it on: "Confirm each item; the confirmation is written to the audit log with your name."

  • Signs at the entrances say that cameras with face recognition are in use.
  • The people concerned (employees, regular visitors) have been told what is recorded, why, and for how long.
  • Every person I add to the Face Library has given written consent, kept on file.
  • I have decided how long face photos and recognitions are kept, and I will delete the data of a person on request or when they leave.

Then press Turn face recognition on. "Turning face recognition on restarts the video engine: recording pauses for about half a minute." The page then shows Face recognition is on. Cameras: … and Checklist confirmed by … on …. Turn face recognition off turns it off on every camera. If a new license has no face module, Arobin turns face recognition off by itself; recording and live view never stop.

The people list

Once face recognition is on, press Open the Face Library to add people (also Face Library in the menu). There you Add Face with a name and Upload Image of the person looking straight at the camera. Recent Recognitions shows the faces seen lately; Train Face assigns one to a person so that recognition improves. Rename Face and Delete Face change the list.

Deleting a person's data

Under Delete a person's data: "Removes what this server holds about a person: their photos and templates in the Face Library, the recent recognition attempts named after them, and their name on every past event. Recordings keep their own retention; alerts already sent and backups are not changed. No license is needed."

  1. Type the Name, as in the Face Library.
  2. Press Delete all data of this person and confirm. This cannot be undone.
  3. A receipt under What was removed counts the photos, the recognition attempts and the events cleared. With face recognition off, it says: Face Library: the photos could not be removed while face recognition is off. Turn it on, delete again, then turn it off.

14. What to do when

A camera is disconnected

The System status page shows the camera as Disconnected and a health alert comes. Check the camera's cable and the switch that powers it. If the camera shows Off, someone turned it off in Live: open it and press Turn Camera On.

The disk is full

Arobin deletes the oldest recordings by itself; recording does not stop. The alerts about a full disk mean the disk is too small for the days you wanted: keep fewer days, or ask your provider for a larger recording disk. Recordings cannot be written to the disk is different: recording may have stopped; tell your provider at once.

No alerts arrive

  1. On the Alerts page, check that the channel is Enabled and press Send a test message; the answer names the cause when the settings are wrong.
  2. Look at the Delivery card. Waiting messages mean the server cannot reach the internet or the mail server.
  3. Event alerts need the Email and Telegram alerts module (License page).
  4. Check the rule: its cameras, objects, days and hours, and the minutes between alerts from the same camera.

I forgot the administrator password

Nobody can read a password back, and Arobin Support cannot set a new one. If another administrator exists, that person opens Settings → Users and presses Reset Password for your account. If not, go to the server's screen and choose 7) Administrator password: set a new one (lost password). Being at the server counts as your consent. Answer y to "Set a new administrator password now? (y/n)": the console shows the new password once, as admin / <new password>. Sign in with it and change it at once (user menu, Set Password). The administrator account admin gets the new password (it is made again if it was deleted). You are told by email and Telegram, and the activity log shows Administrator password set anew at the server (console). On a server without Arobin OS, your provider does the same on the server with the command admin-password reset.

The browser shows a certificate warning

The device does not trust the server's root certificate yet. Download it from the setup page and install it as in section 2, then restart the browser. If the warning stays, use the address shown on the server's screen, or ask your provider.

I cannot reach Arobin from my phone

On your own Wi-Fi, the phone must be on the network connected to the server's customer port; use the same address as on the computer. From outside, check in the WireGuard app that the Arobin tunnel is on, then open the Arobin Connect address 10.77.0.1. On the Arobin Connect page, check for Arobin Connect is on and, with the relay, Connected to the relay; if the page says the relay cannot be reached, switch the phone to the Direct (public address) tunnel if you have one.

The server restarted

After a power cut, Arobin starts again by itself; at the start the server repairs its file systems without asking. After a kernel failure the server restarts by itself after 15 seconds, and where the board has a hardware watchdog, a server that hangs restarts by itself too. The server's screen then shows "Arobin is running." and the System status page shows Running for (how long the video engine has been running). The status page should say Everything is working normally. Updates never restart the server; when security updates need a restart, you restart it with 4) Restart on the console (section 12).

15. Contact and legal

Contact: your Arobin provider (the address is on your license agreement)

The Legal information entry in the menu opens the Legal information page. It states that Arobin is proprietary software of Aron Fund, that its use is governed by your license agreement, and it lists the open-source components Arobin includes, each with its license text. It also has a source code offer for the programs under the GNU licenses, marked there as a draft awaiting legal review. The page is stored on the server and opens without internet. The setup page links to it too, under Open-source licenses.

Back to top ↑