> For the complete documentation index, see [llms.txt](https://allqueue.gitbook.io/allq/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://allqueue.gitbook.io/allq/install/2.-install-allqueue-client.md).

# 2. Install AllQueue Client

AllQClient

The client is used for your App to talk to AllQueue server. There is no way to talk directly to the server, your app must talk to a (preferrably) local AllQueue client. This is done by talking to the local AllQClient via http. (Or for more advanced needs, you can actually talk to the local client via raw TCP as well)

## Requirements

{% hint style="danger" %}
You MUST have generated credentials from the "Install AllQueue Server" page to run the AllQueue Client install
{% endhint %}

## Run client

```
$ docker run --name=allq_client -d \
    -e "SERVER_STRING=YOUR_SERVER_IP:5555" \
    -e "A_CURVE_SECRETKEY=$A_CURVE_SECRETKEY" \
    -e "A_CURVE_PUBLICKEY=$A_CURVE_PUBLICKEY" \
    -e "A_CURVE_SERVER_PUBLICKEY=$A_CURVE_SERVER_PUBLICKEY" \
    -p 8090:8090 \
    blitline/allq:client_latest
```

1.  Update the **SERVER\_STRING** with your server IP/DNS name, and default port 5555
2. Update the **A\_CURVE\_\*** values with your **client** values you wrote down when setting up the server.

{% hint style="warning" %}
 It's important that you use the **CLIENT** credentials, and not the server credentials.
{% endhint %}

## Test Connection

You can test your client to see if it's talking with the server via curl

```
curl http://localhost:8090/stats
```

{% hint style="info" %}
If you get a 500 error, you probably have the SERVER\_STRING, or CURVE keys incorrect.

Also remember that port 5555 must be open on the server (not firewalled)

If you get JSON back, your client/server connection is OK and you are all set!
{% endhint %}