Skip to content

Installing

Ryan Bayne edited this page Oct 31, 2026 · 3 revisions

Installing and running

Status: active Category: E (product / user) Created: 2026-10-31 Last updated: 2026-10-31 Owner: TCS team

📄 Authoritative instructions: SETUP.md. This page summarises the choice; it does not replace them.

This is a source install, not an application package. There is no installer yet — packaging is tracked in #808.

Two tracks — decide first

Track A — web + API Track B — full stack
Adds MySQL, Node.js + Windows, MetaTrader 5, a broker account
Time ~10 minutes considerably longer
You get every page, the database, scoring, the Lab, backtesting, charts all of that plus live prices, positions, order placement
You do not get broker bridging, positions, order placement —

MetaTrader 5 is not required to run the app — only to trade through it, and to see state that only a broker holds. A Track A install is a working application, not a broken one.

The short version

git clone https://github.com/FifeCIC/Trading-Command-Suite.git
cd trading-command-suite
npm install
cd nest && npm install && cd ..
cp nest/.env.example nest/.env     # then set DATABASE_URL

Create the MySQL schema from nest/prisma/, then:

npm --prefix nest run start:dev    # API on :3201
npm run dev                        # frontend on :5173

Verify with curl http://localhost:3201/api/health — you want status: ok and database: connected. "mode": "fallback" is normal (no Redis), not a fault.

The one thing that will destroy your data

Never run prisma db push. schema.prisma is not the complete schema: several tables are managed outside Prisma — the trade execution queue among them — so db push drops them with the data still inside. It does not error; it warns and waits for a y.

npm --prefix nest run db:check     # read-only; names any table the schema does not know

Before you connect an account

Read the Financial Disclaimer. The software is not configured to profit by default, and a demo account is the only sensible place to start.

Stuck at any point? Troubleshooting lists the traps with the misleading message each one produces.

Clone this wiki locally