How to Set Up and Run a Local Instance of Echo Search with Docker
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…
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.
First, 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.
To start Echo Search using Docker, execute one of the following commands:
1. Direct Docker Command:
```
docker run -it --name echo-search -p 3000:3000 ghcr.io/sanjibnarzary/echo-search:v2026.9
```
2. Detached Mode (Background Daemon):
```
docker run -d --name echo-search -p 3000:3000 --restart unless-stopped ghcr.io/sanjibnarzary/echo-search:v2026.9
```
3. Docker Compose Setup:
Create a `docker-compose.yml` file in your project directory with the following content:
```
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
```
Then, start the service with the command: `docker compose up -d`.
To 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`.
Echo Search can be customized using environment variables. Some notable variables include:
- `PORT`: The internal server port (default: 3000)
- `NODE_ENV`: Set to `development` for verbose debug logging
- `CACHE_TTL`: Time-to-live for local cached queries in seconds (default: 3600)
- `ENABLE_ANALYTICS`: Toggles local query metric collection (default: false)
To manage the running instance, use the following commands:
- Stop: `docker stop echo-search`
- Start: `docker start echo-search`
- Remove: `docker rm -f echo-search`
In 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.
Written by urgent.news from Dev.to's reporting — not their text. Machine-written — may contain errors; check the original before relying on it.
