Skip to main content

Ports And Endpoints

This page lists the important runtime endpoints exposed by SVRunner.

Default Port

In a normal host-based deployment, the default server port is:

7376

In the documented Docker flow, the container runtime example uses:

8080

Always confirm which port your deployment actually uses.

Main Routes

The server currently exposes these important routes:

Web Application

/

This serves the main SVRunner web app.

GraphQL HTTP Endpoint

/graphql

This is the primary API endpoint for queries, mutations, and multipart uploads.

Example:

http://<server-address>:7376/graphql

GraphQL Subscription Endpoint

ws://<server-address>:7376/graphql

Use wss:// if your deployment is running behind HTTPS/TLS.

Static Asset Route

/static

This serves uploaded or generated asset files from the server assets directory.

Preview Route

/preview

This serves the preview player experience used for generated playlist inspection.

Documentation Route

/docs

This serves the Docusaurus documentation site.

Example Host URLs

Common examples in a default host deployment:

  • http://localhost:7376/
  • http://localhost:7376/graphql
  • ws://localhost:7376/graphql
  • http://localhost:7376/static/...
  • http://localhost:7376/preview
  • http://localhost:7376/docs

Filesystem Context

Some routes are backed by runtime directories:

  • /static serves from SVR_SERVER_ASSETS_DIR
  • /preview serves the built preview app
  • /docs serves the built docs app
  • / serves the built client app

Operational Guidance

  • verify /, /docs, and /graphql during deployment validation
  • verify /preview when testing schedule preview workflows
  • use /static carefully when troubleshooting asset accessibility

Deployed Routes Validation Stub screenshot: browser showing the main app, /docs, and /graphql reachable from the deployed server. Save final image at packages/docs/screenshots/reference-ports-endpoints-browser.png.