• Devices
  • Cables
  • Groups
  • Diagnostics
  • Providers
  • Your networks
  • ipaddr.js
  • qrcode-generator

A whole network. Replaces the canvas.

Examples

My templates

A saved selection. It goes in beside what you have, moved to the next free subnet.

My blocks

Select a node or link to configure.

Selected

Shift-click adds or removes one. Esc clears the selection.

Tap devices to add or remove them.

Change all of them

A field that says "mixed" differs between them. A field left blank, or as it is, is not changed.

{n} counts up, {n:02} pads it to two digits, {name} is the current name. With Find filled, only that text in each name is replaced.

No subnet is declared yet. Declare one on the Subnets tab first.

Each one takes the next free address there, and its gateway and DNS come from the subnet.

There is no switch or access point on the map to move them to.

Each one's cable moves to the next free port there. The device keeps its address: Move gives it one on another subnet.

There are no groups yet. Add one on the Groups tab first.

Moved anywhere but a rack, a device leaves its units in the rack behind.

None of them is a VM or a container: only those run on another device.

A VM or a container is where the device it runs on is, in its group and its rack.

Only the devices on Wi-Fi change. Auto lets Topo work it out from the access point.

Passthrough bypasses the host OS, connecting the VM directly to the physical switch logic.

Pick the interface this link uses on each end. Occupied ports are marked — you can still pick one, and the node will flag the conflict.

Unassigned switches act as L2 Backplanes.

⚙️ Open in Netplan ↗

Asset

Model and firmware are in one field.

