while25 TERMINAL

Download & get started

Cross-platform trading terminal for backtesting and paper trading. Live order routing arrives in a future cloud-hosted release. Total setup time is about 10 minutes; download + install is about 3.

Step 1 — Account

Register your while25 account

Required to launch the terminal. Beta accounts are free; you'll auto-receive a 2-month beta license on registration. Do this first while you wait for the download.

Open the registration page

Visit while25.com/register in your browser. Enter your email and choose a password.

You'll be auto-approved with a 2-month beta license — no admin step required.

Keep your credentials handy

You'll need this email + password when the terminal first launches. The desktop app blocks all panels until you log in.

Forgot password?

Reset at while25.com/forgot-password. Or contact support@while25.com.

Step 2 — Download

Pick your platform

We highlight the build for your detected operating system. All builds are unsigned during beta — see the install steps below for the one-time bypass.

Step 3 — Install

Install while25 Terminal

Pick the tab matching your download. Each step is exact — copy commands as-is.

Open the downloaded .dmg file from Finder. A new window opens with the while25 Terminal icon.
Drag while25 Terminal into the Applications folder shortcut shown in that window.
Open Applications in Finder and double-click while25 Terminal. macOS will block the launch with a "cannot be opened because the developer cannot be verified" dialog. Click Cancel — this is expected.
Open Terminal (Spotlight: ⌘ Space → "Terminal"). Run the following exactly to remove the macOS quarantine attribute that's blocking the unsigned beta build:
xattr -dr com.apple.quarantine "/Applications/while25 Terminal.app"

Why is this needed? We're shipping unsigned builds during beta. Apple Notarization will be added before paid release. The xattr command removes the quarantine flag macOS adds to internet-downloaded apps, only for this single binary. It does not weaken any other security.
Re-launch while25 Terminal from Applications. It opens normally now and remembers — no need to repeat xattr again.

Alternative — without Terminal Right-click the app icon → Open. The first time only, you'll get an Open Anyway button after dismissing the warning. Same effect, more clicks.

Double-click the downloaded .msi file. The Windows Installer wizard opens.
Windows SmartScreen flags the unsigned beta with "Microsoft Defender SmartScreen prevented an unrecognized app from starting". Click More info, then Run anyway.
Step through the installer (Next → Install → Finish). Default install location is C:\Program Files\while25 Terminal\.
Launch while25 Terminal from the Start menu. Pin to taskbar if you like.

Antivirus false positives Some AV vendors flag unsigned new binaries. Add C:\Program Files\while25 Terminal\ as an exception if your AV blocks the launch. Code-signing is on the v1.x roadmap.

Debian / Ubuntu users: open a terminal in the directory you downloaded the .deb to, then run:
sudo apt install ./while25-1.0.0-linux-amd64.deb
Launch from your application menu (search "while25") or from terminal:
while25-terminal
Other distros — use the AppImage:
chmod +x while25-1.0.0-linux-amd64.AppImage ./while25-1.0.0-linux-amd64.AppImage

libwebkit2gtk-4.1 required Tauri apps depend on WebKitGTK 4.1. Ubuntu 22.04+, Fedora 38+, Debian 12+ ship it. If you hit a "missing library" error on launch: sudo apt install libwebkit2gtk-4.1-dev libappindicator3-1 librsvg2-2

Step 4 — Broker

Connect your broker (Upstox)

while25 needs a broker API key to fetch market data and route orders. Beta supports Upstox; more brokers coming.

Sign up at Upstox if you haven't

You need a real Upstox trading account. Register at upstox.com. KYC takes 24–48 hours; do this first if you don't already have an account.

Open the Upstox Algo Trading apps page

Direct link: account.upstox.com/developer/apps → click the Algo Trading tab.

Why Algo Trading and not Analytics? Upstox now splits developer apps into Analytics (read-only data), Algo Trading (data + order placement), and Sandbox (paper-only). while25 needs Algo Trading for both market data and the order routing endpoints. Don't pick Analytics — orders will be rejected.

Create a new Algo Trading app

On the Algo Trading tab, click the + App button (top right). Fill the form:

App settings • App Name: while25 Terminal (any name; only you see it)
• Redirect URI: http://127.0.0.1:1420/auth/callback
• Description: optional

Submit. Upstox issues an API key and API secret — copy both somewhere safe (you can also retrieve them later from the same page by clicking the app row).

Enter the credentials in while25 Terminal

In the running app, click the broker indicator (top status bar). Paste your API key and API secret. The terminal opens an Upstox OAuth window — log in to your Upstox account and authorize.

Daily token reset

Upstox tokens expire daily at 6:00 AM IST. The terminal reminds you to re-auth each morning — one click.

FAQ

Common questions

Stuck? Open the matching item below. If your question isn't here, send a bug report from inside the terminal (FEEDBACK button, top status bar) or email support@while25.com.

I get "while25 Terminal is damaged and can't be opened" on macOS

Same fix as the unsigned-binary case. Run:

xattr -cr "/Applications/while25 Terminal.app"

Then re-launch from Applications. -cr clears all extended attributes recursively.

SmartScreen still blocks me on Windows after "Run anyway"

Some Group Policy settings in corporate Windows installs override SmartScreen. Try:

Right-click the .msi → Properties → check Unblock → OK.
Re-run the installer.

Linux: "error while loading shared libraries: libwebkit2gtk-4.1.so.0"

Install the WebKitGTK 4.1 runtime:

sudo apt install libwebkit2gtk-4.1-0 libwebkit2gtk-4.1-dev libappindicator3-1 librsvg2-2

Older Ubuntu (20.04 or earlier) ships only WebKitGTK 4.0 — not supported. Upgrade or use AppImage with FUSE.

Upstox OAuth callback fails / "redirect_uri_mismatch"

Your Upstox app's Redirect URI must exactly match what the terminal sends. Confirm:

Upstox developer console → your app → Redirect URI = http://127.0.0.1:1420/auth/callback (exact, no trailing slash)
If you changed it, click Update and try OAuth again.

Orders get rejected with a permissions / scope error from Upstox

Almost always means the app you created is in the wrong category. Upstox splits developer apps into:

Analytics — read-only market data; cannot place orders
Algo Trading — data + full order placement (this is what while25 needs)
Sandbox — paper trading only; doesn't touch live markets

If you accidentally created an Analytics app, return to developer/apps, click the Algo Trading tab, then + App. Re-enter the new API key + secret in while25 Terminal.

Is live order routing available?

Not yet — paper trading and backtesting only during beta. We're moving live execution to a cloud-hosted terminal where order routing happens server-side. The desktop app will route orders through that service when it ships.

Can I uninstall safely? Will it leave files behind?

macOS: drag /Applications/while25 Terminal.app to Trash. App data lives at ~/Library/Application Support/while25-terminal/ — delete if you want a clean slate.

Windows: Settings → Apps → while25 Terminal → Uninstall. App data at %APPDATA%\while25-terminal\.

Linux: sudo apt remove while25-terminal (deb) or just delete the AppImage. App data at ~/.local/share/while25-terminal/.

How do I update to a new version?

For now: download the new release from this page and re-run the installer (overwrites in place; settings preserved). Auto-updater will land in v1.1.

System requirements

macOS: 12 Monterey or newer, Apple Silicon (M1/M2/M3/M4)
Windows: 10 (build 1809+) or 11, x64
Linux: Ubuntu 22.04+, Debian 12+, Fedora 38+, or any distro with WebKitGTK 4.1 + glibc 2.31+
RAM: 4 GB minimum, 8 GB recommended
Disk: ~150 MB install + space for backtest cache
Network: required for broker auth, market data, license check