netrisai · akhomyakov · Feb 13, 2026 · Feb 12, 2026 · Feb 13, 2026 · Feb 13, 2026
diff --git a/tutorials/images/acs-dnat-creation.png → cloudstack/images/acs-dnat-creation.png b/tutorials/images/acs-dnat-creation.png → cloudstack/images/acs-dnat-creation.png
diff --git a/...rials/images/acs-enable-netris-plugin.png → ...stack/images/acs-enable-netris-plugin.png b/...rials/images/acs-enable-netris-plugin.png → ...stack/images/acs-enable-netris-plugin.png
diff --git a/tutorials/images/acs-infra-diagram.png → cloudstack/images/acs-infra-diagram.png b/tutorials/images/acs-infra-diagram.png → cloudstack/images/acs-infra-diagram.png
diff --git a/tutorials/images/acs-inventory-profile.png → cloudstack/images/acs-inventory-profile.png b/tutorials/images/acs-inventory-profile.png → cloudstack/images/acs-inventory-profile.png
diff --git a/tutorials/images/acs-link-creation.png → cloudstack/images/acs-link-creation.png b/tutorials/images/acs-link-creation.png → cloudstack/images/acs-link-creation.png
diff --git a/tutorials/images/acs-lo-subnet.png → cloudstack/images/acs-lo-subnet.png b/tutorials/images/acs-lo-subnet.png → cloudstack/images/acs-lo-subnet.png
diff --git a/tutorials/images/acs-mgmt-subnet.png → cloudstack/images/acs-mgmt-subnet.png b/tutorials/images/acs-mgmt-subnet.png → cloudstack/images/acs-mgmt-subnet.png
diff --git a/tutorials/images/acs-mng-cloudbr0-vnet.png → cloudstack/images/acs-mng-cloudbr0-vnet.png b/tutorials/images/acs-mng-cloudbr0-vnet.png → cloudstack/images/acs-mng-cloudbr0-vnet.png
diff --git a/tutorials/images/acs-mng-hyper-subnet.png → cloudstack/images/acs-mng-hyper-subnet.png b/tutorials/images/acs-mng-hyper-subnet.png → cloudstack/images/acs-mng-hyper-subnet.png
diff --git a/tutorials/images/acs-mng-mgmt-vnet.png → cloudstack/images/acs-mng-mgmt-vnet.png b/tutorials/images/acs-mng-mgmt-vnet.png → cloudstack/images/acs-mng-mgmt-vnet.png
diff --git a/tutorials/images/acs-private-allocation.png → cloudstack/images/acs-private-allocation.png b/tutorials/images/acs-private-allocation.png → cloudstack/images/acs-private-allocation.png
diff --git a/tutorials/images/acs-public-allocation.png → cloudstack/images/acs-public-allocation.png b/tutorials/images/acs-public-allocation.png → cloudstack/images/acs-public-allocation.png
diff --git a/tutorials/images/acs-public-nat-subnet.png → cloudstack/images/acs-public-nat-subnet.png b/tutorials/images/acs-public-nat-subnet.png → cloudstack/images/acs-public-nat-subnet.png
diff --git a/tutorials/images/acs-server2-creation.png → cloudstack/images/acs-server2-creation.png b/tutorials/images/acs-server2-creation.png → cloudstack/images/acs-server2-creation.png
diff --git a/tutorials/images/acs-server2-link-edit.png → cloudstack/images/acs-server2-link-edit.png b/tutorials/images/acs-server2-link-edit.png → cloudstack/images/acs-server2-link-edit.png
diff --git a/tutorials/images/acs-server2-one-liner.png → cloudstack/images/acs-server2-one-liner.png b/tutorials/images/acs-server2-one-liner.png → cloudstack/images/acs-server2-one-liner.png
diff --git a/tutorials/images/acs-snat-creation.png → cloudstack/images/acs-snat-creation.png b/tutorials/images/acs-snat-creation.png → cloudstack/images/acs-snat-creation.png
diff --git a/tutorials/images/acs-system-vms-subnet.png → cloudstack/images/acs-system-vms-subnet.png b/tutorials/images/acs-system-vms-subnet.png → cloudstack/images/acs-system-vms-subnet.png
diff --git a/tutorials/images/acs-system-vms-vnet.png → cloudstack/images/acs-system-vms-vnet.png b/tutorials/images/acs-system-vms-vnet.png → cloudstack/images/acs-system-vms-vnet.png
diff --git a/tutorials/images/acs-topology-link-edit.png → cloudstack/images/acs-topology-link-edit.png b/tutorials/images/acs-topology-link-edit.png → cloudstack/images/acs-topology-link-edit.png
diff --git a/tutorials/images/acs-wizard-launch-zone.png → cloudstack/images/acs-wizard-launch-zone.png b/tutorials/images/acs-wizard-launch-zone.png → cloudstack/images/acs-wizard-launch-zone.png
diff --git a/...ials/images/acs-wizard-netris-details.png → ...tack/images/acs-wizard-netris-details.png b/...ials/images/acs-wizard-netris-details.png → ...tack/images/acs-wizard-netris-details.png
diff --git a/...ls/images/acs-wizard-physical-network.png → ...ck/images/acs-wizard-physical-network.png b/...ls/images/acs-wizard-physical-network.png → ...ck/images/acs-wizard-physical-network.png
diff --git a/tutorials/images/acs-wizard-pod1-details.png → ...dstack/images/acs-wizard-pod1-details.png b/tutorials/images/acs-wizard-pod1-details.png → ...dstack/images/acs-wizard-pod1-details.png
diff --git a/.../images/acs-wizard-public-netris-pool.png → .../images/acs-wizard-public-netris-pool.png b/.../images/acs-wizard-public-netris-pool.png → .../images/acs-wizard-public-netris-pool.png
diff --git a/...als/images/acs-wizard-public-network1.png → ...ack/images/acs-wizard-public-network1.png b/...als/images/acs-wizard-public-network1.png → ...ack/images/acs-wizard-public-network1.png
diff --git a/...als/images/acs-wizard-public-network2.png → ...ack/images/acs-wizard-public-network2.png b/...als/images/acs-wizard-public-network2.png → ...ack/images/acs-wizard-public-network2.png
diff --git a/tutorials/images/acs-wizard-vxlan-range.png → cloudstack/images/acs-wizard-vxlan-range.png b/tutorials/images/acs-wizard-vxlan-range.png → cloudstack/images/acs-wizard-vxlan-range.png
diff --git a/tutorials/images/acs-wizard-zone-details.png → ...dstack/images/acs-wizard-zone-details.png b/tutorials/images/acs-wizard-zone-details.png → ...dstack/images/acs-wizard-zone-details.png
diff --git a/tutorials/netris-cloudstack.rst → cloudstack/netris-cloudstack.rst b/tutorials/netris-cloudstack.rst → cloudstack/netris-cloudstack.rst
diff --git a/tutorials/netris-cloudstack_p1.rst → cloudstack/netris-cloudstack_p1.rst b/tutorials/netris-cloudstack_p1.rst → cloudstack/netris-cloudstack_p1.rst
diff --git a/tutorials/netris-cloudstack_p2.rst → cloudstack/netris-cloudstack_p2.rst b/tutorials/netris-cloudstack_p2.rst → cloudstack/netris-cloudstack_p2.rst
@@ -4,9 +4,7 @@
 Prerequisites
 =============
 
