Octane

Source: src/Railway/Website/Octane.ts

Deploy an OctaneJS application to Railway: Octane’s SSR server plus client assets on one Railway.Service.

The project’s octane.config.ts must select the Node marker adapter:

import { node } from "@alchemy.run/frontend-frameworks/octane/node-adapter";
import { defineConfig } from "@octanejs/vite-plugin";

export default defineConfig({
  adapter: node(),
  // ...
});

During alchemy dev the site is Octane/Vite’s own dev server and no cloud resources are created. Alchemy.remote() opts back into the live Service path.

Creating Octane Sites

const site = yield* Railway.Website.Octane("Web", {
  rootDir: "./app",
});

Server Configuration

const site = yield* Railway.Website.Octane("Web", {
  rootDir: "./app",
  env: {
    API_BASE: "https://api.example.com",
  },
});