Skip to content

Fix Docker Compose default profile and error documentation #442

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Wirasm merged 5 commits into from
Aug 25, 2025
Merged

Fix Docker Compose default profile and error documentation #442

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
f493210
Fix Docker Compose default profile and error documentation
leex279 Aug 22, 2025
140bca2
Use generic YOUR_PROFILE placeholder instead of hardcoded 'full' profile
leex279 Aug 22, 2025
61f60a5
Remove profiles from all services to enable default startup
leex279 Aug 22, 2025
d9d7287
Update error modal to use 'full' profile with helpful note
leex279 Aug 22, 2025
657c7f4
Merge UX improvements from PR #443
leex279 Aug 22, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -77,6 +77,8 @@ This new vision for Archon replaces the old one (the agenteer). Archon used to b
**Full Docker Mode (Recommended for Normal Archon Usage)**

```bash
docker compose up --build -d
# or, to match a previously used explicit profile:
docker compose --profile full up --build -d
# or
make dev-docker # (Alternative: Requires make installed )
Expand Down
13 changes: 9 additions & 4 deletions archon-ui-main/src/components/BackendStartupError.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,11 +49,16 @@ export const BackendStartupError: React.FC = () => {
After fixing the issue in your .env file, recreate the Docker containers:
</p>
<code className="block mt-2 p-2 bg-black/70 rounded text-red-100 font-mono text-sm">
docker compose down && docker compose up -d
docker compose down && docker compose up --build -d
</code>
<p className="text-red-300 text-xs mt-2">
Note: Use 'down' and 'up', not 'restart' - containers need to be recreated to load new environment variables
</p>
<div className="text-red-300 text-xs mt-2">
<p>Note:</p>
<p>• Use 'down' and 'up' (not 'restart') so new env vars are picked up.</p>
<p>• If you originally started with a specific profile (backend, frontend, or full),</p>
<p>&nbsp;&nbsp;run the same profile again:</p>
<br />
<code className="bg-black/50 px-1 rounded">docker compose --profile full up --build -d</code>
</div>
</div>

<div className="flex justify-center pt-4">
Expand Down
12 changes: 5 additions & 7 deletions docker-compose.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,15 +1,16 @@
# Docker Compose Profiles Strategy:
# - No profile: All services start by default when running 'docker compose up'
# - "backend": Starts only backend services (server, mcp, agents) for hybrid development
# - "frontend": Starts only the frontend UI service
# - "full": Starts all services for complete Docker deployment
# - "full": Starts all services for complete Docker deployment (same as no profile)
# Use --profile flag to control which services start:
# docker compose --profile backend up # Backend only for hybrid dev (or docker-compose)
# docker compose --profile full up # Everything in Docker (or docker-compose)
# docker compose up # All services (default behavior)
# docker compose --profile backend up # Backend only for hybrid dev
# docker compose --profile full up # Everything in Docker (same as default)

services:
# Server Service (FastAPI + Socket.IO + Crawling)
archon-server:
profiles: ["backend", "full"]
build:
context: ./python
dockerfile: Dockerfile.server
Expand Down Expand Up @@ -64,7 +65,6 @@ services:

# Lightweight MCP Server Service (HTTP-based)
archon-mcp:
profiles: ["backend", "full"]
build:
context: ./python
dockerfile: Dockerfile.mcp
Expand Down Expand Up @@ -109,7 +109,6 @@ services:

# AI Agents Service (ML/Reranking)
archon-agents:
profiles: ["backend", "full"]
build:
context: ./python
dockerfile: Dockerfile.agents
Expand Down Expand Up @@ -144,7 +143,6 @@ services:

# Frontend
archon-frontend:
profiles: ["frontend", "full"]
build: ./archon-ui-main
container_name: archon-ui
ports:
Expand Down