# Atra VPN Desktop Application The Atra VPN Client is a secure desktop application that provides users with a fast and reliable way to connect to their organization’s VPN. Unlike apps that only act as a front-end, Atra VPN Client integrates directly with the OpenVPN.exe binaries and drivers, ensuring enterprise-grade security and stability. With just a few clicks, users can: - Launch the app and start a VPN tunnel securely. - Quickly connect to pre-configured VPN servers or tunnels. - Monitor session details such as IP address, connection duration, and status in real time. Configuration and management of VPN tunnels (creating, editing, or deleting) are handled by administrators, while end-users can easily connect to available VPN sessions through the app without extra setup. This approach gives the best of both worlds: - Simplicity for users (one-click connect experience). - Visibility into connected devices and session logs. Key Features - One-Click Connect: Simple interface for quick tunnel connection - Real-Time Monitoring: View connection status, IP address, duration - Auto-Update: Automatic notification and installation of updates - Theme Support: Light and dark mode options - Session Management: Remember credentials, auto-login # Installation #### System Requirements Supported Operating Systems: - Windows 10 (64-bit) - Build 1809 or later - Windows 11 (64-bit) Hardware Requirements: - Processor: Dual-core 2.0 GHz or faster - RAM: 4 GB minimum - Disk Space: 200 MB - Administrator privileges for installation ⚠️ Important: App is currently in BETA. Minor bugs may be encountered. Report issues to support. --- #### Download Process **Step 1: Access Download** 1. Log in to Atra RMS (web interface) 2. Navigate to VPN section 3. Locate Download button (top-left corner) 4. Click Download button --- **Step 2: Locate Installer** 1. Installer downloads to your default Downloads folder 2. Filename: AtraVPNClientSetup.exe 3. Locate file in Downloads folder --- **Step 3:** **Run Installer** 1. Double-click AtraVPNClientSetup.exe 2. Windows SmartScreen warning may appear. [![image.png](https://docs.atreyo.in/uploads/images/gallery/2026-04/scaled-1680-/siwimage.png)](https://docs.atreyo.in/uploads/images/gallery/2026-04/siwimage.png) --- #### Windows SmartScreen Warning **Why This Appears:** - Standard Windows security check - Appears for BETA apps not yet widely distributed - Does NOT indicate malicious software - Atra VPN Client is developed and signed by Atreyo,you can safely proceed. **How to Proceed Safely:** 1. SmartScreen window appears: "Windows protected your PC" 2. Click "More info" link 3. "Run anyway" button appears 4. Click "Run anyway" 5. Installation proceeds [![image.png](https://docs.atreyo.in/uploads/images/gallery/2026-04/scaled-1680-/tDAimage.png)](https://docs.atreyo.in/uploads/images/gallery/2026-04/tDAimage.png) --- **Step 4: Administrator Permission** Windows User Account Control (UAC) prompt appears. 1. Message: "Do you want to allow this app to make changes?" 2. Click "Yes" to grant administrator privileges 3. Installation wizard opens Why Administrator Rights Needed: - Install OpenVPN drivers - Create system network interfaces - Modify network routing tables - Write to Program Files directory --- **Step 5: Installation Wizard** Follow on-screen installation steps: 1. Welcome Screen: Click "Next" 2. License Agreement: Read and click "I Agree" 3. Installation Location: Use default or choose custom (click "Next") 4. Install: Click "Install" button 5. Progress Bar: Wait for installation (typically 1-2 minutes) 6. Completion: Click "Finish" [![image.png](https://docs.atreyo.in/uploads/images/gallery/2026-04/scaled-1680-/VPfimage.png)](https://docs.atreyo.in/uploads/images/gallery/2026-04/VPfimage.png) --- **Step 6: Launch Application** After installation completes: 1. Atra VPN Client automatically launches 2. Login page displays 3. Ready for authentication Desktop Shortcut: Installer creates desktop icon for future launches. # Signing In to the Atra VPN App [![image.png](https://docs.atreyo.in/uploads/images/gallery/2026-04/scaled-1680-/WHgimage.png)](https://docs.atreyo.in/uploads/images/gallery/2026-04/WHgimage.png) #### First-Time Login **Step 1: Enter Credentials** Use the same credentials as Atra RMS web platform. **Email Field:** - Enter your registered email address - Example: user@company.com **Password Field:** - Enter your Atra RMS password --- **Step 2: Click Login** 1. Click **"LOGIN"** button 2. Application validates credentials with Atra RMS server 3. If valid: Redirects to main dashboard 4. If invalid: Error message displays --- #### Authentication Success Upon successful login: - Main dashboard displays - VPN tunnels list loads - Associated organization shown - Profile avatar appears (top-right) # Getting Started with the Atra VPN App #### Application Dashboard Overview [![image.png](https://docs.atreyo.in/uploads/images/gallery/2026-04/scaled-1680-/SYpimage.png)](https://docs.atreyo.in/uploads/images/gallery/2026-04/SYpimage.png) The main dashboard has three sections: **Top Bar:** 1. **App Version:** Current version number (e.g., v1.2.3) 2. **Organization Name:** Your associated organization 3. **Theme Toggle:** Switch between light/dark mode 4. **Profile Avatar:** Access account menu **Middle Section:** 1. **Search Bar:** Filter tunnels by name/organization 2. **Refresh Icon:** Manually update tunnel list 3. **Table Navigation:** Rows per page, page controls **Main Area:** 1. **VPN Tunnels Table:** List of available tunnels --- #### Top Bar Elements [![image.png](https://docs.atreyo.in/uploads/images/gallery/2026-04/scaled-1680-/s3dimage.png)](https://docs.atreyo.in/uploads/images/gallery/2026-04/s3dimage.png) ##### **1. App Version** Display: Top-left corner Format: "Atra VPN Client v1.2.3" Purpose: Shows current installed version When to Check: - Troubleshooting issues - Verifying you have latest version - Reporting bugs to support --- ##### **2. Associated Organization** Display: Below app version Format: "Organization: \[Your Org Name\]" Purpose: Confirms which organization's tunnels you see What This Means: - You see tunnels created in your organization - You see tunnels your organization has access to - Cannot see tunnels from unrelated organizations --- ##### **3. Theme Toggle** Location: Top-right area Options: Light Mode | Dark Mode How to Use: 1. Click theme toggle switch 2. Interface immediately switches themes 3. Preference saved automatically 4. Applied on next launch Benefits: - Light Mode: Better for bright environments - Dark Mode: Reduces eye strain in low-light conditions --- ##### **4. Profile Avatar** [![image.png](https://docs.atreyo.in/uploads/images/gallery/2026-04/scaled-1680-/yJrimage.png)](https://docs.atreyo.in/uploads/images/gallery/2026-04/yJrimage.png) Location: Top-right corner Icon: Circle with user initials or icon **Click to Open Menu:** - Email Address (display only) - Organization Name (display only) - Logout option (click to sign out) --- ### VPN Tunnels Table The main table displays all VPN tunnels you have access to. [![image.png](https://docs.atreyo.in/uploads/images/gallery/2026-04/scaled-1680-/21Limage.png)](https://docs.atreyo.in/uploads/images/gallery/2026-04/21Limage.png) #### Table Search & Refresh **Search Bar:** - Type keywords to filter tunnels - Searches: Tunnel name, organization, created by - Real-time filtering (results update as you type) **Refresh Icon:** - Click to manually update tunnel list - Useful after tunnels are created/deleted in web interface **Table Navigation:** - Rows per page: 10, 25, 50, 100 - Total Count: "Showing 1-10 of 25 tunnels" - Page Navigation: Previous, Next, page numbers --- #### Table Columns
Column Description Values
Connect Button Connect/disconnect from tunnel "Connect" or "Disconnect"
Details Opens sidebar with device info Button with icon
Process Status VPN server process state Running, Exited
Tunnel Status Management state Enabled, Disabled
Organization Name Tunnel's organization ATREYO DEMO
Organization Level Hierarchy level Level: 1, 2, 3
VPN IPv4 Tunnel gateway IP 10.8.0.1
Created By Creator's email test@atreyo.in
Created On Creation date 2025-09-15
Total Users Users in tunnel 10
Total Devices Devices in tunnel 5
Max Clients Maximum capacity 253
Allocated Clients Current users + devices 15
Remaining Clients Available slots 238
--- ### Connecting to a Tunnel [![image.png](https://docs.atreyo.in/uploads/images/gallery/2026-04/scaled-1680-/ikpimage.png)](https://docs.atreyo.in/uploads/images/gallery/2026-04/ikpimage.png) \[INSERT SCREENSHOT: Connect\_Process.png\] #### Before Connecting Prerequisites: ✅ Tunnel Process Status = "Running" ✅ Tunnel Status = "Enabled" ✅ You are added to tunnel (by administrator) ✅ No other tunnel currently connected ⚠️ One Tunnel at a Time: You can only connect to ONE tunnel at a time. --- #### Connection Steps Step 1: Locate Tunnel 1. Find tunnel in table 2. Verify Process Status = "Running" 3. Verify Tunnel Status = "Enabled" --- Step 2: Click Connect 1. Click "Connect" button for desired tunnel 2. Application initiates VPN connection 3. OpenVPN process starts in background 4. Connection established (typically 5-15 seconds) Visual Feedback: - Button shows "Connecting..." briefly - Progress indicator may appear - Button changes to "Disconnect" when connected --- Step 3: Connected State Once connected, three status cards appear at top of application: Card 1: Connected Tunnel - Shows tunnel name you're connected to - Example: "Connected to: Factory\_Production\_VPN" Card 2: Connection Details - Your VPN IP address - Example: "Your VPN IP: 10.8.0.25" - Gateway IP - Connection speed/status Card 3: Session Duration - Time connected - Example: "Connected for: 00:45:23" - Updates in real-time --- #### While Connected What You Can Do: - ✅ Access devices in tunnel via their VPN IPs - ✅ Access devices' local networks (if Network Forwarding enabled) - ✅ View connection details in status cards - ✅ Monitor session duration - ✅ Click "Details" to view device information What You Cannot Do: - ❌ Connect to other tunnels (must disconnect first) - ❌ Close application (minimizes to system tray, stays connected) Other Tunnels: - While connected, other "Connect" buttons are disabled (grayed out) --- ### Disconnecting from Tunnel #### Manual Disconnect Step 1: Click Disconnect 1. Locate "Disconnect" button on active tunnel row 2. Click "Disconnect" button 3. VPN session cleanly closes 4. OpenVPN process terminates --- Step 2: Disconnected State After disconnection: - Status cards disappear from top - Button changes back to "Connect" - Other tunnels become available (buttons enabled) - Can connect to different tunnel Effects: - Cannot access tunnel devices anymore - Local network access lost - VPN IP deallocated until next connection --- #### Automatic Disconnect Scenarios Where App Auto-Disconnects: 1\. Internet Connection Lost: - VPN requires active internet - If internet drops, VPN disconnects automatically - Notification appears: "Connection lost" - Attempt to reconnect when internet restores 2\. Tunnel Stopped by Administrator: - Administrator stops tunnel process - All connections terminate - Notification: "Tunnel stopped by administrator" 3\. Tunnel Disabled by Administrator: - Administrator disables tunnel - Process stops, all connections drop - Notification: "Tunnel disabled" 4\. User Removed from Tunnel: - Administrator removes you from tunnel - Connection immediately terminates - Notification: "Access revoked" --- ### Device Details Sidebar Click "Details" button to view devices in the tunnel. [![image.png](https://docs.atreyo.in/uploads/images/gallery/2026-04/scaled-1680-/gtXimage.png)](https://docs.atreyo.in/uploads/images/gallery/2026-04/gtXimage.png) #### Opening Details Sidebar 1. Locate tunnel in table 2. Click "Details" button (typically icon button) 3. Sidebar slides in from right side --- #### Sidebar Contents Header: - Tunnel name - Close button (X) to dismiss sidebar Device List: For each device, displays:
Field Description Example
Device Model Hardware model name AG-702-LT-EU-V48
Local IP Device's LAN/WAN IP 192.168.1.50
VPN IP Device's tunnel IP 10.8.0.10
Network Forwarding Forwarding state Enabled or Disabled
Connection Status Device online/offline Connected, Disconnected
Routing IP Available network routes 192.168.1.0
--- #### Understanding Routing IP **What is Routing IP?** - Lists network ranges accessible through this device - Only shown when Network Forwarding = Enabled - CIDR notation (e.g., 192.168.1.0) **Example:** Device VPN IP: 10.8.0.10 Network Forwarding: Enabled Routing IP: 192.168.1.0 **What This Means:** - You can access device at 10.8.0.10 - You can also access any device on 192.168.1.x network (192.168.1.1 through 192.168.1.254) - Traffic routes through 10.8.0.10 to reach local network **Use Case:** Your Computer (VPN: 10.8.0.25) ↓ Connect to: 192.168.1.100 (PLC on device's LAN) ↓ Routes through: 10.8.0.10 (gateway device) ↓ Reaches: PLC at 192.168.1.100 --- # Key Features of the Atra VPN App #### Auto-Updater [![image.png](https://docs.atreyo.in/uploads/images/gallery/2026-04/scaled-1680-/paNimage.png)](https://docs.atreyo.in/uploads/images/gallery/2026-04/paNimage.png) The app automatically checks for updates on launch. Update Available: 1. Dialog appears: "Update Available" 2. Message shows for available version. 3. Options: - Download Now: Download update immediately - Skip: Skip for now, check again next launch --- Download Process: [![image.png](https://docs.atreyo.in/uploads/images/gallery/2026-04/scaled-1680-/6Jqimage.png)](https://docs.atreyo.in/uploads/images/gallery/2026-04/6Jqimage.png) 1. Click "Download Now" 2. Progress bar shows download status 3. When complete: "Restart to Update" button appears 4. Click "Restart to Update" 5. App closes and reopens with new version --- Already Up to Date: If you have the latest version: - Message appears: "You have the latest version" - No action needed - Dialog closes automatically 💡 Best Practice: Always keep app updated for latest features, security patches, and bug fixes. --- #### Theme Toggle [![image.png](https://docs.atreyo.in/uploads/images/gallery/2026-04/scaled-1680-/Z2Dimage.png)](https://docs.atreyo.in/uploads/images/gallery/2026-04/Z2Dimage.png) Switching Themes: 1. Locate theme toggle (top-right area) 2. Click toggle switch 3. Interface switches immediately: - Light Mode: White background, dark text - Dark Mode: Dark background, light text Persistence: - Your choice is saved automatically - Next time you launch app, your preferred theme applies - No need to reselect each time Benefits: - Light Mode: Easier reading in bright rooms, office environments - Dark Mode: Reduces eye strain in low light, saves battery (OLED screens) --- # Troubleshooting Common Atra VPN App Issues #### Installation Issues Problem 1: Windows Protection Screen Symptom: Blue screen: "Windows protected your PC" Solution: 1. Click "More info" link 2. Click "Run anyway" button 3. Click "Yes" on UAC prompt (grant administrator permission) Why: Standard Windows security for BETA apps. Safe to proceed. --- Problem 2: App Not Launching After Install Symptoms: - Double-click desktop icon, nothing happens - No application window appears - No error message Solutions: Check Task Manager: 1. Press Ctrl+Shift+Esc (open Task Manager) 2. Look for "AtraVPNClient.exe" in Processes tab 3. If found, right-click → End Task 4. Try launching again Run as Administrator: 1. Right-click desktop icon 2. Select "Run as administrator" 3. Click "Yes" on UAC prompt Reinstall: 1. Uninstall via Control Panel → Programs and Features 2. Delete remaining files from C:\\Program Files\\Atra VPN Client 3. Download fresh installer from Atra RMS 4. Reinstall following steps above --- #### Login Issues Problem 3: Invalid Credentials Error Symptom: "Invalid email or password" message Solutions: Verify Credentials: 1. Confirm email is correct (check for typos) 2. Verify password is correct 3. Check Caps Lock is OFF 4. Try copying/pasting password from secure location Reset Password: 1. Go to Atra RMS web platform 2. Use "Forgot Password?" link 3. Reset password 4. Use new password in VPN client Check Account Status: 1. Verify account setup was completed 2. Confirm account hasn't been disabled 3. Contact administrator if needed --- Problem 4: Auto-Login Not Working Symptom: App asks for login every time despite successful previous login Solutions: Manual Logout Clears Auto-Login: - If you clicked Logout last time, auto-login disabled - Simply log in once to re-enable Clear and Re-Login: 1. Log out if currently logged in 2. Close application completely 3. Reopen application 4. Log in manually 5. Auto-login should work on next launch --- #### VPN Connection Issues Problem 5: Cannot Connect to Tunnel [![image.png](https://docs.atreyo.in/uploads/images/gallery/2026-04/scaled-1680-/Ah8image.png)](https://docs.atreyo.in/uploads/images/gallery/2026-04/Ah8image.png) Symptom: Click "Connect" but connection fails Solutions: Verify Tunnel State: 1. Check Process Status = "Running" (not "Exited") 2. Check Tunnel Status = "Enabled" (not "Disabled") 3. If Exited: Contact administrator to start tunnel 4. If Disabled: Contact administrator to enable tunnel Check Current Connection: 1. Verify you're not already connected to another tunnel 2. If connected elsewhere, disconnect first 3. Then try connecting to desired tunnel Check Internet Connection: 1. Verify your computer has active internet 2. Try opening website in browser 3. Check Wi-Fi/Ethernet connection 4. Restart router if necessary Contact Administrator: 1. Verify you're added to the tunnel 2. Confirm you haven't been removed 3. Check tunnel hasn't been deleted --- Problem 6: Connection Drops Frequently [![image.png](https://docs.atreyo.in/uploads/images/gallery/2026-04/scaled-1680-/UHUimage.png)](https://docs.atreyo.in/uploads/images/gallery/2026-04/UHUimage.png) Symptom: Connection established but drops after few minutes Solutions: Check Internet Stability: 1. Test internet connection quality 2. Run speed test (speedtest.net) 3. Check for packet loss (ping test) 4. Switch to wired connection if using Wi-Fi Check Firewall/Antivirus: 1. Temporarily disable firewall 2. Test VPN connection 3. If works, add VPN client to firewall whitelist 4. Re-enable firewall Router Configuration: 1. Ensure UDP port 1194 is open (OpenVPN default) 2. Check router isn't blocking VPN traffic 3. Update router firmware if outdated Network Congestion: 1. Close bandwidth-heavy applications 2. Pause downloads/uploads 3. Disconnect other devices from network temporarily 4. Test connection during low-usage period --- Problem 7: Device Not Showing in Sidebar Symptom: Open Details sidebar but expected device missing Solutions: Verify Device Added: 1. Check Atra RMS web interface 2. Navigate to tunnel Overview page 3. Check Devices tab 4. Confirm device is in the list 5. If missing, administrator must add it Refresh Application: 1. Click Refresh icon (top of VPN client) 2. Wait for data to update 3. Check Details sidebar again --- #### General Issues Problem 8: App Stuck or Frozen Symptom: Application unresponsive, cannot click anything Solutions: Force Close: 1. Press Ctrl+Alt+Delete 2. Select Task Manager 3. Find "AtraVPNClient.exe" 4. Right-click → End Task 5. Relaunch application System Restart: 1. Close all applications 2. Restart computer 3. Launch VPN client after restart --- **Problem 9: Still Not Resolved** Contact Atreyo Support: Email: support@atreyo.io Information to Include: 1. Your name and email 2. Organization name 3. App version number (from top-left of dashboard) 4. Operating System (Windows 10/11, build number) 5. Detailed description of issue 6. Steps to reproduce the problem 7. Screenshots of error messages 8. Log files (if accessible) --- # Atra VPN Desktop App FAQs Q: Where can I download the Atra VPN Client? A: Log in to Atra RMS web interface → VPN section → Download button (top-right corner). Currently available for Windows 10/11 only. --- Q: Is the Atra VPN Client available for macOS or Linux? A: Not currently. The app is only available for Windows 10/11 (64-bit). macOS and Linux versions are under development. --- Q: Why do I see a Windows protection warning during installation? A: This is a standard Windows SmartScreen security check for BETA applications. The Atra VPN Client is developed and signed by Atreyo and is safe. Click "More info" → "Run anyway" to proceed with installation. --- Q: Do I need different login credentials for the VPN Client? A: No. Use the same email and password as your Atra RMS web platform account. --- Q: Can I connect to multiple VPN tunnels at once? A: No. You can only connect to ONE tunnel at a time. All other tunnels will be disabled while one is active. Disconnect first to switch tunnels. --- Q: Can the app work without the internet? A: No. The Atra VPN Client requires an active internet connection to authenticate your account and establish VPN tunnels. --- Q: What should I do if the app is not working properly? A: First, try restarting the app. If the problem persists, refer to the[ Troubleshooting](https://claude.ai/chat/2eb2c36b-734f-4aa3-bb1b-abe183b2e041#troubleshooting) section above. For unresolved issues, contact Atreyo Support with details and log files. --- Q: Can I run multiple instances of the Atra VPN Client? A: No. The app only allows one instance to run at a time. If the app is already open, you cannot launch another window. --- Q: What happens if I lose the internet while connected to VPN? A: The app will automatically disconnect for security. When the internet is restored, you'll need to manually reconnect to the tunnel. --- Q: How do I access devices through the VPN? A: Once connected, use the device's VPN IP address (shown in Details sidebar) to access it. If Network Forwarding is enabled, you can also access devices on the device's local network using their local IP addresses. ---