AiyoPerps logoOfficial WebsiteAiyoPerps
Install guide

How to run AiyoPerps headless with Docker

If you only need the local REST API and MCP endpoint without the desktop GUI, this guide shows how to launch AiyoPerps in headless mode with Docker.

Requirements

Requirements

  • Docker installed locally
  • Local port 5078 available
  • A use case for REST API or MCP access

1Start the container with docker run

Use Docker CLI to launch the latest image and map local port 5078 into the container. You can also search for AiyoPerps on Docker Hub first.

docker run --rm --name aiyoperps -p 5078:5078 phidiassj/aiyoperps:latest
Docker CLI launching the AiyoPerps headless container with docker run
Docker Hub search results for the AiyoPerps image

2Confirm container and port status

Make sure the container is running and that local port 5078 is mapped correctly.

docker ps
docker ps showing the AiyoPerps container and the 5078 port mapping

3Verify OpenAPI or MCP access

Open the OpenAPI UI in a browser or test the MCP endpoint directly. If the page opens, the headless service is running correctly.

http://127.0.0.1:5078/scalar
OpenAPI Scalar verification page after AiyoPerps headless startup
Next step

Next step

Open the MCP and REST API handbook

After headless startup, the next step is usually mapping MCP tool names and API endpoints into your AI agent prompts.

Open MCP and REST API handbook

Need the desktop UI later?

If you later need manual charting or direct desktop interaction, switch to the Windows or Linux installation flow.

View Windows installation