# Engram Installation Guide

Choose your operating system:

## 🍎 Mac Users

1. Make sure you have [Docker Desktop](https://www.docker.com/products/docker-desktop) installed
2. Double-click: `setup.sh`
3. Or open Terminal and run: `./setup.sh`

That's it! Your Engram vault will start in about 1 minute.

---

## 🪟 Windows Users

**Option A: Easy Way (Recommended)**
1. Make sure you have [Docker Desktop](https://www.docker.com/products/docker-desktop) installed
2. Double-click: `setup.bat`

**Option B: PowerShell**
1. Open PowerShell
2. Navigate to the Engram folder: `cd path\to\engram`
3. Run: `.\setup.sh`

---

## 🐧 Linux Users

1. Install Docker: https://docs.docker.com/engine/install/
2. Open Terminal in the Engram folder
3. Run: `./setup.sh`

---

## ✅ What to Expect

The installer will:
1. Check that Docker is installed
2. Download Engram (about 500 MB)
3. Start the services (takes 30-60 seconds)
4. Print a URL: `http://localhost:8000`
5. Open that URL in your browser

You'll see the Engram dashboard. **You're done!**

---

## 🆘 Troubleshooting

**"Docker is not installed"**
→ Download from https://www.docker.com/products/docker-desktop

**Nothing happens when I double-click**
→ Try opening Terminal/PowerShell and running the installer from there

**Port 8000 is already in use**
→ Run: `docker compose down` to stop any existing Engram instances

**Still stuck?**
→ See [GETTING_STARTED.md](GETTING_STARTED.md) for detailed non-technical instructions
→ See [TROUBLESHOOTING.md](TROUBLESHOOTING.md) for technical issues

---

## 🎯 Next Steps

Once Engram is running:
1. Go to: http://localhost:8000
2. Click on the `/docs` link for interactive documentation
3. See [GETTING_STARTED.md](GETTING_STARTED.md) for how to use it