Getting Started
Welcome to Druvium
Druvium is Zahid Hasan's personal HomeLab management platform, designed and built by a Senior Software Engineer at BJIT LTD. This guide will help you understand and navigate this sophisticated platform for managing self-hosted applications and services.
First Steps
- Login: Use your authorized credentials to access the dashboard
- Dashboard: Navigate to the HomeLab dashboard to see available applications
- Explore Applications: Browse the organized collection of self-hosted services
- Organization: Understand the tag and category system for better navigation
Note: This is a private HomeLab system. Access is by invitation only.
Contact Zahid Hasan at zhdruvo@gmail.com for access requests.
User Management
User Roles
Super Administrator
- ? Full system access
- ? User management
- ? Application management
- ? System configuration
Administrator
- ? User management
- ? Application management
- ? Tag/Category management
- ? System configuration
User
- ? View applications
- ? Access dashboard
- ? Add applications
- ? User management
Application Management
Adding Applications
To add a new application to your HomeLab:
- Navigate to Administration ? Deploy Application
- Fill in the application details:
- Title: The name of your application
- Description: Brief description of what the app does
- URL: The web address to access the application
- Icon URL: Link to an icon image (optional)
- Color: Theme color for the application card
- Select appropriate tags and categories
- Configure additional options (pinned, enhanced monitoring)
- Click "Create Application"
Organization
Tags
Use tags to categorize applications by function:
- Media (streaming, photos)
- Monitoring (metrics, logs)
- Storage (cloud, backup)
- Network (VPN, DNS)
- Development (git, CI/CD)
Categories
Use categories for high-level organization:
- Productivity
- Entertainment
- Communication
- System Tools
- Home Automation
Security
Authentication
Druvium uses ASP.NET Identity for secure user authentication:
- Password-based authentication
- Secure session management
- Role-based authorization
- HTTPS encryption
Best Practices
Security Recommendations:
- Use strong passwords for all accounts
- Regularly update user permissions
- Monitor system logs for suspicious activity
- Keep the application updated
- Use HTTPS in production environments
API Reference
REST API Endpoints
Druvium provides REST API endpoints for programmatic access:
Applications
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/applications |
Get all applications |
| GET | /api/applications/{id} |
Get specific application |
| POST | /api/applications |
Create new application |
| PUT | /api/applications/{id} |
Update application |
| DELETE | /api/applications/{id} |
Delete application |
Note: API endpoints require proper authentication and authorization.
Troubleshooting
Common Issues
Possible causes:
- Application is not running
- Incorrect URL format
- Network connectivity issues
- Firewall blocking access
Solutions:
- Verify the application is running on the specified port
- Check URL format (include http:// or https://)
- Test network connectivity to the host
- Review firewall rules
Possible causes:
- Incorrect credentials
- Account locked
- Session expired
Solutions:
- Verify username and password
- Contact administrator to unlock account
- Clear browser cache and cookies
- Try accessing from a different browser
Possible causes:
- Invalid icon URL
- CORS policy restrictions
- Network timeout
Solutions:
- Verify icon URL is accessible
- Use local icons or image proxy
- Check network connectivity
- Use HTTPS URLs for icons when possible
Getting Help
If you need additional assistance:
- Check the System Status page for current system health
- Review application logs and error messages
- Contact the system administrator: Zahid Hasan (zhdruvo@gmail.com)
- Submit an issue on GitHub: github.com/Druvo/Druvium
- Visit the Contact page for professional inquiries
About the Developer: Zahid Hasan is a Senior Software Engineer at BJIT LTD,
specializing in C# .NET development. Connect with him on
GitHub or
visit his portfolio.