Retired: dimmed on the map, and off the network for the checks and the trace.

    Locate

    History
    Answer checks
    Trace off
    Select a node to see its diagnostics.

    Node diagnostics

    Idle

    Where devices sit: buildings, floors, rooms and racks.

    The networks the access points broadcast. No passphrase is kept: a network travels in files and links.

    Who is responsible for what, and how to reach them.

    Topo checks only what you ask it to. Anything not checked has no state.

    Only a Topo desktop app that monitors this network runs these checks. This page never checks.

    The problems reported on this network and the visits recorded for them.

    No problem has been reported on this network.

      To check on the next visit

        No findings: every check passes on the map as drawn.

          Accepted

          Known and kept on purpose. They no longer count, and the report lists them with their reason.

            Topo documents a network: its devices, cables, addressing, racks and who is responsible for what, and prints it as a report.

            Runs in your browser. Nothing you add here is uploaded. This site also asks GitHub for the latest desktop version.

            To use it with no internet: download Topo for Windows, Mac or Linux

            The file format is published: docs/FORMAT.md

            Read-only This network was made by a newer version of Topo. You can look at it, report on it and export it as it is, but changes are not kept.You are a viewer on the server: you can look at this network, report on it and export it, but changes are not kept.
            Not saved This browser's storage is full or blocked. Back up now so nothing is lost.

              Click a row to select its devices, then use Change all of them to edit them together.

              Click a row to find it on the map. Enter or a double click edits a cell, Esc cancels. Ctrl+V pastes a list down a column.

              Tap a cell to select its row. Tap the same cell again to edit it.

              Nothing here yet.

              Cables

              Drag over empty units, or tap one, to place a device there. Drag a device to move it, and the top edge of the selected one to resize it. Drag from a free port to another device's free port to cable them. Drag a device from the lists onto the units to bring it in, or off the units to take it out. Point at or tap a port to read its cable.

              What are you documenting?

              Pick the view that fits — you can switch anytime, nothing is lost.

              Nobody ever wrote this network down.
              Draw it once, and it checks itself.

              Every device, every subnet, every cable — with the address conflicts, loops and dead gateways found for you, and a report you can hand over. It runs in this tab — no server, no upload, no account — which is why it still works in a comms room with no signal.

              Start a new network

              A blank canvas that saves itself in this browser from the first device.
              Or drop a .json build file, or a whole binder, here.Or open a .json build, or a whole binder, with Open a file.

              Working where there is no internet?

              An installer for Windows, Mac and Linux, or a folder to open in a browser. It works with no internet, and your networks stay on this computer.

              ⤓ Get Topo for this computer
              First time here? Start from something that already exists.
              Networks you save are kept in this browser, and show up here.

              Shared with you

              On this server

              Your networks

              Templates

              Old sent copies are taking up space: close or merge them.

              Saved networks live in this browser only — this is not an account, and clearing site data removes them. Back up for a copy that survives.

              Settings

              Map

              Reports

              History

              Problem reports

              Filled in when you report a problem. Kept in this browser; a report you send carries them.

              Screen lock

              After this long without use, Topo saves, closes the open network and covers the screen until it is unlocked. For this PC only.

              Unlock with the PIN, or by signing in to your Topo server again with a code sent to your email. Each wrong PIN says how many tries are left, and after 10 only the sign-in unlocks. With no server to sign in to, the PIN can be forgotten from the fifth wrong try, which Settings then says, and after 10 each further try waits longer.

              The lock stops someone using a screen left unattended. It is not encryption: the networks stay in this browser as before, and anyone who can use this PC's account can read them with the browser's own tools. Without a PIN or a sign-in it only hides the screen.

              Connect to a Topo server

              This window keeps networks on a Topo server and syncs with the other PCs that use it. Sign in with your email, as in a browser.

              This server signs its own certificate. Compare this fingerprint with the one the server shows (on the server PC: Settings, This PC as the server, or its log). Connect only if they are the same.

              Certificate fingerprint (SHA-256):

              Server:

              Certificate fingerprint (SHA-256):

              This PC as the server

              Other PCs on site sign in and sync with this one.

                Certificate fingerprint (SHA-256):
                Each other PC's browser warns about the certificate once. Check that it shows this fingerprint, then go on to the page.

                Other PCs reach it over https with a certificate this PC makes. Give this PC a fixed address (a DHCP reservation): the address is in every sign-in link. The firewall may ask to let Topo server in.

                Log
                
                                                    

                Monitor from this PC

                Asks each device and service with an answer check one question, "are you answering?", from this PC, and keeps how long they take. It never scans or discovers anything, and never reads a device's settings.

                Kept on this PC only: every check for 7 days, and hourly figures for as long as chosen here. Off keeps nothing; the states still show.

                On some desktops (Wayland among them) the tray icon may not show. Then Topo keeps checking only while its window is open.

                The site's monitor

                When a device stops answering, a card covers every screen of this PC with its name, how long it has been down and what is behind it, with a short chime (the volume is left as it is), and a system notification goes out. It stays an open issue until someone acknowledges it, reports it or marks it expected. A device answering again is a small notification only.

                On Wayland a window cannot always stay above the others, and with several screens the card may show on one of them only: there the system notification is the one to rely on.

                Back-ups

                Back-up folder:

                Download a back-up saves there instead. Pick a OneDrive, Google Drive or Nextcloud folder and its own app uploads the files.

                Setup

                The questions Topo asks the first time: how it looks, the view, where networks are kept (in the app, connecting to a Topo server or making this PC the server), the screen lock and how to start.

                This computer

                Adds this PC to the open network: its name, maker, model and serial number, its network cards with their addresses, their subnets and its default gateway, read from this PC alone. Nothing is sent onto the network, the router itself is not added, and the review shows everything before it is kept.

                Set up Topo

                How should Topo look?

                Change it any time with the switch beside the Carino name at the top.

                How will you use Topo?

                What are you documenting?

                Change it any time with Something missing? Try another mode.

                Where are your networks kept?

                Connected to a Topo server

                Disconnect in Settings, Connect to a Topo server.

                Connect to a Topo server

                Type the server's address as your organisation gives it, for example https://192.168.1.20:7380.

                Compare the certificate

                This server signs its own certificate. Compare this fingerprint with the one the server shows (on the server PC: Settings, This PC as the server, or its log). Connect only if they are the same.

                Server:

                Certificate fingerprint (SHA-256):

                Make this PC the server

                It runs in the background from startup, even when Topo is closed or nobody is signed in. Setting it up asks for an administrator.

                This PC's server sends no email: Setup gets each sign-in code from it, for this account only. Other PCs can be added later in Settings, This PC as the server.

                Other PCs need sign-in codes by email: fill in the email server that sends them.

                Starting the server

                Topo waits for the server to answer on this PC, then connects this window to it.

                Sign in to Topo

                The first person to sign in becomes the owner of this server. The setup code is in the server's log.

                Sign in to Topo

                Skip this step to finish it later in Settings.

                Lock the screen when nobody is using it?

                After this long without use, Topo saves, closes the open network and covers the screen until it is unlocked. For this PC only.

                Without a PIN the lock only hides the screen. It is not encryption of what this PC keeps.

                This PC

                Both happen once a network is open, through Settings and the review.

                How do you want to start?

                Add devices

                More options

                {n} counts up, {n:02} pads it to two digits, {type} is the kind of device. Numbering carries on after the names already on the map.

                Site report

                The findings, the inventory and the diagram as one printable document. Everything here is optional — it only fills in the header.

                What goes in
                Sheets to print
                Tap a square here or on the preview's overview to leave its sheet out.
                Sections Untick a section to leave it out of the technical details. The summary does not change.
                Saved searches Each one prints as a table of the devices it finds. Ticking here changes this report only.

                Share this network

                This link is locked

                Whoever sent it should have given you a passphrase separately. Nothing is sent anywhere — it is checked in this browser.

                  Columns

                  Which columns the Devices table shows, and in what order. It is saved with the network, and your columns that show here are printed in the report. Spreadsheets keep their own order, so a sheet always reads back.

                    Add a column

                    Save search

                    A type name in another language matches only in that language. Its key (type:camera) matches in every language.

                    Columns

                      Add an address

                      Report a problem

                      What is wrong?

                      Where?

                      Your name and phone or email

                      Whom to contact

                        What the link carries

                          Record visit

                          How did it go?

                          What changed since the copy arrived

                            Monitoring during the visit

                            Restore points

                            A copy of this network is kept here before a file, a binder, a link or a sheet changes it. Restore puts one back, and keeps how it is now as a restore point first. They stay in this browser.

                            No restore points.

                              Network log

                              Each merge into this network from another copy, newest first: where it came from, who merged it and what it changed. The log travels with the network in its files and links, and cannot be edited here.

                              Nothing has been merged into this network yet.

                                    The changes
                                    The visit

                                    Networks to decide on

                                      Expected life by type

                                      How many years each kind of device lasts in this network before it shows as past its expected life. Blank uses Topo's usual, shown greyed. A device's own Expected life still wins. Saved with the network.

                                        Paste a column

                                        One value per line, in the order the rows are shown. A blank line leaves its row as it is.

                                        Change

                                          Spreadsheet

                                          Each sheet is a CSV file any spreadsheet opens (UTF-8, accents and all). Copy as TSV puts the same rows on the clipboard, to paste straight into an open sheet.

                                          Paste rows copied from a spreadsheet, or open a CSV file. Rows are matched to devices by id, MAC, IP or name; a row that matches none adds a device. Nothing changes until you apply it.

                                          Or paste an ARP table or a DHCP lease list as a router, a switch, a server or a PC prints it, from any vendor: each address seen with its MAC becomes a row.

                                          Read as

                                          Import from another tool

                                          Topo is locked

                                          Forgetting the PIN unlocks this screen and removes the PIN from this PC. Your networks stay in this browser: the lock never encrypted them. Settings will say when it was forgotten.

                                          This deletes from this PC the network that was open and every network from your Topo server kept here, and signs you out here. They stay on the server; changes not sent yet are lost.