---
title: "Deploy scholia-template"
description: "Self-hosted second brain for Claude and AI agents, over MCP"
category: "AI/ML"
url: https://railway.com/deploy/scholia-template
---

# Deploy scholia-template

Self-hosted second brain for Claude and AI agents, over MCP

**[Deploy scholia-template on Railway](https://railway.com/template/scholia-template)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/scholia-template/manifest.json

- **Creator:** Daniel Bernardino's Projects
- **Category:** AI/ML

## Template content

### pgvector https://devicons.railway.app/i/postgresql.svg

- **Image:** pgvector/pgvector:pg18
- **Start command:** `/bin/sh -c "unset PGPORT; docker-entrypoint.sh postgres --port=5432"`

### scholia-mcp https://cdn.jsdelivr.net/gh/daniel-bernardino747/scholia-mcp@main/docs/icon.svg

- **Source:** https://github.com/daniel-bernardino747/scholia-mcp
- **Health check:** /health
- **Public domain:** Yes

## Documentation

# Deploy and Host scholia on Railway

scholia is a self-hosted second brain for AI agents. Claude (on claude.ai, mobile or Claude Code) saves distilled notes from your conversations — decisions, data with sources, positions, open questions — and searches them before answering in new ones, citing the note it used.

## About Hosting scholia

This template runs two services: Postgres with pgvector, and the scholia MCP server, built from [github.com/daniel-bernardino747/scholia-mcp](https://github.com/daniel-bernardino747/scholia-mcp). claude.ai connects to it as a custom connector and logs in with GitHub; only the GitHub accounts you list get in.

Before deploying, get an embedding API key from [Voyage AI](https://dashboard.voyageai.com) or OpenAI.

1. Deploy. Fill the GitHub fields with placeholders for now; the server will refuse to start and say which variable is missing.
2. Copy the service's public URL. Create a GitHub OAuth App at github.com/settings/applications/new with that URL as homepage and `/auth/callback` as Redirect URI.
3. Set `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET` and `ALLOWED_GITHUB_USERS` (your numeric GitHub ID) and redeploy.
4. In claude.ai → Settings → Connectors, add a custom connector with `/mcp`, and paste the [preference instructions](https://github.com/daniel-bernardino747/scholia-mcp/tree/main/instructions) into your profile.

Turn on Backups for the pgvector service.

## Common Use Cases

- Keep what you concluded with Claude across conversations, on web, mobile and Claude Code
- Track how your opinions change: new notes supersede old ones without erasing them
- Search your notes by meaning and by exact terms or acronyms, in your own language

## Dependencies for scholia Hosting

- Postgres with the pgvector extension (included)
- A Voyage AI or OpenAI API key for embeddings
- A GitHub OAuth App for login

### Deployment Dependencies

- [scholia-mcp on GitHub](https://github.com/daniel-bernardino747/scholia-mcp)
- [Voyage AI API keys](https://dashboard.voyageai.com)
- [GitHub OAuth Apps](https://github.com/settings/developers)

## Why Deploy scholia on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying scholia on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.


## Similar templates

- [Chat Chat](https://railway.com/deploy/-WWW5r) — Chat Chat, your own unified chat and search to AI platform.
- [stella](https://railway.com/deploy/stella) — Self-host stella with web, API, Postgres, Redis, and object storage.
- [Hermes Agent | OpenClaw Alternative with Dashboard](https://railway.com/deploy/hermes-agent-or-openclaw-alternative-wit) — Self-Hosted Hermes AI Agent for Telegram, Discord & Slack

Open this page in a browser: https://railway.com/deploy/scholia-template