Voron Gantry Alignment Guide — Frame Squaring, Rail Parallelism, and Gantry Racking

Build Mechanical Calibration

Gantry alignment is the single most impactful mechanical calibration you can perform on a Voron printer. A misaligned gantry causes vertical surface artifacts (VFA), inconsistent first layers, uneven Z height across the bed, belt wear, increased motor load, and reduced print quality. Even a 0.1mm misalignment at one corner of the gantry can translate into visible layer shifting or banding on tall prints. Last updated: May 2025.

This guide covers the complete gantry alignment process for all Voron models: frame squaring during assembly, linear rail parallelism verification, gantry racking diagnosis and correction, belt tracking optimization, and print quality troubleshooting. These procedures apply to V2.4, Trident, V0.2, and Switchwire with model-specific notes where relevant.

Frame Squaring Procedure

All Voron printers use 2020 or 3030 aluminum extrusion frames. If the frame is not square, nothing mounted to it will be square either. Frame squaring should be done during initial build assembly and checked periodically (every 6-12 months or after any significant mechanical impact).

Tools Required

• Machinist's square (150mm or larger, precision grade)
• Digital calipers or a tape measure capable of 0.5mm accuracy
• 6" or 12" precision straight edge (optional but recommended)
• Feeler gauges (0.05-1.0mm range)
• 12mm combination wrench or socket for M5/M6 extrusion bolts

Step-by-Step Frame Squaring

1. Diagonal measurement method: Measure the distance between opposite corners of the frame (top-left to bottom-right, then top-right to bottom-left). The two diagonals must be within 0.5mm of each other on a 350mm frame, 0.3mm on a 250mm frame, and 0.2mm on a V0.2 120mm frame. If the diagonals differ, loosen all frame bolts, apply pressure to the longer diagonal corner, and re-tighten.
2. Corner square check: Place the machinist's square at each interior corner of the extrusion frame. The square should contact both extrusions evenly with no visible gap. If a gap exists, the frame is twisted at that joint. Loosen the two bolts at that corner, adjust, and retighten.
3. Vertical extrusion alignment: Use a straight edge across the Z extrusions (for V2.4 and Trident) to ensure they are coplanar. Any Z extrusion that protrudes more than 0.2mm from its neighbors indicates a twist or misalignment in the frame bottom.
4. Base flatness: Place the frame on a known-flat surface (a granite countertop or precision table). All four base corners should contact the surface. Rocking or wobbling means the base is twisted — loosen all base bolts and re-tighten while applying downward pressure.

Voron-specific note: The V2.4's 4-post design is more tolerant of minor frame imperfections than the Trident's monocoque design. However, the V2.4 is more sensitive to Z extrusion parallelism because the gantry rides on all four Z extrusions simultaneously. The Trident's rigid bed frame is less forgiving of base twist but less sensitive to Z extrusion alignment.

Linear Rail Parallelism

After the frame is square, verify that all linear rails are parallel to each other and to the frame extrusions they are mounted on. Non-parallel rails cause binding, increased friction, and visible artifacts.

X/Y Rail Parallelism

• Y rails (on V2.4 and Trident): The two Y-axis rails must be parallel to each other and to the frame. Measure the distance between the two rails at the front and back of the printer. The difference should be under 0.1mm. If larger, loosen the rail mounting bolts, use a parallel reference bar between the rails, and retighten from center outward.
• X rail (on toolhead carriage): The single X rail on the gantry crossbar must be parallel to the Y-plane. Measure with calipers from the rail to the frame at both ends. Shim under the rail if needed with kapton tape or aluminum foil (0.05-0.1mm shims).
• Z rails (V2.4 and Trident): Each of the four (V2.4) or two (Trident) Z rails must be parallel to the vertical extrusions. A rail that is not parallel forces the gantry or bed into a bind as it moves up. Check by mounting a dial indicator on the gantry and moving Z — the reading should not change by more than 0.02mm over full travel.

Rail Parallelism Check Method

The best method for verifying rail parallelism is the micrometer sweep test:

1. Mount a dial indicator on the X carriage with the tip contacting a reference surface (the opposite Y rail or a parallel bar).
2. Move the gantry from one end of the travel to the other while noting the dial indicator reading.
3. If the reading changes by more than 0.05mm over 300mm of travel, the rails are not parallel. Loosen, realign, and retighten.
4. Repeat for the other axis.

Common mistake: Overtightening linear rail bolts can distort the rail. Only tighten to the manufacturer's spec (typically 1.5-2.5 Nm for M3 bolts on a 2020 extrusion). Use a torque-limiting driver or be very careful with hand tightening.

Gantry Racking Diagnosis and Fix

Gantry racking occurs when the X-axis gantry is not parallel to the Y-axis or the bed plane. It manifests as one side of the gantry being higher or lower than the other, causing the nozzle-to-bed distance to vary across the X axis. On Voron V2.4 and Trident, gantry racking is the most common alignment problem.

