DEV Community

Cover image for How to Set Up and Run a Local Instance of Echo Search with Docker
Sanjib Narzary
Sanjib Narzary

Posted on AI-assisted

How to Set Up and Run a Local Instance of Echo Search with Docker

#docker #webdev #ai #echosearch

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 takes under two minutes.

Hosted Instance Echo Search

🔍 Key Features of Echo Search

Echo Search stands out as an open-source, minimalist search solution designed with developers and power users in mind.

  • Minimalist & Distraction-Free UI: Zero pop-ups, sponsored ads, or clunky sidebar widgets—just clean, well-structured search results.
  • Ultra-Fast Performance: Optimized for low latency, delivering sub-second response times and immediate visual output.
  • Privacy-First Architecture: Keeps your query data self-contained without tracking scripts or third-party telemetry.
  • Smart Contextual Summaries: Formats complex information into readable snippets and structured summaries for effortless scannability.
  • Containerized Deployment: Shipped as a lightweight container image for seamless setup across macOS, Linux, and Windows systems.
  • Developer API Integration: Clean backend routing that allows you to plug custom search endpoints or data feeds directly into the engine.

🛠️ Prerequisites

Before getting started, make sure you have the following installed on your host machine:

  • Docker Desktop or Docker Engine (version 20.10 or higher)
  • Terminal / Command Prompt with network access to pull images from the GitHub Container Registry (ghcr.io)

Verify your Docker installation:

docker --version
Enter fullscreen mode Exit fullscreen mode

🚀 Running Echo Search Locally

Option 1: Direct Docker Command

To launch an interactive local instance immediately, pull and execute the official container using the provided tag v2026.9:

docker run -it \
  --name echo-search \
  -p 3000:3000 \
  ghcr.io/sanjibnarzary/echo-search:v2026.9
Enter fullscreen mode Exit fullscreen mode

Command breakdown:

  • -it: Runs the container in interactive mode with a pseudo-TTY attached to monitor logs in real time.
  • --name echo-search: Assigns a readable name to your local container instance.
  • -p 3000:3000: Maps port 3000 of your host machine to port 3000 inside the container.
  • ghcr.io/sanjibnarzary/echo-search:v2026.9: The official package image hosted on GitHub Container Registry.

Option 2: Detached Mode (Background Daemon)

If you prefer to run Echo Search as a background service so your terminal session remains open:

docker run -d \
  --name echo-search \
  -p 3000:3000 \
  --restart unless-stopped \
  ghcr.io/sanjibnarzary/echo-search:v2026.9
Enter fullscreen mode Exit fullscreen mode

Option 3: Docker Compose Setup

For local development workflows alongside other microservices, create a docker-compose.yml file in your project directory:

version: '3.8'

services:
  echo-search:
    image: ghcr.io/sanjibnarzary/echo-search:v2026.9
    container_name: echo-search-local
    ports:
      - "3000:3000"
    environment:
      - PORT=3000
      - NODE_ENV=development
    restart: unless-stopped
Enter fullscreen mode Exit fullscreen mode

Start the service with:

docker compose up -d
Enter fullscreen mode Exit fullscreen mode

🌐 Verifying Your Local Instance

  1. Open your web browser and navigate to: 
http://localhost:3000
Enter fullscreen mode Exit fullscreen mode
  1. Type in any query (e.g., India, Docker docs, or JavaScript) to verify that the query engine parses and returns real-time search results smoothly.
  2. To inspect real-time logs from your running container: 
docker logs -f echo-search
Enter fullscreen mode Exit fullscreen mode

⚙️ Environment Variables & Configuration

Echo Search can be tailored using runtime environment variables passed via the -e flag or inside your docker-compose.yml:

Environment Variable Default Value Description
PORT 3000 The internal server port used by the web service.
NODE_ENV production Set to development for verbose debug logging.
CACHE_TTL 3600 Time-to-live for local cached queries in seconds.
ENABLE_ANALYTICS false Toggles local query metric collection on or off.

🛑 Stopping and Managing the Container

  • Stop the running instance: 
docker stop echo-search
Enter fullscreen mode Exit fullscreen mode
  • Restart the instance: 
docker start echo-search
Enter fullscreen mode Exit fullscreen mode
  • Remove the container: 
docker rm -f echo-search
Enter fullscreen mode Exit fullscreen mode

Wrap-Up

Running a local instance of Echo Search with ghcr.io/sanjibnarzary/echo-search:v2026.9 provides a clean, private, and ultra-responsive search interface right on your localhost. It eliminates third-party trackers, reduces ad overhead, and gives developers full control over their search environment.

Top comments (0)