Setup V-Portal
This guide walks you through installing V‑Portal in your environment and completing the initial setup required to get up and running.
System Requirements
Ensure the target environment meets the following requirements before installing V‑Portal:
| Operating System | Any Docker supported OS (Ubuntu 20.04+ recommended) |
| Docker | Version 20.10+ |
| Docker Compose | Compose**: Version 2.0+ |
| RAM | Minimum 4GB, recommended 8GB+ |
| Disk Space | Minimum 10GB free |
Steps to Install
- Download the V-Portal Installer
- Prepare the target host/environment
- Ensure the OS and platform match the prerequisites listed above.
- Copy the V-Portal installer to the target server, place it in a directory where you can acquire root access.
- Ensure dependencies are installed (Docker)
- Run the installer using the commands below:
chmod +x v-portal-installer.run
./v-portal-installer.run- Verify the installation
- Access the V-Portal webpage from a browser using your device’s IP and confirm the login page loads.
Perform a basic smoke test (login, navigate to 1–2 key screens, verify no obvious errors).
Post-Installation
After installation, proceed to Login and First-time Access to begin using V-Portal.
Initial Setup Steps
Complete these steps to configure your V-Portal instance for first use.
User Management Setup
-
Create Additional Users
- Navigate to Settings → User Management
- Add team members with appropriate roles
-
Configure Roles
- Define user roles and permissions
- Assign roles to users
System Configuration
Network Settings
Configure network access:
- Port configurations
- Proxy settings (if applicable)
- SSL/TLS certificates (for production)
Module Installation
Install required modules for your use case:
- Navigate to Modules section
- Upload module files (
.vmod) - Configure module settings
- Enable modules
Creating Your First Page
- Go to Pages
- Click “Create New Page”
- Add widgets to your page
- Save and view your page
Next Steps
Last updated on