Circuits¶

Circuits are the WAN and data links you lease from providers — internet transit, MPLS, dark fibre, point-to-point — recorded with their provider, circuit ID, and the sites at each end.

You build them in three layers: providers (who you buy from), circuit types (how you classify links), and the circuits themselves.

Add a provider¶

A provider is the company you lease a circuit from.

1. Open Circuits → Providers in the sidebar and click Add provider.
2. Give it a name.
3. Optionally fill in the account number, portal URL, and NOC email / phone so support details live right next to the circuits.
4. Save.

Add a circuit type¶

A circuit type classifies your links — Internet, Transit, MPLS, Dark Fibre, anything that fits your network.

1. Open Circuits → Circuit types and click Add circuit type.
2. Name it and pick a color so it stands out in the circuit list.
3. Save.

Add a provider network¶

A provider network is the far side of a circuit that isn't one of your own sites — the provider's IP-transit cloud, an internet-exchange fabric, another carrier's network. It exists so a circuit's Z end has something real to land on when it doesn't terminate at your own facility.

1. Open Circuits → Provider networks and click Add provider network.
2. Pick the provider and give the network a name (e.g. "Telia IP transit"). Optionally record the provider's service ID for it.
3. Save.

Add a circuit¶

1. Open Circuits → Circuits and click Add circuit.
2. Choose the provider and enter the circuit ID (the provider's reference for the link). This pair must be unique.
3. Optionally pick a circuit type and set a status.
4. Optionally record the install date, termination date, and commit rate (in kbps).
5. Save, then open the circuit and add its terminations (below).

Terminate a circuit¶

Each end of a circuit is a termination — side A and side Z. A termination lands on exactly one of:

• one of your sites, or
• a provider network (for transit/IX circuits whose far end is the provider's cloud).

Each side carries its own physical details: port speed and upstream speed (kbps, for asymmetric links), the cross-connect ID at the facility, and patch-panel info — so the data an operator needs at the meet-me room lives on the side it belongs to.

1. Open the circuit's detail page → Terminations tab.
2. Add the A side (usually your site) and the Z side (the far site or a provider network).
3. Fill in speeds / cross-connect / patch-panel details as known.

Circuit status¶

Tags & custom fields¶

Need to track something extra — a contract end date, an SLA tier, an order number? Add a custom field for circuits and it appears on every circuit's form. See Tags & custom fields.