🖤 Homra Heartbeat 2.0 - Universal Deployment Guide

This project consists of a React Dashboard and a Python MCP Server.

🛡️ Security First (Read Before Pushing to GitHub)

1. Dashboard Configuration: Your keys (PushPlus, Notion) are stored in your browser's LocalStorage. They are not written to the source code files.

2. server.py Generation: The "Deployment" tab generates a server.py containing the keys you entered. Do not commit this specific file to a public GitHub repo.

3. Sanitization: Use the "Sanitize (Reset)" button in the Aran Config tab to clear all keys from the dashboard before making screenshots or sharing code.

🚀 Deployment to RackNerd VPS (Full Stack)

Step 1: Prepare the Frontend

In your local project folder:

This creates a dist folder.

Step 2: Upload to VPS

Step 3: Server Setup

SSH into your RackNerd VPS:

Install the engine:

Step 4: Run with Environment Variables (Secure Method)

Instead of hardcoding keys in server.py, you can run the server like this:

The server will prioritize these environment variables over whatever is written in the script.

🐙 Publishing to GitHub (Safe Version)

1. Make sure your constants.ts and App.tsx have no hardcoded secrets.

2. Create .gitignore and add dist/ and heartbeat.log.

3. Push to GitHub:

   git init git add . git commit -m "Public release" git remote add origin https://github.com/USER/REPO.git git push -u origin main

🤖 Rikkahub Integration

• SSE URL: http://YOUR_VPS_IP:8000/sse