Bug: project not starting on Mac Sequioa 15.7.3

[Beenhakker]

Description

Project not running after following the exact setup steps on a Mac.

URL to code causing the issue

https://github.com/litestar-org/litestar-fullstack/

MCVE

New Litestar user here. Came across the "fullstack example" repo, and wanted to give it a try. 

I followed the exact steps in the described in the README.md to get the project running.

When running `app run`, I get the following (non-descriptive) error:

--

(litestar-fullstack) litestar-fullstack % app database upgrade

Loading environment configuration from .env
Using Litestar Fullstack Template app from env: 'app.server.asgi:create_app'
Starting database upgrade process ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Are you sure you want migrate the database to the `head` revision? [y/n]: y
2026-02-16T22:00:41.246172Z [info     ] Context impl PostgresqlImpl.  
2026-02-16T22:00:41.246308Z [info     ] Will assume transactional DDL.
2026-02-16T22:00:41.259423Z [info     ] Running upgrade  -> dc54b25d8b6c, initial
(litestar-fullstack) litestar-fullstack % app run

Loading environment configuration from .env
Using Litestar Fullstack Template app from env: 'app.server.asgi:create_app'
Starting Granian server process with uvloop ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
┌──────────────────────────────┬────────────────────────────────────────────────────────┐
│ Litestar version             │ 2.19.0                                                 │
│ Debug mode                   │ Enabled                                                │
│ Python Debugger on exception │ Disabled                                               │
│ CORS                         │ Enabled                                                │
│ CSRF                         │ Disabled                                               │
│ OpenAPI                      │ Enabled path=/schema                                   │
│ Compression                  │ Disabled                                               │
│ Middlewares                  │ JWTCookieAuthenticationMiddleware, ViteProxyMiddleware │
└──────────────────────────────┴────────────────────────────────────────────────────────┘
• Applied Vite environment variables
✓ Types exported → openapi: src/js/web/src/lib/generated/openapi.json
• Starting Vite server with HMR
✓ Vite process started
2026-02-16T22:01:07.208573Z [info     ] Starting granian (main PID: 62374)
$ vite
2026-02-16T22:01:07.236205Z [info     ] Listening at: http://0.0.0.0:8000
2026-02-16T22:01:07.242004Z [info     ] Spawning worker-1 with PID: 62631
2026-02-16T22:01:07.439169Z [error    ] Unexpected exit from worker-1 
2026-02-16T22:01:07.439544Z [info     ] Shutting down granian         
error: script "dev" was terminated by signal SIGTERM (Polite quit request)
• Vite process stopped.
--

I tried to debug it, printing configs and so on, but nothing apparent seems to be wrong. I tried searching for the "dev script", but nothing named similar or leads to something with a similar name.

Steps to reproduce

Follow the exact steps in the README.md on a Mac (Sequioa 15.7.3) to get the project running.

Screenshots

No response

Logs

Package Version

Latest as of this wring - 15th of February 2026.

Platform

• Linux
• Mac
• Windows
• Other (Please specify in the description above)

[kyle-li-dev]

After disabling the Granian plugin, it works.

[garethmj]

@Beenhakker did you also get a crash report from OS X for Python?

If so it's possible you hit the same issue as me (though I'm on Tahoe) which seems to be a known issue with _scproxy.get_proxies() being called inside a forked (Granian) worker thread.

In my case adding

no_proxy=*

to my .env file worked around the issue. I'm not clear on whether there is a real fix coming any time soon.