-`Switch fabric up & running <https://www.netris.io/docs/en/latest/tutorials/vpc-gateways-with-managed-fabric.html>`_
-
-`ISP upstreams connected through BGP <https://www.netris.io/docs/en/latest/tutorials/connecting-fabric-to-isp.html>`_
+:doc:`Switch fabric up & running </vpc-gateways-with-managed-fabric>` and :ref:`connected to ISP <bgp_def>`
 
 Step-by-Step Configuration Instructions for the Netris Controller
 -----------------------------------------------------------------

diff --git a/tutorials/netris-cloudstack_p3.rst → cloudstack/netris-cloudstack_p3.rst b/tutorials/netris-cloudstack_p3.rst → cloudstack/netris-cloudstack_p3.rst
diff --git a/tutorials/netris-cloudstack_p4.rst → cloudstack/netris-cloudstack_p4.rst b/tutorials/netris-cloudstack_p4.rst → cloudstack/netris-cloudstack_p4.rst
diff --git a/tutorials/netris-cloudstack_p5.rst → cloudstack/netris-cloudstack_p5.rst b/tutorials/netris-cloudstack_p5.rst → cloudstack/netris-cloudstack_p5.rst
diff --git a/definitions.rst b/definitions.rst
@@ -9,20 +9,35 @@ When configuring and operating a Netris system, the following nomenclature is im
 
 * **User** - A user account for accessing Netris Controller through GUI, RestAPI, and Kubernetes. The default username is ``netris``, with password ``newNet0ps``. 
 
