Loomy Dashboard

0 selected

🚀 Create New App

Choose Template

Express

API Server

Node+HTML

Server+Static

Fastify

Fast API

React

Vite + React

Next.js

Fullstack

Vue

Vite + Vue

Svelte

SvelteKit

Angular

Angular CLI

TypeScript

TS + Node

HTML/CSS/JS

Static Site

PWA

Offline App

Flask

Python API

FastAPI

Python Async

Go

Gin Server

Rust

Actix Web

PHP

Laravel

Ruby

Rails

GitHub

Import Repo

Import from Airtable

Bulk import apps from your Airtable table

App Name

Custom Domain

Configure custom domain for app

Add Custom Domain

You'll need to point your domain to your server IP (159.69.26.217) via A record, or create a CNAME to app-name.loomyloo.app

Configured Domains

No custom domains configured yet

How to configure:

Add your custom domain above
Point your domain's DNS to your server (A record: 159.69.26.217 or CNAME to the default subdomain)
Click "Validate DNS" to verify it's working
Click "Apply to Coolify" to add it to your app
SSL certificate will be automatically provisioned

Select a file

Port:

FILES

Loading...

Ln 1, Col 1 JavaScript UTF-8 No Wrap Spaces: 2 13px Format

$ Ready for commands...

$

Load User Secrets:

ADD APP-SPECIFIC SECRET

Use global secret value

CONFIGURED SECRETS 0

Loading secrets...

Port Registry Sync

Scans every app — fixes duplicates, mismatches, missing entries. Updates .env, app-config.json, tunnel and registry.

Click "Scan All Ports" to check your entire registry

App Preview

|

Click "Preview" to see your running app...

Find & Replace

Aa .* \\b

Port Manager

Port

Free

All Active Ports

Loading ports...

Common Ports

3000

Node.js

8080

HTTP Alt

80

HTTP

443

HTTPS

5000

Flask/Dev

8000

Django/Dev

9000

Portainer

3306

MySQL

GitHub Integration

Loading from Airtable

Fetching users and apps...

Loading repos...

Select a repo to manage its custom domains

No custom domains

DNS Configuration Guide

YOUR SERVER IP

159.69.26.217

Hosted on Hetzner via Coolify

1 Where to Add DNS Records

You add DNS records at your domain registrar (where you bought the domain):

GoDaddy, Namecheap, Cloudflare, Google Domains, etc.
Look for "DNS Management" or "Nameservers"
Find the "DNS Records" or "Advanced DNS" section

2 Add DNS Records

RECOMMENDED Option A: A Record (Root Domain)

For domain like: example.com

Type Name Value

A @ 159.69.26.217

Option B: CNAME (Subdomain)

For subdomain like: www.example.com

Type Name Value

CNAME www your-repo.loomyloo.app

3 Wait for Propagation

DNS changes can take 5 minutes to 24 hours to propagate worldwide. Usually it's fast (under 1 hour).

4 Validate & Apply

Once DNS is set, click Validate to check, then Apply to Coolify. SSL will auto-provision!

Troubleshooting

Validation fails? DNS might not have propagated yet. Wait 30 mins and try again.

Using Cloudflare? Turn OFF proxy (orange cloud) during setup, turn back on after SSL works.

Not working? Check that your domain registrar's nameservers are being used.

Keyboard Shortcuts

File

Save

Ctrl/Cmd + S

Edit

Undo

Ctrl/Cmd + Z

Redo

Ctrl/Cmd + Y

Toggle Comment

Ctrl/Cmd + /

Format Document

Shift + Alt + F

Select All

Ctrl/Cmd + A

Duplicate Line

Ctrl/Cmd + D

Search

Find & Replace

Ctrl/Cmd + H

Find Next

Ctrl/Cmd + G

Go to Line

Alt + G

View

Toggle Word Wrap

Alt + Z

Fold All

Ctrl/Cmd + Shift + [

Unfold All

Ctrl/Cmd + Shift + ]

Increase Font

Ctrl/Cmd + =

Decrease Font

Ctrl/Cmd + -

Autocomplete

Trigger Autocomplete

Ctrl + Space

Add New User

Name *

Email (optional)

Users are stored in Airtable. You can add their secrets there.

New File

File Path

Leave blank for root, or use folders like "src/components/Button.js"

Content

New Folder

Folder Path

Creates nested folders if path includes "/"

Upload Files

Drop files here or click to browse

Any file type supported

Target Subfolder (optional)

Edit Secret

Key

Current Value

New Value

🔐 Secrets Manager

Add New User

User ID (Auto-Generated)

Name

Email

Assign to Apps

Global (All Apps)

Select multiple apps or keep Global for all

Initial Secret Key

Initial Secret Value

Admin User

