> ## Documentation Index
> Fetch the complete documentation index at: https://docs.memorycrystal.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Railway Deployment

> Deploy the Memory Crystal web app or MCP server on Railway.

Railway is one place you can run the parts of Memory Crystal that need a server.

## What this means in practice

This repo contains more than one deployable surface, so Railway setup matters.

## Web app deployment

The Next.js web dashboard lives under:

* `apps/web`

The repo root already includes a `railway.toml` aimed at the web app.

## MCP server deployment

The current Streamable HTTP MCP server lives under:

* `packages/mcp-server`

That service has its own package-local Railway config and should be deployed separately from the web app.

## Important monorepo note

If Railway uses the repo-root config by default, it may boot the web app instead of the MCP server.

For the MCP service, use the package-local settings described in `packages/mcp-server/README.md`.

## MCP server service settings

For Railway MCP deployment, use:

* **Root Directory:** `/packages/mcp-server`
* **Railway Config File:** `/packages/mcp-server/railway.toml`
* **Port:** `3100`

## How it actually works

This matters because Railway can accidentally use the wrong config in a monorepo if you point it at the wrong root.

The public docs should emphasize the MCP server package-local deployment path instead of implying the root web app config is correct for every service.

## Commands / examples

Typical start command for the package-local MCP service:

```bash theme={"system"}
npm run start --workspace packages/mcp-server
```

## Build / start model

The package-local setup handles:

* install
* build
* start
* healthcheck routing

## What to verify after deploy

* the service health endpoint responds
* the MCP endpoint is reachable
* your client can authenticate with `Authorization: Bearer <api-key>`

## Related docs

* [Environment Variables](/self-hosting/environment-variables)
* [MCP Server](/integrations/mcp-server)

## Source of truth

* `packages/mcp-server/README.md`
* `packages/mcp-server/railway.toml`
* `apps/docs/self-hosting/environment-variables.mdx`