Diagnosing Racking

• Visual test: Home the printer, then move the Z axis up 50mm. Look at the gantry from the front — the left and right sides of the X extrusion should be at exactly the same height relative to the frame. A visible height difference is racking.
• Dial indicator test (precise): Place a dial indicator on the bed surface (or a reference block on the bed). Move the toolhead to the left X position, zero the indicator. Move to the right X position. The reading should be within 0.02mm. More than 0.05mm indicates significant racking that requires correction.
• First layer test: Print a single-layer square across the full X width (e.g., 300mm wide for a 350mm printer). If one side is squished and the other is loose, you have gantry racking.

Fixing Racking — V2.4 Specific

The V2.4's gantry is driven by four independent Z motors. Klipper's Z_TILT_ADJUST can correct tilt, but it cannot correct mechanical racking (twist in the gantry structure itself). To fix mechanical racking:

1. Check the X/Y gantry joint bolts: The screws connecting the X extrusion to the Y gantry plates (the four bolts at each end) must be tight and even. Loose bolts allow the gantry to sag.
2. Check the belt path: Unequal belt tension between the left and right X/Y belts can induce racking. Tension both X/Y belts to the same frequency using the Voron belt tension method (see below).
3. Adjust X/Y block shimming: If the gantry is mechanically twisted (one corner higher despite Z_TILT_ADJUST), you may need to shim one of the X/Y gantry plates. Loosen the four bolts on the high-side plate, insert a 0.1-0.2mm shim (kapton tape or aluminum foil) between the plate and the X extrusion, and retighten.
4. Check the gantry crossbar: The X extrusion crossbar itself must be straight. Place a straight edge along the extrusion. If there is a bow, loosen the gantry plate bolts and carefully straighten before retightening.

Fixing Racking — Trident Specific

The Trident's gantry is driven by two Z lead screws on the sides. Racking is less common because the bed moves rather than the gantry (on the Trident, the bed goes up and down, the gantry is fixed). However, the gantry can still rack if:

• The gantry crossbar is not parallel to the base frame. Use the same dial indicator method described above, but on the Trident, the fix is usually in the gantry plate mounting on the Z extrusions.
• The Z lead screws are not parallel to the Z extrusions. Check with a level or square against the Z extrusion while rotating the lead screw by hand — binding means the screw is not parallel.

Fixing Racking — V0.2 and Switchwire

• V0.2: The single Z motor and bed-screw-driven Z (bed moves on a single lead screw) means gantry racking is less likely. However, the X gantry can sag if the X rail is not parallel to the bed. Adjust by shimming the X rail carriage mount points.
• Switchwire: As a bed-slinger (single Z motor, bed moves in Y), gantry racking manifests as Y-axis banding. Check that the Y extrusions are parallel and the Z lead screw is perpendicular to the bed plane.

Belt Tracking and Tension

Improper belt tracking and tension directly contribute to gantry alignment issues. Belts that track to one side of the pulley add lateral force to the gantry, causing uneven wear and alignment drift.

Belt Tracking Adjustment

• Visual inspection: Watch each belt as the gantry moves. The belt should ride centered on both the motor pulley and the idler pulley. If the belt walks to one edge, the pulley is not parallel to the belt path.
• Pulley alignment fix: Loosen the motor mounting screws and use a straight edge along the belt path to align the motor pulley with the idler pulley. Tighten while maintaining alignment.
• Belt twist: A twisted belt will not track straight. If your belt has a twist (due to improper routing), remove, untwist, and reinstall. Belts should lie flat on the extrusion surface they pass over.

Belt Tensioning Method (Voron Standard)

1. Use a frequency-based tension measurement (smartphone app or dedicated tool). The target frequency for Voron belts (GT2, 6mm wide) is 110-130 Hz for X and Y, measured by plucking the belt like a guitar string 100mm from the pulley.
2. Alternatively, use the deflection method: press down on the belt at mid-span with ~100g force. The belt should deflect 2-4mm. More deflection = looser.
3. Tension both sides of each axis equally. Unequal tension causes the gantry to pull to one side during acceleration — this is a common cause of diagonal first-layer artifacts.
4. Re-check belt tension after any significant gantry work, including rail realignment or racking correction. Tension changes as mechanical alignment shifts.

Print Quality Troubleshooting

Periodic Maintenance Schedule

Tools and Resources

• Dial indicator with magnetic base: Essential for precise alignment measurement. A 0.01mm resolution indicator is sufficient. Available for $20-50 on Amazon or from machining supply stores.
• Machinist's square: 150mm or 200mm, grade B or better. Starrett, Mitutoyo, or equivalent. A cheap square (under $15) may not be square itself.
• Belt tension frequency app: "Gate" for iOS, "FrequenSee" for Android, or the "Voron Belt Tension" web tool. These use your phone's microphone to measure belt vibration frequency.
• Voron community discord: The #mechanical-assistance channel is extremely helpful for diagnosing specific alignment issues with photos and descriptions.