Skip to main content
DEJA.jsDEJA.js
Sign up

Installation

Getting the DEJA Server running takes about two minutes. One command installs everything — then you link your account and start the server.

Requirements

  • Node.js 20 or later — check with node --version. If you need to install it, visit nodejs.org.
  • A USB cable connecting your DCC-EX EX-CommandStation to the computer running the server.
  • A supported platform:
PlatformNotes
macOS (Intel or Apple Silicon)Works out of the box
Linux (x86_64 or ARM64)May need serial port permissions (see below)
Raspberry Pi (Pi 4 or 5)Runs great — plug in your EX-CommandStation via USB
WindowsSupported through WSL — run the installer from a WSL terminal

Install

Open a terminal on the computer connected to your EX-CommandStation and run:

curl -fsSL https://install.dejajs.com | bash

The Cloud app onboarding wizard walks you through the same steps — when you run deja login, your browser opens with your new layout ready to select, so the server links to the right place.

What the Installer Does

The installer handles setup automatically:

  1. Detects your platform — confirms macOS, Linux, or Raspberry Pi and the correct architecture.
  2. Checks Node.js — verifies you have Node.js 20 or later. If not, it tells you how to install it.
  3. Sets up configuration — creates the ~/.deja/ directory with your environment file and credentials.
  4. Detects serial ports — scans for USB devices that look like a DCC-EX EX-CommandStation.
  5. Downloads the server — pulls the latest release and installs dependencies.
  6. Installs the deja CLI — adds the deja command to your terminal so you can manage the server.

Once it finishes, two commands get you running:

deja login

Links this install to your DEJA Cloud account and layout — opens a browser tab to connect.

deja start

Launches the server and connects to your EX-CommandStation.

Serial Port Permissions (Linux / Raspberry Pi)

On Linux, your user account may need permission to access USB serial ports. If the installer warns you about this, run:

sudo usermod -a -G dialout $USER

Then log out and log back in for the change to take effect. This only needs to be done once.

Reinstalling

If something goes wrong or you want a fresh start, just run the install command again:

curl -fsSL https://install.dejajs.com | bash

This downloads a clean copy of the server and reconfigures everything. Your account and layout stay the same.

What Gets Installed

Everything lives in ~/.deja/ inside your home directory:

PathWhat it is
~/.deja/bin/dejaThe deja CLI command
~/.deja/server/The server runtime
~/.deja/config.jsonYour account and layout configuration
~/.deja/.envEnvironment variables (Firebase credentials, feature flags)
~/.deja/logs/Server log files

Next Steps