Production

Build and deploy Titan as a single native Rust binary without Node.js in production.

Titan production builds generate a single native Rust binary.
Node.js, npm, and the JavaScript toolchain are not required at runtime.

JavaScript is executed via an embedded runtime (Boa), while all networking, concurrency, and async execution are handled by Rust.

🏗️ Production Build

From your Titan project root, run:

titan build

Titan executes app/app.js --build to generate routing metadata and action mappings.

All JavaScript actions are bundled into deterministic .jsbundle artifacts.

A release-grade Rust binary is compiled using cargo build --release.

On success, you will see output similar to:

Titan: Building production output...
→ Building Titan metadata + bundling actions...
→ Found action bundle: getUser.jsbundle
→ Building Rust release binary...
✔ Titan production build complete!

📦 Build Output

After the build completes, the final artifact is located at:

titan-server

On Windows:

titan-server.exe

This binary is your entire backend.

No Node.js. No runtime dependencies. No JS process.

🚀 Deployment (Direct Binary)

Once built, you deploy Titan by uploading the binary.
No extra Titan commands, no build steps, no tooling required on the server.

You do not need to:

Run titan build again
Install Node.js or npm
Install Titan on the server
Use Docker (unless you want to)
Run any Titan-specific tooling

Typical deployment flow

Run titan build locally or in CI
Upload titan-server to your server or platform
Run the binary

That’s it.

Works on:

Any VPS
Bare metal
Systemd services
Cloud VMs
Any Rust-compatible platform

▶️ Running in Production

Run the binary directly:

./titan-server

Windows:

titan-server.exe

Titan starts immediately as a native server process.

🐳 Docker (Already Provided)

Titan projects ship with a fully ready Dockerfile.
You do not need to write or configure anything.

If you choose Docker, this is all you do:

titan build
docker build -t titan-app .
docker run -p 3000:3000 titan-app

Nothing else.

No Node.js image. No multi-stage hacks. No runtime JS.

Docker is optional, not required.

⚡ JavaScript Runtime in Production (Boa)

Boa does not reduce Titan’s production performance.

Facts:

JavaScript runs via Boa, embedded in the Rust server
HTTP, async I/O, threading, and scheduling are fully Rust-owned
There is no JavaScript event loop
Actions execute synchronously from Rust’s perspective

Boa is used only for business logic. Rust owns the performance-critical hot path.

Result:

Predictable latency
Stable throughput
No dev vs prod behavior gap

☁️ Deploy on Railway / Render (GitHub → Production)

For Railway and Render, you do not deploy the binary manually.
Just push your Titan project to GitHub and connect the repository. Don't forget to add the .gitignore

Titan projects ship with a fully production-ready Dockerfile.
Railway and Render automatically detect it and handle the entire build and runtime process.