# Getting Started

## Before you begin

1. Request a free trial BFE account by emailing <info@bluefletch.com>.
2. Once you have a BFE account, log into the BFE Portal using your account credentials.
3. Follow the steps below to quickly get Playbook Agent up and running on your device.

## About this task

This tutorial describes how to set up and activate BlueFletch Playbook Agent to manage your Android Zebra devices with a built-in 2D scanner. The BlueFletch Playbook Agent installation process consists of several components, including the Playbook Agent application, configuration files, and other dependencies.

#### In the instructions below, you'll learn how to:

* Install Playbook Agent on a device.
* Register a device in a deployment group.

### Install the Playbook Agent App <a href="#install-the-playbook-agent-app" id="install-the-playbook-agent-app"></a>

1. Download the Playbook Agent APK file from the BlueFletch Portal website.&#x20;

2. Sideload the APK file to the device using this ADB command, with the file location of the APK download in lieu of the placeholder:

   <pre class="language-json"><code class="lang-json"><strong>adb install -g &#x3C;path/to/file.apk>
   </strong></code></pre>

3. Enable the Unknown Sources toggle in the Security settings of the device.\
   ![Device Settings](https://emsdocs-staging.bluefletch.com/assets/img/playbookApp/2_settings.png)

   > &#x20;

4. After the install is completed, open the application. The device is now ready to be registered.

### Register the Device in a Deployment Group <a href="#register-the-device-in-a-deployment-group" id="register-the-device-in-a-deployment-group"></a>

1. Go to the BlueFletch Portal and click on Deployment Groups.&#x20;
2. If the organization already has a deployment group created and assigned to a playbook, click the group's Show Barcode button.&#x20;
3. Open the Playbook Agent app on the device and scan the barcode.

![homepage](https://emsdocs-staging.bluefletch.com/assets/img/playbookApp/3_pbStaging.png)

4. The device will be registered in the deployment group and will run the assigned playbook.

{% hint style="info" %}
Deployment Groups are managed within Playbook MDM in the BlueFletch Portal. For a complete walkthrough of the deployment process, see the documentation on deploying the BlueFletch Enterprise suite from the Portal.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bluefletch.com/bluefletch-enterprise/product-guides/playbook-agent/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.