> For the complete documentation index, see [llms.txt](https://iqtlabs.gitbook.io/packet-cafe/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://iqtlabs.gitbook.io/packet-cafe/deployment/macos.md).

# macOS

## Deploy

Clone the repository:

```
git clone https://github.com/IQTLabs/packet_cafe
cd packet_cafe
```

Pick a path to store Packet Café data and export it as an environment variable:

```
export VOL_PREFIX=~/packet_cafe_data
```

{% hint style="warning" %}
Only some paths are allowed to be mounted with Docker on macOS, make sure to use one that is allowed, for example a path in your home directory: `~/packet_cafe_data`
{% endhint %}

Once a path has been picked for the data to live, build and start Packet Café (from the repository directory):

```
docker-compose pull
docker-compose up -d --build && docker-compose rm -f
```

Once it has finished, check for the `healthy` status of the containers:

```
$ docker ps
CONTAINER ID        IMAGE                                      COMMAND                  CREATED             STATUS                  PORTS                                                 NAMES
0ff880772f43        iqtlabs/packet_cafe_redis:latest       "docker-entrypoint.s…"   26 hours ago        Up 26 hours (healthy)   6379/tcp                                              packet_cafe_redis_1
e0568e748330        iqtlabs/packet_cafe_admin:latest       "/bin/sh -c 'gunicor…"   26 hours ago        Up 26 hours (healthy)   0.0.0.0:5001->5001/tcp                                packet_cafe_admin_1
2153de9c9372        iqtlabs/packet_cafe_ui:latest          "node server.js"         26 hours ago        Up 26 hours (healthy)   5000/tcp                                              packet_cafe_ui_1
6a0a3cd39c79        iqtlabs/packet_cafe_web:latest         "/bin/sh -c '(nginx)…"   26 hours ago        Up 26 hours (healthy)   8000/tcp                                              packet_cafe_web_1
d114f60f9483        iqtlabs/packet_cafe_lb:latest          "supervisord -c /etc…"   26 hours ago        Up 26 hours (healthy)   0.0.0.0:80->80/tcp                                    packet_cafe_lb_1
42fb15415635        iqtlabs/packet_cafe_messenger:latest   "docker-entrypoint.s…"   26 hours ago        Up 26 hours (healthy)   4369/tcp, 5671-5672/tcp, 15671-15672/tcp, 25672/tcp   packet_cafe_messenger_1
55d3a338ef4b        iqtlabs/packet_cafe_workers:latest     "/bin/sh -c '(flask …"   26 hours ago        Up 26 hours (healthy)                                                         packet_cafe_workers_1
```

Once everything is healthy browse to [http://0.0.0.0/](http://0.0.0.0)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://iqtlabs.gitbook.io/packet-cafe/deployment/macos.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.