ghostfolio/DEPLOY.md

Deploy AgentForge (public MVP) — Railway

Use Railway to get a public URL so your agent can call the API.

---

Railway steps

1. Push this repo to GitHub (if not already).

2. Create project
   railway.app → New Project → Deploy from GitHub → select this repo.
   Railway uses the root Dockerfile and railway.toml.

3. Add Postgres
   In the same project: + New → Database → PostgreSQL.
   Open the Postgres service → Variables (or Connect) → copy DATABASE_URL (or the connection URL).

4. Add Redis
   + New → Database → Redis.
   Open the Redis service → Variables → note Host, Port, Password (or the connection URL).

5. Generate public URL
   Open your app service (the one from the repo) → Settings → Networking → Generate Domain.
   Copy the URL (e.g. https://agentforge-production.up.railway.app).

6. Set app env vars
   App service → Variables → Add variable (or RAW Editor). Add:

   Variable	Where to get it
   DATABASE_URL	Postgres service → Variables / Connect
   REDIS_HOST	Redis service → Variables (host)
   REDIS_PORT	Redis service → Variables (port, e.g. 6379)
   REDIS_PASSWORD	Redis service → Variables (password; can leave empty if none)
   JWT_SECRET_KEY	Any long random string (e.g. openssl rand -hex 32)
   ACCESS_TOKEN_SALT	Another long random string
   ROOT_URL	The URL from step 5 (e.g. https://agentforge-production.up.railway.app)

   Tip: For Postgres/Redis, Railway can “Reference” variables from the other services so you don’t copy-paste secrets.

7. Deploy
   Save variables; Railway redeploys. Wait for the deploy to finish.

8. Create first user
   Open ROOT_URL in a browser → Get started → create an account (this user is admin).

9. Get token for the agent
   In the app: open that user’s Account / Settings → copy the security token.

10. Agent auth

    • POST <ROOT_URL>/api/v1/auth/anonymous
    • Body: { "accessToken": "<security_token>" }
    • Use the returned authToken as Authorization: Bearer <authToken> on all API requests.

---

Alternative: Render

1. Push to GitHub.
2. Render Dashboard → New → Blueprint → connect repo (uses render.yaml).
3. Deploy Blueprint; when prompted, leave REDIS_PASSWORD and ROOT_URL blank for now.
4. After deploy: set ROOT_URL in the web service env to your Render URL → Save.
5. Open the URL → create first user → copy security token → use POST .../api/v1/auth/anonymous and Bearer token as above.

---

Env reference

Variable	Required	Notes
DATABASE_URL	Yes	Postgres connection URL.
REDIS_HOST	Yes	Redis host.
REDIS_PORT	Yes	Usually 6379.
REDIS_PASSWORD	No*	Leave empty if Redis has no auth.
JWT_SECRET_KEY	Yes	Long random string.
ACCESS_TOKEN_SALT	Yes	Long random string.
ROOT_URL	Yes	Your app’s public URL (set after first deploy).

* App allows empty; required only if your Redis has a password.