🎉 V-Portal 0.6.2 is released! Read more
Skip to Content
Quick StartFirst Steps in V‑Portal

First Steps in V‑Portal

This section guides you through logging in to V‑Portal for the first time and familiarising yourself with the core interface.

Login and First-time Access

Learn how to log in to V-Portal and complete your first-time setup.

Default Credentials

On a fresh installation, use these default credentials:

  • Username: admin
  • Password: Hashedpass123!
Warning

Change the default password immediately after first login for security.

Logging In

  1. Navigate to your V-Portal URL (e.g., http://{your-device-IP})
  2. Enter your username and password
  3. Click “Login”

If the login is successful, you will be redirected to the V‑Portal home screen.

First-time Setup Wizard

On your first login, V‑Portal will guide you through a short setup process:

  1. Change Password: Set a secure password for your account.
  2. Profile Setup: Configure basic user profile details.
  3. System Configuration: Review and apply essential system settings.

Authentication Overview

V-Portal uses JWT (JSON Web Token) based authentication with:

  • Access tokens for short‑lived sessions
  • Refresh tokens for extended access
  • Automatic token renewal during active sessions

Once logged in, proceed to Initial Setup to configure your V-Portal instance.

Basic Navigation

Learn how to navigate the V-Portal interface effectively.

The top navigation bar provides access to:

  • Pages: View and manage HMI pages
  • Modules: Installed modules and their interfaces
  • Settings: System configuration and user management
  • User Menu: Profile, logout, and preferences

The sidebar (when available) shows:

  • Page hierarchy
  • Module-specific navigation
  • Quick access to common features

Page Layout

V-Portal uses a grid-based layout system:

  • Drag and drop widgets
  • Resize components
  • Responsive design

Keyboard Shortcuts

Common shortcuts:

  • Ctrl/Cmd + S: Save current page
  • Ctrl/Cmd + K: Open command palette (if enabled)
  • Esc: Close dialogs/modals

Use the search feature to:

  • Find pages quickly
  • Search documentation
  • Locate settings

Dark Mode

Toggle between light and dark themes:

  • Click the theme toggle in the navbar
  • Preference is saved per user

Next Steps

Now that you know the basics:

Last updated on
Setup V-PortalOverview