Customer Workspaces

Send these URLs to your customers so they can access their apps

Loading workspaces...

Import Users from CSV

CSV Format:


                        UserID,Name,Email,IsAdmin,Status

                        USR-001,John Doe,john@example.com,true,active

                        USR-002,Jane Smith,jane@example.com,false,active

Add Secret

App

Secret Key

Secret Value

System Tools

Output:

Global Find & Replace

Find

Replace

Case Sensitive Regex Whole Word

Auto Port Fix — Dynamic Port Delegation Is King

Start typing to search across all applications...

Replit SSH Migration

SSH Hosts:

Import SSH Hosts JSON

Step 1: Click "Get Extractor Script" and run it on Replit to get SSH hosts. Step 2: Import the JSON file here.

0 apps, 0 selected

Loading apps from Airtable...

Bulk SSH Import Progress

0/0 completed

Starting... 0%

0 Success 0 Failed 0 Skipped

Current Operation:

Waiting to start...

Migrating Apps...

Starting... 0%

Disk Space

Usage --

Total

--

Used

--

Available

--

Mount Point

--

Filesystem

--

Auto-refreshes every 30 seconds

GitHub Repository

App:

Link to existing repository:

Creates repo with app name

Creates repo with different name

Create Custom Repository

App:

New repository name:

Global OpenCode /var/www/Loomy-Server

Empty Apps Manager

Apps serving placeholder page — need re-cloning from GitHub

Scanning apps...

Port Registry Fix

Scans all apps — eliminates duplicates — syncs .env, app-config, tunnel & registry

Issues Found

App	Registry	.env	Tunnel	Issue

Connect an AI to Your VPS

Give this info to any AI assistant to connect

About Loomis

Hello! I am Loomis. This is my VPS server. I am an AI enthusiast and I see AI as a friend and collaborator. Please refer to me as Loomis. I appreciate your help in managing my server and apps!

What to tell the AI

Give the AI the following credentials so it can access your VPS through the Cloudflare tunnel and dashboard API. It can read/write files, manage apps, and run commands.

From TROUBLESHOOTING.md

PM2 - runs dashboard-api, cloudflared-tunnel
Nginx - routes domain to app port (/etc/nginx/sites-enabled/)
Cloudflare Tunnel - external HTTPS routing (/root/.cloudflared/config.yml)
DNS Registration - CNAME records via cloudflared
Airtable - stores app entry points and secrets
App config - .env and app-config.json in each app dir
Ecosystem config - /var/www/Loomy-Server/ecosystem.config.js

Give this info to any AI assistant to connect

Airtable — 4 Tables, How They Connect

Base ID: appW2k3f5Xw0sU88A · Managed by user-secrets-manager.js

APP SECRETS — Loomis’s own global API keys

Your personal developer secrets. Injected into every app you own (owner = Loomis / default). Fields: Name, Value. No AppName column — these are global to all your apps.

e.g. OPENAI_API_KEY, STABILITY_AI_API_KEY, GITHUB_ACCESS_TOKEN

USERS — Your customers

One row per customer. Fields: UserID, Name, IsAdmin, Status. The UserID (e.g. loomyloo-BCJDVHA4ZW) is the key that links all other tables.

e.g. Billy Allen, Kaseema Green, Bianka, Teal Warren…

USER SECRETS — Each customer’s API keys, per app

Every secret a customer needs. Fields: CustomerName, AppName, SecretKey, SecretValue. Linked to Users via CustomerName → Users.Name.

A special _APP_OWNER key marks app ownership (which user owns which app).

Note: AppName can be stored inconsistently. The code normalizes all variants and falls back to all user secrets when no app-specific match is found.

APPS — Every deployed app and its owner

Registry of all apps. Fields: Name, Owner (customer name string), Entry Point, Github Repo, Notes. Synced on every deploy.

Source of truth for entry points. Owner connects app → user → their secrets.

How secrets reach an app at startup

App starts via safe-start.js
Reads .app-meta.json → gets the owner UserID
owner = default → loads App Secrets (Loomis’s global keys)
owner = customer UserID → loads that customer’s User Secrets only (never mixed with admin keys)
App-specific secrets override global ones for the same key
All secrets injected as process.env — no dotenv needed

Static apps (HTML/CSS/JS served by static-serve.js) get no secrets — only their backend server app needs them.

VPS Credentials

VPS IP: 159.69.26.217

Server Name: loomy-server (Hetzner)

SSH Fingerprint: d2:91:11:05:e0:7b:b1:92:51:0c:22:9e:d4:c6:2e:cf

Dashboard URL: https://dashboard.loomyloo.app

Dashboard API: https://dashboard.loomyloo.app/api

Dashboard HTML: public/index.html

