Skip to main content

​
Troubleshooting

Find solutions to common issues when working with Docus.

​
Installation Issues

​
better-sqlite3 Build Errors

​
Dependency Resolution Errors

​
Node Version Compatibility

​
Development Issues

​
Port Already in Use

​
Hot Module Replacement (HMR) Not Working

​
Content Not Displaying

​
Component Issues

​
Custom Components Not Rendering

​
MDC Syntax Errors

​
Build Issues

​
Build Fails in Production

​
Static Generation Errors

​
Search Issues

​
Search Not Working

​
Internationalization Issues

​
Language Switching Not Working

​
Performance Issues

​
Slow Build Times

​
Slow Page Loads

​
Getting Help

Still experiencing issues? Here’s how to get help:
1

Check the documentation

Browse the complete Docus documentation for detailed guides.
2

Search existing issues

Check GitHub Issues to see if your problem has been reported.
3

Ask the community

Join GitHub Discussions or the Nuxt Discord.
4

Report a bug

If you found a bug, create a new issue with:
  • Docus version
  • Node.js version
  • Package manager and version
  • Steps to reproduce
  • Expected vs actual behavior

​
Useful Commands

Keep these commands handy for troubleshooting: 
# Clear all caches and reinstall
rm -rf .nuxt .output node_modules/.cache node_modules
npm install

# Check versions
node --version
npm --version
npm list docus nuxt

# Rebuild native dependencies
npm rebuild better-sqlite3

# Verbose build for debugging
DEBUG=* npm run build

# Production build test locally
npm run build
node .output/server/index.mjs

​
Additional Resources

Docus Documentation

Complete documentation for Docus

Nuxt Documentation

Learn more about Nuxt framework

Nuxt Content Docs

Deep dive into Nuxt Content features

GitHub Repository

View source code and report issues

Build docs developers (and LLMs) love

Get started for freeTalk to us