Support & Troubleshooting

Get help with common issues and problems in V-Portal.

Common Issues

Installation Problems

Docker won’t start

Check Docker daemon is running
Verify port availability
Check system requirements

Database connection failed

Verify PostgreSQL is running
Check credentials in .env
Ensure database is initialized

Can’t log in with default credentials

Ensure you’re using admin/admin
Check if database was initialized
Verify backend is running

Session expires immediately

Check JWT secret configuration
Verify system time is correct
Check token expiration settings

Module Issues

Module won’t load

Check module compatibility
Verify module file integrity
Check backend logs for errors

Module features not working

Ensure module is enabled
Check module configuration
Verify dependencies are met

Log Files

Backend Logs


docker logs v-portal-backend

Frontend Logs

Check browser console (F12)

Database Logs


docker logs v-portal-db

Debugging

Enable Debug Logging

Set in .env:


LOG_LEVEL=DEBUG

Common Debug Commands


# Check running containers
docker ps
 
# Restart services
docker-compose restart
 
# View logs
docker-compose logs -f

Getting Help

Documentation

Read the relevant section in docs
Check API reference
Review examples

Community Support

Check GitHub issues
Ask on community forums
Contact VIKASO support

Reporting Bugs

When reporting issues, include:

V-Portal version
Error messages
Steps to reproduce
Log excerpts
System information

Performance Issues

Slow Page Loading

Check network connectivity
Verify backend response times
Optimize widget count

High CPU Usage

Check for infinite loops in Python scripts
Verify data field update rates
Review module resource usage

Memory Issues

Monitor container memory
Check for memory leaks
Optimize data field storage

More troubleshooting guides coming soon!