// troubleshooting guide · penpot
Penpot Self-Hosted Stuck on localhost:9001
- Status
- Workaround available
- platforms:
- Self-hosted
- updated:
- November 15, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · penpot/self-hosted-public-uri-localhost3 FIXES
// quick answer
Set PENPOT_PUBLIC_URI to your HTTPS domain everywhere including the exporter, and add PENPOT_INTERNAL_URI.
Most likely fix: Fix URI settings
How to fix it
// try these in order, the most common fix is first
FIX 1Fix URI settings
- 01Set PENPOT_PUBLIC_URI to the public HTTPS domain on frontend, backend and exporter
- 02Set PENPOT_INTERNAL_URI to http://penpot-frontend:8080 for the exporter
Did this fix it?FIX 2Check proxy and WAF
- 01Allow application/transit+json on API paths
- 02Allow /ws/notifications websocket
Did this fix it?FIX 3Object storage
- 01For Cloudflare R2 set PENPOT_OBJECTS_STORAGE_S3_REGION to auto
Did this fix it?
Symptoms
Browser requests localhost:9001 behind a reverse proxy.
Why it happens
- C-01Wrong PENPOT_PUBLIC_URI on exporter
- C-02Reverse proxy WAF blocking requests
- C-03Wrong S3 region for R2 storage
// this guide also covers
- penpot localhost 9001
- penpot reverse proxy caddy
Still not working?
If Penpot keeps failing, you're not alone. See every Penpot problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to us