Atra VPN Desktop Application

• Installation
• Signing In to the Atra VPN App
• Getting Started with the Atra VPN App
• Key Features of the Atra VPN App
• Troubleshooting Common Atra VPN App Issues
• Atra VPN Desktop App FAQs

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.

---

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

---

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"

---

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

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

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

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

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.

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

---

Connecting to a Tunnel

[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.

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:

---

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

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:

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

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

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

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 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.

---