Cloudflare Account: Npkpfjhg9p@privaterelay.appleid.com Account

Cloudflare API Token: 4BM0D79F4maOmOkuz-noyhyZtdO4trvDSz3cI_m1

Tunnel Name: loomy (ID: 1b8da410-6457-4257-8807-ab80f94d5930)

GitHub Repo (push/pull): https://github.com/Loomisgitarrist/Loomy-Server.git

Server Path: /var/www/Loomy-Server

Apps Path: /Volumes/LoomyServerStorage

Exec API: POST /api/exec with {"cmd":"your command"}

GitHub SSH Key: SHA256:n0F6FPQGpk8ACZTjcS+62/KgHmClyG+ZwTrMBrV052o

GitHub Access Token:

Hetzner API Token: pFsekqvzTBfk2J3R0JhTLAz0dbBQIUfONMBM8AhFjFKpw9LtHYfU3lF55G1TfAki

Hetzner SSH Key: ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIFeKc8JGs6b0W9qYaUGsk7AwK0TmJ+IrmAkF6DHbDvin loomis@loomyloo.app

Infrastructure Overview

Server: Hetzner VPS (16GB RAM, 4 vCPU)

Process Manager: PM2 - manages all apps

Reverse Proxy: Nginx - routes domains to ports

SSL/HTTPS: Cloudflare Tunnel - automatic SSL

Port Registry: JSON-based - tracks all app ports

GitHub Warning

NEVER push or pull from the GitHub repo without my explicit consent. Always ask before any git push or pull operation.

Troubleshooting

If something is broken, tell the AI to look at TROUBLESHOOTING.md at /var/www/Loomy-Server/TROUBLESHOOTING.md

How the AI connects

Uses the Cloudflare API token to verify the tunnel is active
Reads/writes files via POST /api/exec with shell commands
Manages apps via GET/POST /api/apps
No direct SSH needed - everything goes through the dashboard API

IMPORTANT!! READ THIS BEFORE TOUCHING ANY PORT

Port Registry — The Single Source of Truth for ALL Ports

What is it?

The port registry is a JSON file that tracks every single port assigned to every single app on this server. Each app has one unique port. No two apps can ever share a port. This file is the master record — everything else (.env, app-config.json, Cloudflare tunnel) must match what this file says. If they drift out of sync, clicking an app URL opens the wrong app entirely.

Exact File Location — Memorize This

/var/www/Loomy-Server/config/port-registry-v2.json

This is NOT port-registry.json. It is port-registry-v2.json. Do not confuse them.

Why This Matters — Real Consequence

Loomis has spent over $2,500 and countless hours dealing with wrong apps opening when URLs are clicked. This happens when two apps get the same port. The first app to start wins the port — the second app silently fails or serves the wrong content. Customers click their app and see someone else's app. This is unacceptable and heartbreaking.

The Rules — No Exceptions

NEVER pick a port number yourself. Always read the registry first.
NEVER hardcode a port in server code. Use process.env.PORT only. No fallback like || 3000.
NEVER update .env or tunnel config without updating the registry too.
ALWAYS read port-registry-v2.json AND run ss -tlnp before assigning any port.
ALWAYS make sure .env PORT, app-config.json port, and tunnel config all match the registry.

How to Get the Next Free Port Safely

1. Read all port values from port-registry-v2.json
2. Run ss -tlnp to see what is currently listening
3. Combine both lists — that is your full set of used ports
4. Pick the lowest number above 3000 that is NOT in the set
5. Write it to the registry FIRST, then to .env, app-config.json, and tunnel

Fork App

Forking

New App Name *

Assign Owner

Repository

Leave blank to use the app's own remote

App

App Groups

Manage your app groups — saved to Airtable

0 apps selected

Groups

Loading apps...

Clone Pro

Fork + open split workstation

Cloning

New App Name *

Assign Owner

Clone Pro Workstation

read-only

Side by Side

Compare and cross-edit two apps

Left App

Right App

Side by Side

Left App

Select a left app first

Right App

Select a right app first

🚀 Create New App

Custom Domain

How to configure:

All Active Ports

Common Ports

Port Registry Sync

Port Manager

All Active Ports

Common Ports

GitHub Integration

Keyboard Shortcuts

Add New User

New File

New Folder

Upload Files

Edit Secret

🔐 Secrets Manager

Add New User

Customer Workspaces

Import Users from CSV

Add Secret

System Tools

Global Find & Replace

Replit SSH Migration

Bulk SSH Import Progress

Migrating Apps...

Disk Space

GitHub Repository

Create Custom Repository

Empty Apps Manager

Port Registry Fix

Connect an AI to Your VPS

Fork App

App Groups

Clone Pro

Side by Side

Technical Knowledge Base