Spaces:
Runtime error
Runtime error
akashyadav758 Claude Opus 4.8 (1M context) commited on
Commit Β·
bcacea2
1
Parent(s): 7869843
Add SETUP.md: short Docker self-host + Hugging Face/Neon deploy guide
Browse filesCo-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
SETUP.md
ADDED
|
@@ -0,0 +1,54 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# Setup β Deploy with Docker (self-host)
|
| 2 |
+
|
| 3 |
+
Very short guide. Runs the browser + all 3 API servers on your own machine/server.
|
| 4 |
+
**Your login is saved automatically β no database needed for Docker.**
|
| 5 |
+
|
| 6 |
+
## 1. Install Docker
|
| 7 |
+
- [Docker Desktop](https://www.docker.com/products/docker-desktop/) (Mac/Windows) or `docker` + `docker compose` (Linux).
|
| 8 |
+
- Check: `docker --version`
|
| 9 |
+
|
| 10 |
+
## 2. Get the code
|
| 11 |
+
```bash
|
| 12 |
+
git clone https://huggingface.co/spaces/akash1313/selfapi
|
| 13 |
+
cd selfapi
|
| 14 |
+
```
|
| 15 |
+
|
| 16 |
+
## 3. Run it
|
| 17 |
+
```bash
|
| 18 |
+
docker compose up --build -d
|
| 19 |
+
```
|
| 20 |
+
- Open **http://localhost:3001** β watch the browser.
|
| 21 |
+
- **Log in** to ChatGPT / Gemini / Flow once.
|
| 22 |
+
|
| 23 |
+
## 4. Stop / restart
|
| 24 |
+
```bash
|
| 25 |
+
docker compose down # stops; login stays saved in the volume
|
| 26 |
+
docker compose up -d # starts again; login is back
|
| 27 |
+
```
|
| 28 |
+
Your profile lives in the `chrome-profile` Docker volume, so logins survive
|
| 29 |
+
restarts and reboots automatically. (To wipe it: `docker compose down -v`.)
|
| 30 |
+
|
| 31 |
+
---
|
| 32 |
+
|
| 33 |
+
## Which file does what
|
| 34 |
+
| File | Job |
|
| 35 |
+
|------|-----|
|
| 36 |
+
| `docker-compose.yml` | Runs everything (browser + 3 servers) + the save-login volume |
|
| 37 |
+
| `Dockerfile` | Builds the browser image |
|
| 38 |
+
| `start_hf.sh` | Boot steps (start Chrome + extensions) |
|
| 39 |
+
|
| 40 |
+
---
|
| 41 |
+
|
| 42 |
+
## Running on Hugging Face instead? (needs Neon)
|
| 43 |
+
|
| 44 |
+
HF free Spaces have **no permanent disk**, so there logins need a Postgres database.
|
| 45 |
+
|
| 46 |
+
1. Sign up free at **[neon.tech](https://neon.tech)** β create a project.
|
| 47 |
+
2. Copy the **connection string**
|
| 48 |
+
(`postgresql://user:pass@...neon.tech/db?sslmode=require`).
|
| 49 |
+
3. In your Space β **Settings β Variables and secrets β New secret**:
|
| 50 |
+
- Name: `DATABASE_URL`
|
| 51 |
+
- Value: the connection string
|
| 52 |
+
4. The Space restarts β **log in once** β it auto-saves every 5 min and survives rebuilds.
|
| 53 |
+
|
| 54 |
+
> Deploy code to HF with `git push`. Never commit the connection string.
|