{
  "id": 7512538,
  "title": "How to Set Up and Run a Local Instance of Echo Search with Docker",
  "url": "https://urgent.news/2026/09/15/how-to-set-up-and-run-a-local-instance-of-echo-search-with-docker",
  "topic": "tech",
  "section": "Tech",
  "published": "2026-09-15T08:46:04.000Z",
  "source": {
    "name": "Dev.to",
    "slug": "dev-to",
    "url": "https://dev.to/sanjib_narzary/how-to-set-up-and-run-a-local-instance-of-echo-search-with-docker-4kk1"
  },
  "original_language": "en",
  "account": "Echo Search offers a cleaner, faster, and more privacy-focused alternative to traditional web search engines. The open-source project emphasizes minimalism, speed, and privacy, making it an ideal choice for developers and power users. To run Echo Search locally, Docker is required. This section outlines the steps to set up and run a local instance of Echo Search using Docker, along with key features and configuration options.\n\nFirst, ensure that Docker Desktop or Docker Engine (version 20.10 or higher) is installed on your system. After confirming the Docker installation, you can run Echo Search in three different ways: directly via the Docker command, in detached mode (as a background service), or using Docker Compose for local development workflows alongside other services.\n\nTo start Echo Search using Docker, execute one of the following commands:\n1. Direct Docker Command:\n```\ndocker run -it --name echo-search -p 3000:3000 ghcr.io/sanjibnarzary/echo-search:v2026.9\n```\n2. Detached Mode (Background Daemon):\n```\ndocker run -d --name echo-search -p 3000:3000 --restart unless-stopped ghcr.io/sanjibnarzary/echo-search:v2026.9\n```\n3. Docker Compose Setup:\nCreate a `docker-compose.yml` file in your project directory with the following content:\n```\nversion: \"3.8\"\nservices:\necho-search:\nimage: ghcr.io/sanjibnarzary/echo-search:v2026.9\ncontainer_name: echo-search-local\nports:\n- \"3000:3000\"\nenvironment:\n- PORT=3000\n- NODE_ENV=development\nrestart: unless-stopped\n```\nThen, start the service with the command: `docker compose up -d`.\n\nTo verify that the local instance is running, open your web browser and visit `http://localhost:3000`. Enter any query to ensure that the search engine provides real-time results. For logging purposes, use the command: `docker logs -f echo-search`.\n\nEcho Search can be customized using environment variables. Some notable variables include:\n- `PORT`: The internal server port (default: 3000)\n- `NODE_ENV`: Set to `development` for verbose debug logging\n- `CACHE_TTL`: Time-to-live for local cached queries in seconds (default: 3600)\n- `ENABLE_ANALYTICS`: Toggles local query metric collection (default: false)\n\nTo manage the running instance, use the following commands:\n- Stop: `docker stop echo-search`\n- Start: `docker start echo-search`\n- Remove: `docker rm -f echo-search`\n\nIn conclusion, deploying a local instance of Echo Search provides a private, fast, and ad-free search experience. By leveraging Docker, developers and power users can easily set up and run the search engine on their local machine, offering complete control over their browsing environment.",
  "summary": "Navigating the modern web often means wading through ad-choked, bloated search engine results. Echo Search addresses this pain point by delivering a lightning-fast, privacy-conscious, and distraction-free search interface. Whether you want to self-host a private search instance or integrate a lightweight search gateway into your local developer workflow, running Echo Search locally via Docker…",
  "key_points": [],
  "editors_take": null,
  "illustration": null,
  "coverage": {
    "outlets": 1,
    "also_reported_by": []
  },
  "ai_generated": true,
  "disclaimer": "Summaries, key points and the editor’s take are written by software from other outlets’ reporting and may contain errors — always check the linked original."
}