mirror of https://github.com/AutoMaker-Org/automaker.git synced 2026-01-30 06:12:03 +00:00

Files

Illia Filippov 5c01706806 refactor: update Docker configuration & docs

- Modified docker-compose.yml to clarify that the server runs as a non-root user.
- Updated Dockerfile to use ARG for VITE_SERVER_URL, allowing build-time overrides.
- Replaced inline Nginx configuration with a separate nginx.conf file for better maintainability.
- Adjusted documentation to reflect changes in Docker setup and troubleshooting steps.

2025-12-20 02:12:18 +01:00

1.9 KiB

Raw Blame History

Docker Isolation Guide

This guide covers running Automaker in a fully isolated Docker container. For background on why isolation matters, see the Security Disclaimer.

Quick Start

Set your API key (create a .env file in the project root):

# Linux/Mac
echo "ANTHROPIC_API_KEY=your-api-key-here" > .env

# Windows PowerShell
Set-Content -Path .env -Value "ANTHROPIC_API_KEY=your-api-key-here" -Encoding UTF8

Build and run:
```
docker-compose up -d
```
Access Automaker at http://localhost:3007
Stop:
```
docker-compose down
```

How Isolation Works

The default docker-compose.yml configuration:

Uses only Docker-managed volumes (no host filesystem access)
Server runs as a non-root user
Has no privileged access to your system

Projects created in the UI are stored inside the container at /projects and persist across restarts via Docker volumes.

Mounting a Specific Project

If you need to work on a host project, create docker-compose.project.yml:

services:
  server:
    volumes:
      - ./my-project:/projects/my-project:ro # :ro = read-only

Then run:

docker-compose -f docker-compose.yml -f docker-compose.project.yml up -d

Tip: Use :ro (read-only) when possible for extra safety.

Troubleshooting

Problem	Solution
Container won't start	Check `.env` has `ANTHROPIC_API_KEY` set. Run `docker-compose logs` for errors.
Can't access web UI	Verify container is running with `docker ps \| grep automaker`
Need a fresh start	Run `docker-compose down && docker volume rm automaker-data && docker-compose up -d --build`

1.9 KiB Raw Blame History