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 files

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Files changed (1) hide show
  1. SETUP.md +54 -0
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.