Document your network, customer by customer.

Trama is a web application where you record your customers' sites, racks, devices, ports and cables. From that data you get rack views, a map of the network and PDF documentation ready to hand over.

Open source under the Apache 2.0 license. Runs on your own server with Docker.

How Trama organises your network

Every piece of data has its place, from the building down to a single cable. You start from the site and work down to the port.

  1. Site

    The customer's building or address: an office, a plant, a shop.

  2. Room

    A room inside the site, such as the server room or a wiring closet, with its floor plan.

  3. Rack

    The 19" cabinet: height in U, numbering, photos.

  4. Device

    Switches, firewalls, servers, patch panels, access points, cameras: mounted at the right U, or outside a rack.

  5. Interface

    Every port on the device: type, speed, PoE, VLAN, IP address, status.

  6. Connection

    The cable between two ports, with type, length and label. A port can't have two active connections.

What you do with Trama

Rack elevation

The rack drawn U by U, front and rear. Drag devices onto free U and Trama prevents overlaps and overflows. Lock a device so nobody moves it by mistake; click it to see its ports, connections and change history.

Network topology

A graph of devices and connections, built from the data you entered. Pick a layout, filter by site, type, VLAN and status, export to PNG. Double-click a node to open its rack. Save the view as a snapshot and reuse it in documents.

  • PDF documentation

    Put together the document you hand over to the customer: choose sites, rooms, racks and devices and their order, with cover page, table of contents, front and rear rack views, floor plans and topologies. You can also print the PDF of a single rack.

  • One installation, many customers

    Each customer's data is kept separate from everyone else's. Administrators manage users and customers, technicians work on every customer's data, and customer users get read-only access to their own infrastructure.

  • Wi-Fi and VPN

    Record SSIDs, security and VLANs, the access points broadcasting them and the associated clients. Document remote-access and site-to-site VPNs, linked to firewall interfaces.

  • Room floor plans

    Draw walls, doors and windows to scale, or upload an image, and place racks and devices in the room.

  • Import and export

    Import devices from CSV with a preview: if a row is invalid, nothing is saved. Export devices to CSV and a whole customer to a .zip archive you can import again, even on another installation.

  • REST API

    Read and change data through /api/v1 with a personal token; pick the customer with the X-Tenant-Id header. Swagger UI documentation included, Postman collection in the repository.

  • Everyday work

    A dashboard with the numbers of the infrastructure and what needs attention (inactive devices, interfaces down), global search, notifications, dark theme, custom icons per customer and a guided tour for newcomers. Every change is kept in the audit log.

Good to know

Open source, Apache 2.0 license

You can use, modify and redistribute Trama, including for work and commercial purposes. Keep the copyright notice and the NOTICE file, and state the changes you make.

Read the license

On your own server

Trama runs with Docker Compose on your infrastructure. Your customers' data stays there: no external service, no account to create anywhere else.

REST API

Sites, rooms, racks, devices, interfaces, connections and topology are available at /api/v1, with token authentication and a limit of 60 requests per minute. Keep Trama in sync with your other tools without copying data by hand.

Italian and English

Each user picks the interface language. PDFs are generated in the language you choose for each document.

Technology stack

  • Laravel 11, Livewire 3, Alpine.js, Tailwind CSS
  • PostgreSQL 16, Redis 7
  • Cytoscape.js for the topology graph
  • Sanctum for API authentication
  • Browsershot for PDFs
  • Docker and Docker Compose

Try the demo

The public demo is open to everyone. Sign in with one click and change the data as you like.

Address
demo.tramanet.work
Email
[email protected]
Password
demo

Or use the “Enter the demo” button on the sign-in page.

Every day at 03:00 (Italian time) all data is erased and restored. User management, profile, email and password changes, API tokens and password recovery are disabled in the demo.

Open the demo

Got a server with Docker? Trama installs with about ten commands.

Install Trama on your server