troubleshooting

before opening an issue, check this list of common problems and their fixes.

500 internal server error

check the Windows Event Log (or journalctl -u okommerce on Linux) for the exception details. most 500s are connection-string typos or missing migrations.

slow product list page

the catalog list page uses an indexed view. if it's slow, check that vw_ProductSearch exists and is current. rebuild via UPDATE STATISTICS.

payment gateway failures

check the gateway settings for test/live mode mismatch. check the IP allowlist on the gateway side. enable verbose logging in settings → payments → debug.

missing translations

locale strings are loaded into memory at startup. after editing strings, click settings → localization → reload cache or restart the app.

still stuck?

open an issue at github. include your okommerce version, .NET version, and the exception stack trace.