> ## Documentation Index
> Fetch the complete documentation index at: https://docs.farmsync.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Device Allocation

> Guide on how to allocate devices to Licenses in FarmSync

## Overview

Device Allocation is a feature that allows you to allocate devices to activated Licenses. There are 2 different allocation methods depending on the License type:

* **Time-Based License**: Flexible allocation of usage time for multiple devices
* **Device-Based License**: Allocation of fixed device slots

<Info>
  Each License type has a different allocation method. Please choose the guide that matches your License type.
</Info>

## Time-Based License Allocation

### Steps to allocate devices for Time-Based License

<Steps>
  <Step title="View the My License table">
    1. Check if your License Key has been activated

    <Check>
      Ensure the Time-Based License has been successfully activated before performing allocation.
    </Check>
  </Step>

  <Step title="Click on Manage Time Allocation">
    1. Find and click on **Manage Time Allocation** in the **Action** column

    <Frame>
      <img src="https://mintcdn.com/farmsync-bb893348/04MM8D0921TGN18C/images/user/time-based-key.png?fit=max&auto=format&n=04MM8D0921TGN18C&q=85&s=45cb8c760e9ebedfa79e80bfb62054d4" alt="License management page in FarmSync" width="1485" height="101" data-path="images/user/time-based-key.png" />
    </Frame>

    2. After clicking, it will display a detailed table of your License Key, where you can check information and activate your devices

    <Frame>
      <img src="https://mintcdn.com/farmsync-bb893348/04MM8D0921TGN18C/images/user/detail-modal-time-based-key.png?fit=max&auto=format&n=04MM8D0921TGN18C&q=85&s=17eac2cbb9ea3126437e02325e8f45e2" alt="License management page in FarmSync" width="1180" height="773" data-path="images/user/detail-modal-time-based-key.png" />
    </Frame>
  </Step>

  <Step title="Activate new devices">
    1. After the device details table appears, look to the right where devices are listed - this is where you select the device you want to activate
    2. You can search for your desired device name or click **Expired only** to find expired devices
    3. With a **License Key**, for example, if you have 30 days and want to activate all 3 devices below, find and select the **Expired** devices, then click **Proceed to Time Allocation**:

    <Frame>
      <img src="https://mintcdn.com/farmsync-bb893348/04MM8D0921TGN18C/images/user/device-selection.png?fit=max&auto=format&n=04MM8D0921TGN18C&q=85&s=e2f57c830609c0fc01f4a01c0e8361d1" alt="License management page in FarmSync" width="796" height="596" data-path="images/user/device-selection.png" />
    </Frame>
  </Step>

  <Step title="Adjust time to match the total devices you want to allocate">
    1. After clicking, it will take you to **Time Allocation** to divide time for each device you selected.

    <Frame>
      <img src="https://mintcdn.com/farmsync-bb893348/04MM8D0921TGN18C/images/user/time-allocation.png?fit=max&auto=format&n=04MM8D0921TGN18C&q=85&s=9ceef51db598fb38d39adf5136d88fa3" alt="License management page in FarmSync" width="674" height="721" data-path="images/user/time-allocation.png" />
    </Frame>

    2. Currently, I have a 30-day key but want to divide it among 3 devices. That means 10 days per device, so we'll adjust using the slider to be less than or equal to 10 (depending on your key and selected devices)

    <Frame>
      <img src="https://mintcdn.com/farmsync-bb893348/04MM8D0921TGN18C/images/user/time-allocation-edited.png?fit=max&auto=format&n=04MM8D0921TGN18C&q=85&s=ba45e08881c930b4c710b62edebd4bee" alt="License management page in FarmSync" width="707" height="706" data-path="images/user/time-allocation-edited.png" />
    </Frame>

    3. Click **"Continue"** to proceed.
  </Step>

  <Step title="Confirm device allocation">
    At this step, just click **Allocation License** and you're done

    <Frame>
      <img src="https://mintcdn.com/farmsync-bb893348/04MM8D0921TGN18C/images/user/confirm-allocation.png?fit=max&auto=format&n=04MM8D0921TGN18C&q=85&s=4ab931a5738e9a62f78ba2c3b5167761" alt="License management page in FarmSync" width="683" height="571" data-path="images/user/confirm-allocation.png" />
    </Frame>
  </Step>
</Steps>

## Device-Based License Allocation

### Steps to allocate devices for Device-Based License

