Troubleshooting Guide

Table of Contents

Common Issues

Below are the most frequently reported problems and quick fixes.

Check that all required dependencies are installed and that the environment variables are set correctly.

# Verify Node version
node -v

# Install missing packages
npm install

Session expiration may be caused by cookie settings. Ensure the sessionTimeout configuration aligns with your policy.

// config/session.js
module.exports = {
    sessionTimeout: 30 * 60 * 1000 // 30 minutes
};

Diagnostic Steps

  1. Reproduce the error and note the exact message.
  2. Check the server logs (/var/log/app/error.log).
  3. Run the built‑in health check: npm run health.
  4. If the problem persists, collect a debug dump and open a ticket.

Error Codes

Code Description Solution
E101 Database connection timeout Increase DB timeout in config/db.js.
E202 Invalid API token Regenerate token via the admin portal.
E303 Insufficient permissions Assign the required role to the user.

FAQ

Q: How do I reset my password?
A: Use the Password Reset page.

Q: Where can I find the API documentation?
A: Visit the API Docs section.