Add a machine

How to add a machine on the Machines page: choosing the product, naming the machine, and for es-python choosing whether its build is detected on the host (the default) or picked by you.

The add-machine toolbar

You add a machine from the toolbar at the top of the Machines page. Fill in the fields from left to right and click Add machine; the new machine appears at the top of the list with the status created.

Which fields you see depends on the product you pick. es-python asks for a Name and a Python choice, with Distro and Arch behind Advanced: choose the build yourself; es-chromium asks only for a Name.

The toolbar is not shown at all if your account has no product enabled. See Products.

Product

The Product dropdown picks which EyalSec product this machine will run. It lists only the products enabled on your account, and the fields after it change to match your choice.

If your account has a single product, there is nothing to choose and the dropdown is not shown. If a product you expected is missing, it is not enabled for your account; email sales@eyalsec.com to add it.

Name

The Name is how the machine is labelled everywhere in the dashboard, including on every event it reports. Use anything from 1 to 128 characters that helps you recognize it, for example prod-web-1 or my-laptop.

You can rename a machine at any time; its events stay attributed to it. Pressing Enter in the box is the same as clicking Add machine.

The build is detected at install

For es-python you do not need to know anything about the host in advance. Leave Advanced closed and Python on Match this host (recommended), and the install command, when you run it on the host, reports the host's distribution, version, processor and Python version. The server then picks the build:

1. the build for that exact distribution and version, when there is one;
2. otherwise the newest build the host can run, judged by its C library (glibc) version, preferring the same family (for example an Ubuntu build for Linux Mint);
3. otherwise the install stops before downloading anything and says what it detected and which systems are supported.

For Python it uses the host's own python3 version when a build exists for it, then Python 3.13, then the newest version available. The row shows detected at install until then, and the real target and version from the moment the install starts. When a host cannot be served, nothing is downloaded or installed and the command stays valid until it expires, so you can run it on a supported host instead.

Advanced: choose the build yourself

Click Advanced: choose the build yourself to show Distro and Arch and pick the build yourself, for example to prepare a machine for a host you cannot reach yet. A machine added this way installs exactly the build you chose. Click it again to go back to detection.

Distro

Distro (es-python, under Advanced) is the Linux distribution of the host you will install on. EyalSec publishes a runtime matched to each distribution, so pick the one the host actually runs.

The list offers:

If your host runs a close relative of one of these (a derivative that declares the same family), pick that family. The installer checks the host before it installs and stops with a clear message if the build cannot run there.

Arch

Arch (es-python, under Advanced) is the host's processor architecture: x86_64 for most servers, desktops and laptops, or aarch64 for 64-bit ARM machines such as AWS Graviton instances or a Raspberry Pi running a 64-bit OS. Every distro in the list is offered for both.

Run uname -m on the host if you are not sure: it prints x86_64 or aarch64 (some systems print amd64 or arm64, which mean the same things).

Python

Python (es-python only) is the Python version the machine will run. The first option, Match this host (recommended), uses the host's own Python version when a build exists for it, and Python 3.13 otherwise. The other options pin a version, shown as Python 3.13, Python 3.12 and so on; the supported versions are 3.9, 3.10, 3.11, 3.12, 3.13 and 3.14.

With Advanced open, the list shows only the versions actually published for the distro and arch you picked, so it can change when you change either; your choice is kept if the new target has it too. A pinned version that turns out not to be available for the detected host stops the install with a message naming the versions that are.

Pick a version when your code is written for one. You can install several versions on one host by adding one machine per version; each gets its own command name (see Where it installs). The version is shown on the row as the Python badge, as match host until the install decides it.

Add machine

Clicking Add machine creates the machine. For es-python, the new row appears with status created and its install panel opens right under it with the command already generated, so you can copy it straight away (see Install es-python). For es-chromium, click the row's Install button when you are ready (see Install es-chromium).

Sources watched from the start

A new es-python machine watches network input (socket) and file reads (file), the two ways most programs take data from outside, so it reports from its first run. Every other source starts off. Change any of them in the machine's Configure window.

If you have already set socket or file for all your machines on the Filters page, a new machine follows that setting and is not given its own.

Machine limits

How many machines you can add is set by your plan, and the limit counts each product separately: es-chromium machines never use up es-python slots, and the other way round. The count line on the Machines page shows how many you have used.

When a product is at its limit, Add machine is refused with:

Machines in use: 5 of 5. Email sales@eyalsec.com to add more.

An account that has no plan yet cannot add machines at all, and sees "Your account has no active plan yet, so it cannot add machines. Book a live demo or email sales@eyalsec.com to get set up." See Plans and No plan yet.

Deleting a machine frees its slot. Reinstalling one does not use a new slot.

Other messages

A few other refusals can appear in a pop-up when you click Add machine. Each names the problem: