Docs
Enterprise
How-to guides
Register and install your first endpoint

Register and install your first endpoint

Get started by creating your organization, configuring a policy, and deploying your first endpoint.

Before proceeding, we recommend familiarizing yourself with key concepts in our Glossary.

Create your organization account

  1. Go to the Zen Enterprise Dashboard.
  2. Register a new administrator account or sign in if you already have one.

After registration, you will have access to the admin dashboard.

Create your first policy

  1. Open Policies.
  2. Click Create policy.
  3. Give it a name (e.g., “Default”).
  4. Navigate to the newly created policy by clicking its card in the list.
  5. Add one or more filter lists:
    • Click “Add filter list”.
    • Choose from the built-in presets or add a custom URL.

Tip

See our Recommended filter lists for suggestions on effective filter lists to use.

You now have a baseline configuration your endpoints will use.

Generate a deployment token

  1. Navigate to Deployment tokens.
  2. Click Create token.
  3. Name the token (e.g., “IT Department”).
  4. Select one or more policies to assign to endpoints that will use this token.
  5. Save the token.

Install the agent on an endpoint

  1. Open PowerShell as Administrator.
  2. Run (replace <YOUR-TOKEN-HERE> with the token from the previous step):
    Set-ExecutionPolicy Bypass -Scope Process -Force;
([System.Text.Encoding]::UTF8.GetString((Invoke-WebRequest -Uri 'https://dl.irbis.sh/install.ps1' -UseBasicParsing).Content)) | 
  Set-Content "$env:TEMP\Install-ZenEnterpriseAgent.ps1";
Invoke-Expression "& '$env:TEMP\Install-ZenEnterpriseAgent.ps1' -DeploymentToken '<YOUR-TOKEN-HERE>'"
  3. Restart the computer.

The script downloads and installs the agent, register the endpoint with your organization, and begins enforcing the assigned policies.

Note the Endpoint ID shown at the end of the installation process – you can use it to identify the endpoint in the dashboard.

The macOS agent is a work in progress.
The Linux agent is a work in progress.

Verify the endpoint in the dashboard

  1. Open Endpoints.
  2. Confirm the newly registered endpoint shows:
  • Policies assigned from the deployment token.
  • Hostname.
  • Endpoint ID.

Test policy enforcement

On the deployed endpoint:

  1. Visit a website known to serve ads or trackers.
  2. Confirm that unwanted content is blocked.

Next steps

  • Add more policies for different departments.
  • Create additional deployment tokens for segmented rollouts.
  • Roll out the agent fleet-wide using RMM/MDM tools.
Uninstall the agent from an endpoint