<Steps>
  <Step title="View the My License table">
    1. Check if your License Key has been activated

    <Check>
      Ensure the Time-Based License has been successfully activated before performing allocation.
    </Check>
  </Step>

  <Step title="Click on Manage Device Allocation">
    1. Find and click on **Manage Device Allocation** in the **Action** column

    <Frame>
      <img src="https://mintcdn.com/farmsync-bb893348/04MM8D0921TGN18C/images/user/device-based-key.png?fit=max&auto=format&n=04MM8D0921TGN18C&q=85&s=1886fb0cc3730930c69d4c2c190f2401" alt="Device-Based License management page in FarmSync" width="1493" height="89" data-path="images/user/device-based-key.png" />
    </Frame>

    2. After clicking, it will display a detailed table of your Device-Based License Key, where you can check information and activate your devices

    <Frame>
      <img src="https://mintcdn.com/farmsync-bb893348/04MM8D0921TGN18C/images/user/detail-modal-device-based-key.png?fit=max&auto=format&n=04MM8D0921TGN18C&q=85&s=0ae15bd2bec80d3f9297b4626be846ba" alt="Device-Based License details in FarmSync" width="1179" height="776" data-path="images/user/detail-modal-device-based-key.png" />
    </Frame>
  </Step>

  <Step title="Activate new devices">
    1. After the device details table appears, look to the right where devices are listed - this is where you select the device you want to activate
    2. You can search for your desired device name or click **Expired only** to find unactivated devices
    3. With a **Device-Based License**, you can activate the number of devices according to the slots purchased (check **Available Slots** on the right), select devices then click **Proceed to Device Allocation**:

    <Frame>
      <img src="https://mintcdn.com/farmsync-bb893348/04MM8D0921TGN18C/images/user/device-selection-lifetime.png?fit=max&auto=format&n=04MM8D0921TGN18C&q=85&s=f961a654adf17b612941094286a9085a" alt="Select devices for Device-Based License" width="766" height="467" data-path="images/user/device-selection-lifetime.png" />
    </Frame>
  </Step>

  <Step title="Review the devices you will allocate">
    Review the information you selected as well as the License Key information, then click **Continue** after confirmation.

    <Frame>
      <img src="https://mintcdn.com/farmsync-bb893348/04MM8D0921TGN18C/images/user/review-device-selection.png?fit=max&auto=format&n=04MM8D0921TGN18C&q=85&s=9fb02d1912c48219baa81a9e0242ddf5" alt="Confirm Device-Based License allocation" width="752" height="488" data-path="images/user/review-device-selection.png" />
    </Frame>
  </Step>

  <Step title="Confirm device allocation">
    At this step, just click **Allocation License** and you're done

    <Frame>
      <img src="https://mintcdn.com/farmsync-bb893348/04MM8D0921TGN18C/images/user/confirm-allocation-lifetime.png?fit=max&auto=format&n=04MM8D0921TGN18C&q=85&s=ea46c945ce88712aa8c2e5cd53e22e79" alt="Confirm Device-Based License allocation" width="762" height="506" data-path="images/user/confirm-allocation-lifetime.png" />
    </Frame>
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Error: Cannot add device">
    **Possible causes:**

    <ul>
      <li>Allocation days exceed remaining days (Time-Based)</li>
      <li>Device slots are full (Device-Based)</li>
      <li>Device is already allocated in another License</li>
      <li>Device ID is invalid</li>
    </ul>

    **Solutions:**

    <ol>
      <li>Check remaining days/slots in the License</li>
      <li>Confirm the device is not being used in another License</li>
      <li>Recheck the Device ID</li>
    </ol>
  </Accordion>

  <Accordion title="Error: Cannot edit allocation">
    **Causes:**

    <ul>
      <li>Device is currently in use</li>
      <li>No edit permissions</li>
      <li>License has expired</li>
    </ul>

    **Solutions:**

    <ol>
      <li>Wait for device to stop being used</li>
      <li>Contact admin for permissions</li>
      <li>Check License status</li>
    </ol>
  </Accordion>

  <Accordion title="Error: Device not working after allocation">
    **Causes:**

    <ul>
      <li>Device has not synced with server</li>
      <li>License not activated on device</li>
      <li>Unstable network connection</li>
    </ul>

    **Solutions:**

    <ol>
      <li>Restart the FarmSync application on the device</li>
      <li>Check internet connection</li>
      <li>Contact support if the problem persists</li>
    </ol>
  </Accordion>
</AccordionGroup>

## Additional Information

### Best Practices

#### Effective Management

* **Smart allocation**: Don't allocate too many days to one device if unnecessary (Time-Based)
* **Regular monitoring**: Check remaining days/slots periodically
* **Backup allocation**: Keep notes of important allocations

#### Optimization

* **Pool management**: Keep some reserve days in the pool (Time-Based)
* **Slot management**: Manage device slots efficiently (Device-Based)
* **Device rotation**: Rotate devices to maximize License utilization
* **Monitoring**: Use monitoring features to track usage

### Support

If you encounter any issues during device allocation, please:

<CardGroup cols={2}>
  <Card title="Contact Support" icon="headset" href="mailto:support@farmsync.com">
    Email the technical support team
  </Card>

  <Card title="FAQ Documentation" icon="question-circle" href="/faq">
    View frequently asked questions
  </Card>
</CardGroup>

<Tip>
  Plan your allocation beforehand to avoid wasting License time or device slots.
</Tip>