Starting the server

This section describes how to start the server in development and production mode.

Development

If VITE_DEV_MODE and VITE_USE_SERVER_LIFESPAN are both set to true, the run command will automatically start vite during the server_lifespan startup hook of the Litestar CLI.

Additionally, when you start the application with VITE_HOT_RELOAD set to true, it will also enable the HMR websocket connection to Vite. This will allow the main Granian (or Uvicorn) web server to support Vite’s hot reload functionality.

Starting the server in dev mode

(.venv) cody@localtop:~/Code/Litestar/litestar-fullstack$ pdm run app run -p 8089
Using Litestar app from env: 'app.asgi:app'
Loading environment configuration from .env
Starting Granian server process ───────────────────────────────────────────────────────
┌──────────────────────────────┬──────────────────────────────────────────────────────┐
│ Litestar version             │ 2.8.2                                                │
│ Debug mode                   │ Enabled                                              │
│ Python Debugger on exception │ Disabled                                             │
│ CORS                         │ Enabled                                              │
│ CSRF                         │ Disabled                                             │
│ OpenAPI                      │ Enabled path=/schema                                 │
│ Compression                  │ Disabled                                             │
│ Template engine              │ ViteTemplateEngine                                   │
│ Middlewares                  │ JWTCookieAuthenticationMiddleware, LoggingMiddleware │
└──────────────────────────────┴──────────────────────────────────────────────────────┘
Starting Vite process with HMR Enabled ────────────────────────────────────────────────
Starting SAQ Workers ──────────────────────────────────────────────────────────────────

> dev
> vite

[INFO] Starting granian (main PID: 55642)
[INFO] Listening at: http://0.0.0.0:8089
[INFO] Spawning worker-1 with pid: 55689

  VITE v5.2.9  ready in 273 ms

  ➜  Local:   http://localhost:5174/static/
  ➜  Network: http://10.23.18.75:5174/static/
  ➜  press h + enter to show help

  LITESTAR   plugin v0.5.1

  ➜  APP_URL: http://localhost:8089
Loading environment configuration from .env
[INFO] Started worker-1
[INFO] Started worker-1 runtime-1

Production

If VITE_DEV_MODE is false, the server will look for the static assets that are produced from the npm run build command. This command is automatically executed and the assets are bundled when running pdm build.

To manually rebuild assets, use the following:

Generates static assets from Vite and runs the application.

  (.venv) cody@localtop:~/Code/Litestar/litestar-fullstack$ app assets build
  Using Litestar app from env: 'app.asgi:app'
  Loading environment configuration from .env
  Starting Vite build process ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────

  > build
  > vite build

  vite v5.2.9 building for production...
  ✓ 222 modules transformed.
  src/app/domain/web/public/manifest.json                  0.53 kB │ gzip:   0.22 kB
  src/app/domain/web/public/assets/favicon-DXHXvpft.png    7.69 kB
  src/app/domain/web/public/assets/main-D9hDRSjL.css      34.22 kB │ gzip:   6.88 kB
  src/app/domain/web/public/assets/main-gDMW9BNa.js       41.96 kB │ gzip:  10.46 kB
  src/app/domain/web/public/assets/vendor-DcvSTexI.js    493.83 kB │ gzip: 155.51 kB
  ✓ built in 2.91s
  Assets built.

Starting the server in production mode

(.venv) cody@localtop:~/Code/Litestar/litestar-fullstack$ app run -p 8089
Using Litestar app from env: 'app.asgi:app'
Loading environment configuration from .env
Starting Granian server process ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
┌──────────────────────────────┬──────────────────────────────────────────────────────┐
│ Litestar version             │ 2.8.2                                                │
│ Debug mode                   │ Enabled                                              │
│ Python Debugger on exception │ Disabled                                             │
│ CORS                         │ Enabled                                              │
│ CSRF                         │ Disabled                                             │
│ OpenAPI                      │ Enabled path=/schema                                 │
│ Compression                  │ Disabled                                             │
│ Template engine              │ ViteTemplateEngine                                   │
│ Middlewares                  │ JWTCookieAuthenticationMiddleware, LoggingMiddleware │
└──────────────────────────────┴──────────────────────────────────────────────────────┘
Serving assets using manifest at `/home/cody/Code/Litestar/litestar-fullstack/src/app/domain/web/public/manifest.json`. ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Starting SAQ Workers ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
[INFO] Starting granian (main PID: 47755)
[INFO] Listening at: http://0.0.0.0:8089
[INFO] Spawning worker-1 with pid: 47760
Loading environment configuration from .env
[INFO] Started worker-1
[INFO] Started worker-1 runtime-1