Getting Started

Learn how to add and manage your network devices in xInfra.

Welcome to xInfra, the ultimate toolkit for modern network engineering. This guide will help you set up your first device and start monitoring your infrastructure.

Adding a Device

To add a new device to your inventory, tap the + button in the top right corner of the main screen. This opens the Add Device modal where you can configure all connection details.

1. Device Information

Start by providing the basic identification for your device:

  • Device Name: A friendly name to identify the device (e.g., Core-Router-NYC).
  • Host/IP Address: The hostname or IP address of the device (e.g., 192.168.1.1 or router.corp.net).
  • Device Type: Select the icon that best represents your device (Router, Switch, Firewall, Server, etc.).
  • Tags: Add custom tags for organization and filtering.

2. Management Protocols

Select the protocols you want to use to manage this device. You can enable multiple protocols simultaneously.

  • SSH: For secure command-line access.
  • SNMP: For monitoring metrics and system status.
  • Telnet: For legacy remote access (use SSH whenever possible).

3. Access Credentials

Configure the credentials for each enabled protocol.

SSH Configuration

If SSH is enabled, configure the following:

  • Username: The user to log in as (default: root).
  • Port: The SSH port (default: 22).
  • Password: The user's password.
  • Private Key (Optional): Paste your OpenSSH private key for key-based authentication.

SNMP Configuration

xInfra supports SNMP v1, v2c, and v3.

v1 / v2c:

  • Community String: The community string for read access (default: public).
  • Port: UDP port (default: 161).

v3 (Secure): For SNMPv3, you need to configure security parameters:

  • Username: The SNMPv3 security name.
  • Security Level:
    • No Auth, No Priv: No authentication or encryption.
    • Auth, No Priv: Authentication only.
    • Auth, Priv: Both authentication and encryption.
  • Auth Protocol: MD5 or SHA (if Auth enabled).
  • Auth Key: The authentication password.
  • Priv Protocol: DES or AES (if Priv enabled).
  • Priv Key: The privacy (encryption) password.

Telnet Configuration

  • Port: Telnet port (default: 23).

4. Network & Proxy (Pro Features)

Advanced network configurations are available for Pro users.

  • Jump Host: Route your connection through another device in your inventory. This is useful for accessing devices behind a bastion host.
  • SOCKS5 Proxy: Tunnel your connection through a SOCKS5 proxy server. You will need to provide the proxy host, port, and optional credentials.

Editing a Device

To edit an existing device, simply long press its card in the main list. You can update any of the configuration parameters mentioned above.

Deleting a Device

To remove a device, open the edit modal and scroll to the bottom (or look for the delete option). Confirm the action to permanently remove the device and its local data.