BootUI
Try it
Setup
Features
Workshop
Properties
AI agents
Ecosystem
GitHub
Try it
Setup
Features
Workshop
Properties
AI agents
Ecosystem
GitHub
  • Get started

    • Try the sample app
    • Setup
    • Spring WebFlux
    • Quarkus
    • Java agent
    • Activation and safety
    • Non-standard runtimes
    • Troubleshooting
  • Workshop

    • Workshop overview
    • 00 - Runtime understanding
    • 01 - Setup and tooling
    • 02 - Configuration and wiring
    • 03 - Runtime journal
    • 04 - Runtime Insights
    • 05 - Java instrumentation
    • 06 - Assessment and impact
    • 07 - Agent change loop
    • 08 - Going further
    • Participant worksheet
    • A - Prompts
    • B - Troubleshooting
    • C - Frameworks
    • D - Extensions
  • Features

    • All features
    • Scorecard
    • Live Activity
    • Runtime Insights
    • Advisors
    • Runtime
    • Configuration
    • Database
    • Security
    • Services
    • Diagnostics
    • Java Agent
    • Developer tools
  • Reference

    • Properties
    • Framework support
    • AI agents
    • Command line
    • BootUI family
    • Known limitations
  • Diagnostic checks

    • Architecture
    • REST API
    • Spring
    • Hibernate
    • Database
    • Security
    • Vulnerabilities
    • Memory
    • Pentesting
    • GraalVM readiness
    • CRaC readiness
    • Quarkus
    • Quarkus security
  • Contributing

    • Repository
    • Specification
    • Implementation plan
    • v2 plan
    • Try 2.0 early
    • v2 validation report
    • Releasing 2.0
    • Quarkus design notes
    • WebFlux design notes
  • Privacy

Troubleshooting

SymptomCheck
/bootui returns 404Activate the dev or local profile, add DevTools, or set bootui.enabled=ON, then open the configured bootui.path. In application.yml, bootui.enabled: ON is valid: YAML parses it as a boolean, which BootUI accepts.
BootUI is disabled in prodThis is intentional. Only bootui.enabled=ON forces activation with a disabled profile.
The browser is rejectedBootUI accepts loopback callers and fails closed for everything else. In a container, set bootui.trust-container-gateway=AUTO. For a custom proxy, bridge, or LAN access, add the source range to bootui.trusted-proxies and the hostname you browse with to bootui.allowed-hosts. See running inside a Docker container.
Spring Security blocks the UIBootUI registers a permit-all chain for the configured UI and API paths when Spring Security is active. Look for a custom chain with a higher precedence.
localhost redirected you too many timesBootUI serves the console at both /bootui and /bootui/ with no redirect, so a trailing-slash-stripping filter or proxy cannot loop on it. On an older BootUI, upgrade or open /bootui/ directly.
A command-line app now stays upExpected: BootUI starts a servlet server so the console stays reachable. Set bootui.force-web=false to keep the application non-web.
A panel is emptyEnable the relevant Actuator endpoint or optional Spring module. BootUI degrades to stable empty responses when data is unavailable.
Startup Timeline is emptyKeep bootui.startup.enabled=true and bootui.startup.capacity above zero, or provide your own BufferingApplicationStartup.
Secrets are hiddenDefault exposure is MASKED. Use METADATA_ONLY to hide all values, or FULL only in a trusted local session.
Static resources are disabledBootUI bypasses spring.web.resources.add-mappings=false for its own assets at the configured bootui.path and logs a WARN line. Your application's other static resources stay disabled.
Prev
Non-standard runtimes

© 2026 Julien Dubois