-* **The Netris VPC** - logically segregated virtual network.The VPC acts as a VRF in traditional networking, providing the flexibility to employ overlapping IP ranges across various VPCs while maintaining secure management and operation of resources.
+* **Netris VPC** - logically segregated virtual network.The VPC acts as a VRF in traditional networking, providing the flexibility to employ overlapping IP ranges across various VPCs while maintaining secure management and operation of resources.
+
+* **V-Net (Virtual Network)** is a Netris construct for grouping switch ports into a defined network segment—much like a traditional VLAN or a public cloud subnet. It is a virtual networking service that provides Layer-2 (unrouted) or Layer-3 (routed) virtual network segments in a Netris VPC. V-Net is assigned to one VPC and one or multiple sites. Your endpoints (servers, VMs) are connected to V-Nets.
+
+    * **L2VPN (Layer 2 Virtual Private Network)** is a V-Net type and is similar to a traditional VLAN with modern and scalable implementation.
+    * **L3VPN** is a V–Net type and is typically used for back-end (east–west) connectivity in GPU clusters on Ethernet-based AI fabrics such as NVIDIA Spectrum-X. Built as one mini-subnet per switch port, a VXLAN L3VPN is conceptually similar to MPLS L3VPN in provider networks.
 
 * **Tenant** - IP addresses and Switch Ports are network resources assigned to different Tenants to have under their management. Admin is the default tenant, and by default, it owns all the resources. You can use different Tenants for sharing and delegation of control over the network resources. Network teams typically use Tenants to grant access to other groups to request and manage network services using the Netris Controller as a self-service portal or programmatically (with Kubernetes CRDs or Terraform) via a DevOps/NetOps pipeline.
 
 * **Permission Group** - List of permissions on a per section basis can be attached individually to a User or a User Role. 
 
 * **User Role** - Group of user permissions and tenants for role-based access control (RBAC).
 
-* **Site** - Each separate deployment (each data center) should be defined as a Site. All network units and resources are attached to a site. Site entry defines global attributes such as; AS numbers, default ACL policy, Site Mesh (site to site VPN), and other site-level parameters.
+* **Site** - Each separate deployment (a region or a data center) should be defined as a Site. All network components and resources should be associated with their respective Site and VPC. Site entry defines global attributes such as; AS numbers, default ACL policy, and other site-level parameters.
+
+* **IPAM** - You can create IP Allocations and Subnet assignments for a VPC. These may overlap between different VPCs. A Subnet can be assigned to multiple sites if you aim to extend your V-Net to multiple locations.
 
 * **Subnet** - IPv4/IPv6 address resources linked to *Sites* and *Tenants* 
 
 * **Switch Port** - Physical ports of all switches attached to the system, or server endpoints in a Bare Metal Cloud environment.
 
 * **Inventory** - Inventory of all network units that are operated using Netris Agent.
 
