TICKETIQ

Run Liyagent locally with Docker

Bring up Liyagent, Postgres and Qdrant with Docker Compose on your laptop, sign in and file a first ticket end to end.

After reading this page you will be able to:
  • Start the full stack with one compose command
  • Sign in and file a ticket
  • Tear it down cleanly
Beginner15 minDeploymentDocker

What you'll build

The same stack production uses, on your laptop: postgres, qdrant and ticketiq from deploy/docker-compose.yml.

Prerequisites

  • Docker Desktop or Docker Engine with the Compose plugin.
  • 4 GB of free memory for Docker.

Steps

  1. Unpack the Liyagent release. Liyagent is licensed software: request access to the release from sales@liyagent.com, or try Liya live with no install.
    cd liyagent        # the unpacked release
  2. Create the environment file and set three secrets.
    cp deploy/.env.example deploy/.env
sed -i.bak "s/CHANGE_ME_pg_password/$(openssl rand -hex 24)/; s/CHANGE_ME_qdrant_key/$(openssl rand -hex 24)/; s/CHANGE_ME_admin_password/labs-admin-pass/" deploy/.env
  3. Build and start.
    docker compose -f deploy/docker-compose.yml --env-file deploy/.env up -d --build
  4. Wait for health.
    until curl -sf http://127.0.0.1:8787/api/health; do sleep 3; done; echo " up"
  5. Open http://127.0.0.1:8787/login and sign in as admin with labs-admin-pass.
  6. Open Tickets and create a ticket titled Outlook keeps asking for my password. It is classified as Email & Collaboration and routed to the Messaging Team.
  7. Check the logs if anything looks wrong: docker compose -f deploy/docker-compose.yml logs -f ticketiq.
Tip

Add --profile mcp to the up command to also run Liyagent's MCP server on port 8000.

Clean up

docker compose -f deploy/docker-compose.yml down        # keep data
docker compose -f deploy/docker-compose.yml down -v     # also delete the volumes
Warning

down -v deletes the Postgres volume. PG_PASSWORD is fixed at first start, so if you change it, delete the volume too.

Next steps