Getting Started

Welcome to StacksAtlas. This guide will walk you through the initial setup and your first network scan.

1. Initial Launch

If you left the "Launch StacksAtlas" checkbox selected during installation, your browser should already be open.

• Otherwise, navigate to https://localhost:5001 (Secure) or http://localhost:5000 (Standard).
• Note: If you see an SSL warning on port 5001, please proceed as described in the Installation Guide.

2. Create Administrator

On the first run, the system requires a primary administrator account.

1. Email: Enter a valid email address.
2. Password: Choose a strong password. StacksAtlas uses PBKDF2 hashing for enterprise-grade security.
   • Important: There is currently no password recovery mechanism. Please store your credentials securely.
3. Click Create Account.

3. Activate License

You need to activate your instance to enable discovery features.

1. Navigate to Settings in the left navigation menu.
2. Scroll to the Licensing & Governance section toward the bottom of the page.
3. Enter Key: Paste the license key received in your email.
4. Verify: The system will perform a one-time validation and lock the license to this machine's Hardware ID (HWID).

Managing Your License (Self-Service)

Our licensing model is simple: one license per active installation (node). You own the perpetual license for the version you purchase. If you need to move your license to a new machine (e.g., hardware failure or upgrade), you can do this entirely self-service:

1. Access Portal: Go to your original Order Email from Lemon Squeezy and click "View Order".
2. Navigate to Licenses: Click on the Licenses item in your order.
3. Deactivate: Find the active activation and click Deactivate.
4. Re-activate: You can now enter your key on the new machine with a fresh Hardware ID (HWID).

This ensures you are never locked out of your software.

4. Define Network Scope

On its first run, StacksAtlas attempts to automatically detect your local subnet (e.g., 192.168.1.0/24) and begins scanning immediately.

4.1 Select Network Adapter

If you have multiple network interfaces (e.g., Ethernet and Wi-Fi), you must ensure the correct one is selected.

1. Look at the Global Header at the top of the utility.
2. Click the Network Toggle (showing your current IP and CIDR).
3. Select the physical adapter connected to the target network.
4. The system will reflect the new active range instantly.

4.2 Add Additional Subnets

To monitor VLANs or remote subnets that are not on the local interface:

1. Navigate to Settings > Scan Scopes.
2. Click the Add Scope button.
3. Subnet: Enter the CIDR range for any additional VLANs you wish to monitor (e.g., 10.0.50.0/24).
4. Click Save.

The Discovery Engine runs continuously in the background.

5. Dashboard Overview

Navigate back to the Dashboard. You will see devices populate in real-time.

Key Indicators

• Status Ring: The colored ring around the device icon indicates Stability.
  • Green: 100% Stable
  • Orange: <90% (Warning)
  • Red: <50% (Critical)
• Vendor Icon: Automatically assigned based on the MAC OUI database.
• Names: Populated via mDNS/Bonjour if available.

Device Management

Click any row to open the Service Drawer.

• Custom Name: Override the discovered name (e.g., "Lobby Display").
• Location: Assign a physical location.
• Responsible Party: Assign a user to manage this device.
• Diagnostic Tools: Access Path Diagnostics to map network hops or Deep Scan for security analysis.
• Remote Power: Use Wake-on-LAN to boot offline machines directly from the drawer.

Your changes are protected by the Human Property Shield and will never be overwritten by future scans.