+* **External connections** - You can connect your VPC to ISP providers or other segments of your network using Netris E-BGP service, or statically by defining a V-Net and using Net->Routes (for natively integrated Bare Metal Cloud Providers please refer to the provider-specific tutorial, as external connections usually establish automatically
+
 * **E-BGP** - Defines all External BGP peers (iBGP and eBGP).
+
+* **NAT services** - SNAT allows your endpoints to communicate with the Internet. DNAT allows your endpoints to be accessible from the Internet.
+
+* **Load-balancing service** - Use L4LB service to share the load between your endpoints.
+
+* **Access lists** - ACLs provide a layer of security that acts as a firewall for controlling traffic in and out of one or more subnets.
diff --git a/images/add-new-hardware.png b/images/add-new-hardware.png
diff --git a/images/allocation.png b/images/allocation.png
diff --git a/images/allocation_empty.png b/images/allocation_empty.png
diff --git a/images/bgp_empty.png b/images/bgp_empty.png
diff --git a/tutorials/images/bgp_status.png → images/bgp_status.png b/tutorials/images/bgp_status.png → images/bgp_status.png
diff --git a/images/create_dnat_empty.png b/images/create_dnat_empty.png
diff --git a/images/create_link.png b/images/create_link.png
diff --git a/images/create_snat_empty.png b/images/create_snat_empty.png
diff --git a/tutorials/images/dnat_add.png → images/dnat_add.png b/tutorials/images/dnat_add.png → images/dnat_add.png
diff --git a/tutorials/images/install_agent.gif → images/install_agent.gif b/tutorials/images/install_agent.gif → images/install_agent.gif
diff --git a/tutorials/images/inventory_switch.png → images/inventory_switch.png b/tutorials/images/inventory_switch.png → images/inventory_switch.png
diff --git a/tutorials/images/ipam_allocation.png → images/ipam_allocation.png b/tutorials/images/ipam_allocation.png → images/ipam_allocation.png
diff --git a/tutorials/images/ipam_common_subnet.png → images/ipam_common_subnet.png b/tutorials/images/ipam_common_subnet.png → images/ipam_common_subnet.png
diff --git a/tutorials/images/ipam_l4lb_subnet.png → images/ipam_l4lb_subnet.png b/tutorials/images/ipam_l4lb_subnet.png → images/ipam_l4lb_subnet.png
diff --git a/tutorials/images/ipam_loopback_subnet.png → images/ipam_loopback_subnet.png b/tutorials/images/ipam_loopback_subnet.png → images/ipam_loopback_subnet.png
diff --git a/tutorials/images/ipam_mgmt_subnet.png → images/ipam_mgmt_subnet.png b/tutorials/images/ipam_mgmt_subnet.png → images/ipam_mgmt_subnet.png
diff --git a/tutorials/images/ipam_nat_subnet.png → images/ipam_nat_subnet.png b/tutorials/images/ipam_nat_subnet.png → images/ipam_nat_subnet.png
diff --git a/tutorials/images/l4lb_create.png → images/l4lb_create.png b/tutorials/images/l4lb_create.png → images/l4lb_create.png
diff --git a/images/nat_subnet_empty.png b/images/nat_subnet_empty.png
diff --git a/tutorials/images/netris_version_example.png → images/netris_version_example.png b/tutorials/images/netris_version_example.png → images/netris_version_example.png
diff --git a/images/request-L4.png b/images/request-L4.png
diff --git a/tutorials/images/site_setup.png → images/site_setup.png b/tutorials/images/site_setup.png → images/site_setup.png
diff --git a/tutorials/images/snat_add.png → images/snat_add.png b/tutorials/images/snat_add.png → images/snat_add.png
diff --git a/images/subnet_empty.png b/images/subnet_empty.png
diff --git a/images/subnet_listing.png b/images/subnet_listing.png
diff --git a/tutorials/images/topology.png → images/topology.png b/tutorials/images/topology.png → images/topology.png
diff --git a/images/topology_2.png b/images/topology_2.png
diff --git a/tutorials/images/topology_completed.png → images/topology_completed.png b/tutorials/images/topology_completed.png → images/topology_completed.png
diff --git a/tutorials/images/topology_create_link.png → images/topology_create_link.png b/tutorials/images/topology_create_link.png → images/topology_create_link.png
diff --git a/tutorials/images/vpc_add.png → images/vpc_add.png b/tutorials/images/vpc_add.png → images/vpc_add.png
diff --git a/index.rst b/index.rst
@@ -14,17 +14,18 @@ You are welcome to join our community Slack channel (see button at the top) to g
    :maxdepth: 2
    :caption: General Information
 
-   definitions
    introduction
    supported-platform-matrix
    supported-switch-hardware
    netris-architecture
+   definitions
 
 .. toctree::
    :maxdepth: 2
    :caption: Try & Learn Netris
 
-   try-learn/index
+   try-learn/nvidia-spectrum-x-scenario
+   try-learn/onprem-k8s
 
 .. toctree::
    :maxdepth: 2
@@ -33,11 +34,13 @@ You are welcome to join our community Slack channel (see button at the top) to g
    installation/installation
    switch-agent-installation
    netris-softgate-HS
+   ai-netris-host-networking
 
 .. toctree::
    :maxdepth: 2
    :caption: Fabric Management
 
+   site
    topology-management
    network-policies
    switch-ports
@@ -62,7 +65,7 @@ You are welcome to join our community Slack channel (see button at the top) to g
    netris-ufm-integration
    netris-nvlink-integration
    kubernetes-integration
-   tutorials/netris-cloudstack
+   cloudstack/netris-cloudstack
    terraform-integration
    evpn-on-host
 
@@ -75,12 +78,12 @@ You are welcome to join our community Slack channel (see button at the top) to g
    monitoring-observability/healthchecks
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 0
    :caption: Tutorials
 
+   vpc-gateways-with-managed-fabric.rst
+   cloudstack/netris-cloudstack
    ai-netris-host-networking
-   vpc
-   tutorials/vpc-gateways-with-managed-fabric.rst
 
 .. toctree::
    :maxdepth: 4

diff --git a/introduction.rst b/introduction.rst
@@ -6,6 +6,8 @@ Introduction to Netris
 
 Netris is a network automation and abstraction software for cloud builders. Netris brings cloud-like VPC abstractions for operating physical networks like it is a cloud. Netris automatically configures switching, routing, load-balancing, and network security based on user-defined services and policies. Netris continuously monitors the network’s health and either applies software remediation or informs you of necessary actions if human intervention is required. Netris abstracts away the complexities of detailed network configuration, letting you perform efficiently by operating your physical network in a top down approach like a cloud – instead of the legacy box by box operation.
 
+Netris :doc:`SoftGate <netris-softgate-HS>`, also known as VPC gateway, provides Network Services and is an optional, multi-tenant (VPC-aware) software component designed for cloud providers and scales horizontally to provide this ingress and egress connectivity. The SoftGate software runs on a dedicated set of operator-provided bare-metal x86 servers and is tightly integrated with the Netris-managed North-South fabric.
+
 .. image:: images/private-cloud-enterprise-dc-2.png
     :align: center
 
diff --git a/l4-load-balancer.rst b/l4-load-balancer.rst
@@ -6,7 +6,7 @@
 #######################
 L4 Load Balancer (L4LB)
 #######################
-Netris L4 Load Balancer (L4LB) leverages SoftGate(Linux router) nodes to provide Layer-4 load balancing services, including on-demand cloud load balancing with native integration with Kubernetes. 
+Netris L4 Load Balancer (L4LB) leverages SoftGate(Linux router) nodes to provide Layer-4 load balancing services, including on-demand cloud load balancing with native integration with :doc:`Kubernetes <kubernetes-integration>` and :doc:`Terraform <terraform-integration>`. 
 
 Enabling L4LB service
 ---------------------
@@ -69,10 +69,10 @@ Add new L4 Load Balancer fields are described below:
 * **Port** - Service port on the backend host.
 * **Enabled** - Administrative state of particular backend. 
 
-.. image:: images/request-L4.png
+.. image:: images/l4lb_create.png
    :align: center
    :class: with-shadow
-   :alt: Request an L4 Load Balancer
+   :alt: Create an L4 Load Balancer
 
 Example: Requesting an L4 Load Balancer service.