You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/applied-ai-services/form-recognizer/containers/form-recognizer-container-install-run.md
+20-7Lines changed: 20 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,7 +12,7 @@ ms.author: lajanuar
12
12
recommendations: false
13
13
---
14
14
15
-
# Install and run Form Recognizer v2.1 containers
15
+
# Install and run Form Recognizer containers
16
16
17
17
::: moniker range="form-recog-3.0.0"
18
18
[!INCLUDE [applies to v3.0](../includes/applies-to-v3-0.md)]
@@ -27,7 +27,7 @@ Azure Form Recognizer is an Azure Applied AI Service that lets you build automat
27
27
::: moniker range="form-recog-3.0.0"
28
28
In this article you learn how to download, install, and run Form Recognizer containers. Containers enable you to run the Form Recognizer service in your own environment. Containers are great for specific security and data governance requirements.
29
29
30
-
*The **Read** and **Layout** models are supported by Form Recognizer v3.0 containers.
30
+
***Read** and **Layout** models are supported by Form Recognizer v3.0 containers.
31
31
32
32
***Business Card**,**ID Document**, **Receipt**, **Invoice**, and **Custom** models are currently only supported in the [v2.1 containers](form-recognizer-container-install-run.md?view=form-recog-2.1.0&preserve-view=true).
33
33
@@ -39,6 +39,7 @@ In this article you learn how to download, install, and run Form Recognizer cont
39
39
***Layout**, **Business Card**,**ID Document**, **Receipt**, **Invoice**, and **Custom** models are supported by six Form Recognizer feature containers.
40
40
41
41
* For Receipt, Business Card and ID Document containers you also need the **Read** OCR container.
42
+
42
43
::: moniker-end
43
44
44
45
> [!IMPORTANT]
@@ -56,14 +57,26 @@ You also need the following to use Form Recognizer containers:
56
57
|**Familiarity with Docker**| You should have a basic understanding of Docker concepts, like registries, repositories, containers, and container images, as well as knowledge of basic `docker`[terminology and commands](/dotnet/architecture/microservices/container-docker-introduction/docker-terminology). |
57
58
|**Docker Engine installed**| <ul><li>You need the Docker Engine installed on a [host computer](#host-computer-requirements). Docker provides packages that configure the Docker environment on [macOS](https://docs.docker.com/docker-for-mac/), [Windows](https://docs.docker.com/docker-for-windows/), and [Linux](https://docs.docker.com/engine/installation/#supported-platforms). For a primer on Docker and container basics, see the [Docker overview](https://docs.docker.com/engine/docker-overview/).</li><li> Docker must be configured to allow the containers to connect with and send billing data to Azure. </li><li> On **Windows**, Docker must also be configured to support **Linux** containers.</li></ul> |
58
59
|**Form Recognizer resource**| A [**single-service Azure Form Recognizer**](https://portal.azure.com/#create/Microsoft.CognitiveServicesFormRecognizer) or [**multi-service Cognitive Services**](https://portal.azure.com/#create/Microsoft.CognitiveServicesAllInOne) resource in the Azure portal. To use the containers, you must have the associated key and endpoint URI. Both values are available on the Azure portal Form Recognizer **Keys and Endpoint** page: <ul><li>**{FORM_RECOGNIZER_KEY}**: one of the two available resource keys.<li>**{FORM_RECOGNIZER_ENDPOINT_URI}**: the endpoint for the resource used to track billing information.</li></li></ul>|
59
-
:::moniker range="form-recog-2.1.0"
60
-
| **Computer Vision API resource** | **To process business cards, ID documents, or Receipts, you need a Computer Vision resource.** <ul><li>You can access the Recognize Text feature as either an Azure resource (the REST API or SDK) or a **cognitive-services-recognize-text** [container](../../../cognitive-services/Computer-vision/computer-vision-how-to-install-containers.md#get-the-container-image). The usual [billing](#billing) fees apply.</li> <li>If you use the **cognitive-services-recognize-text** container, make sure that your Computer Vision key for the Form Recognizer container is the key specified in the Computer Vision `docker run` or `docker compose` command for the **cognitive-services-recognize-text** container and your billing endpoint is the container's endpoint (for example, `http://localhost:5000`). If you use both the Computer Vision container and Form Recognizer container together on the same host, they can't both be started with the default port of *5000*. </li></ul></br>Pass in both the key and endpoints for your Computer Vision Azure cloud or Cognitive Services container:<ul><li>**{COMPUTER_VISION_KEY}**: one of the two available resource keys.</li><li> **{COMPUTER_VISION_ENDPOINT_URI}**: the endpoint for the resource used to track billing information.</li></ul> |
61
-
:::moniker-end
62
-
63
60
|Optional|Purpose|
64
61
|---------|----------|
65
62
|**Azure CLI (command-line interface)**| The [Azure CLI](/cli/azure/install-azure-cli) enables you to use a set of online commands to create and manage Azure resources. It's available to install in Windows, macOS, and Linux environments and can be run in a Docker container and Azure Cloud Shell. |
66
-
|||
63
+
64
+
:::moniker range="form-recog-2.1.0"
65
+
You also need a **Computer Vision API resource to process business cards, ID documents, or Receipts**.
66
+
67
+
* You can access the Recognize Text feature as either an Azure resource (the REST API or SDK) or a **cognitive-services-recognize-text**[container](../../../cognitive-services/Computer-vision/computer-vision-how-to-install-containers.md#get-the-container-image).
68
+
69
+
* The usual [billing](#billing) fees apply.
70
+
71
+
* If you use the **cognitive-services-recognize-text** container, make sure that your Computer Vision key for the Form Recognizer container is the key specified in the Computer Vision `docker run` or `docker compose` command for the **cognitive-services-recognize-text** container and your billing endpoint is the container's endpoint (for example, `http://localhost:5000`).
72
+
73
+
* If you use both the Computer Vision container and Form Recognizer container together on the same host, they can't both be started with the default port of **5000**.
74
+
75
+
* Pass in both the key and endpoints for your Computer Vision Azure cloud or Cognitive Services container:
76
+
77
+
***{COMPUTER_VISION_KEY}**: one of the two available resource keys.
78
+
***{COMPUTER_VISION_ENDPOINT_URI}**: the endpoint for the resource used to track billing information.
0 commit comments