Shapeoko CNC Setup Guide
A bench-level walkthrough for the Shapeoko 3, 4 and 5. We cover frame squaring, belt tension, wasteboard surfacing, spindle tram and the first cuts in wood and aluminum, plus the limits where a desktop router stops being the right machine.
In this article
- 1
- 2
- 3
- 4
- 5
- 6
- 7
What matters most in a Shapeoko CNC setup
Bench, frame and squaring before anything moves
A Shapeoko CNC setup starts with the table, not the controller. The machine weighs enough that a flexing bench will show up as chatter in every cut. Use a bench that does not rock when you lean on one corner, and leave at least 600 mm of clearance on all four sides so you can reach the back rail and pass long stock through. A level floor helps, but a stiff frame matters more than a perfectly level one.
Assemble the base frame loose, then square it before final tightening. Measure the two diagonals across the frame corners with a tape or a long rule. On a 1,000 mm frame, aim for less than 0.5 mm difference between the two diagonals. If the numbers disagree, push the longer diagonal corner inward and re-measure. Only then tighten the fasteners in a cross pattern, a quarter turn at a time.
Slide the X gantry onto the Y rails and check that it moves without binding at either end. The V-wheels should turn by hand with light drag, not spin free and not lock up. A common mistake is overtightening the eccentric nuts, which flattens the wheel and creates a flat spot that shows as a periodic mark on the work surface.
One more check before power. Push the gantry to each corner of travel and listen. A clean machine sounds the same in all four corners. A grind or a knock means a rail is twisted or a wheel is too tight, and no software setting will fix it later.
Belt tension, motor wiring and the first power-up
Belt tension is the single most common setup error on a belt-driven router. Pluck the belt like a guitar string. It should give a low note, not a dull thud and not a sharp ping. As a working range, press the middle of a long belt span with a thumb and look for roughly 0.5–1 mm of deflection. If the belt is loose, the Y axis will lag on direction changes and circles come out oval.
Tension both belts on an axis to the same feel. Uneven tension tilts the gantry, and a tilted gantry cuts a taper into every part. After tensioning, jog the axis by hand through its full travel. There should be no point where it gets harder to push.
Route the motor and limit switch cables away from the spindle and the vacuum hose. Stepper wiring that runs beside a mains cable can pick up noise and cause lost steps. Keep signal wires on one side of the frame and power wires on the other where the layout allows.
On first power-up, do not home the machine yet. Move each axis 10 mm at a time with the jog controls and confirm the direction matches the arrow on screen. If an axis runs the wrong way, flip the direction in the controller settings rather than rewiring the motor plug. Then home the machine and watch the limit switches trigger cleanly at each end.
Software setup, work zero and tool length
Send the configuration for your exact model before you cut anything. The steps-per-mm values, travel limits and homing speed differ between the Shapeoko 3, 4 and 5, and a wrong steps-per-mm value makes every dimension wrong by a fixed percentage. After flashing the config, command a 100 mm move on X and measure it with calipers against a stop. If the machine travels 98 mm, the calibration is off and needs correcting before real work.
Set work zero with the method that matches the job. For a part held in the front-left corner of the wasteboard, touch off X and Y against the stock edge and set Z on the top face. A touch plate gives repeatable Z within about 0.02 mm, which is far better than eyeballing a paper shim. If you cut the same part repeatedly, mark the corner of the wasteboard and save the zero as a fixture offset.
Tool length is where many first cuts fail. After every tool change, re-zero Z on the stock or on a fixed probe. If you zero Z on the wasteboard instead of the top of the stock, the first plunge goes straight through the part.
Warm up the spindle for a minute at low speed in cold shops. Bearings that are still cold run tighter, and the first cut of the morning is often the one that breaks a small end mill. Keep the vacuum or dust shoe running from the first cut; chips left in the slot get recut and dull the tool.
What a Shapeoko does well and where it stops
A desktop router is a prototyping tool. It cuts hardwood, MDF, acrylic, polycarbonate, HDPE and light aluminum well when the setup is right. Aluminum 6061 at 0.5–1 mm depth per pass with a single-flute cutter and a light mist of lubricant is a realistic target. Deep pockets in dense material are not.
Rigidity sets the ceiling. A belt-driven gantry with a trim router spindle deflects under load, so deep cuts chatter and leave marks on the wall. If a part needs a 20 mm deep pocket, a 0.8 mm wall, or a bore held to ±0.05 mm, the desktop machine will fight you on every pass. Take the same geometry to a mill with a rigid frame and coolant.
Heat is the second limit. Wood and plastic carry heat away poorly, and aluminum chips weld to the cutter when the flute loads up. Run a single-flute cutter for aluminum, keep the chip load steady, and clear chips with air. If the cutter is warm to the touch after a short pass, the feed is too slow or the speed is too high.
Size is the third limit. Most Shapeoko models cut a few hundred millimeters in X and Y and around 75–100 mm in Z. Anything longer than the travel has to be tiled, and tiling multiplies the chance of a mismatch at the joint. When a part outgrows the envelope, move it to a machine that can cut it in one setup.
Shapeoko CNC setup in 9 steps
- 1Level and stiffen the benchSet the bench on a solid floor and shim the feet until a level reads flat in both directions. Leave 600 mm clearance on all sides for stock and service access.
- 2Square the base frameAssemble loose, measure both diagonals, and adjust until the difference is under 0.5 mm on a 1,000 mm frame. Then tighten in a cross pattern.
- 3Set the V-wheel preloadAdjust the eccentric nuts so each wheel drags lightly when turned by hand. No free spin, no lock-up. Recheck after the first hour of running.
- 4Tension the beltsPluck test for a low note, then confirm 0.5–1 mm deflection at mid-span. Match both belts on an axis so the gantry stays square.
- 5Wire and flash the configKeep signal cables away from mains and spindle leads. Load the config for your exact model, then verify a commanded 100 mm move with calipers.
- 6Home and check travelHome each axis, confirm limit switches trigger cleanly, and jog to all four corners of travel by hand to feel for binding.
- 7Surface the wasteboardFit a 25 mm surfacing bit, take 0.2–0.3 mm off the whole bed in overlapping passes at 50–60% stepover, then vacuum the dust.
- 8Tram the spindleSweep a dial indicator on a 100 mm arm around the bed. Adjust the mount until front-to-back and side-to-side read within 0.05 mm.
- 9Cut the test partCut a 50 mm square in scrap and measure it. Correct steps-per-mm or belt tension before cutting a real part; wood first, aluminum second.
First-cut starting points by material
Single-flute cutter for aluminum; two-flute upcut for wood and plastic. Adjust after listening to the cut.
| Material | Depth per pass | Spindle speed | Notes |
|---|---|---|---|
| Hardwood (oak, maple) | 1.5–3 mm | 16,000–20,000 rpm | Two-flute upcut, feed 1,500–2,500 mm/min |
| MDF and plywood | 2–4 mm | 14,000–18,000 rpm | Dust extraction is mandatory, chips pack the slot |
| Acrylic and PMMA | 0.8–1.5 mm | 12,000–16,000 rpm | Two-flute, watch for melting and chip welding |
| HDPE and POM | 1–2 mm | 12,000–16,000 rpm | Single or two-flute, clamp firmly, material is slick |
| Aluminum 6061 | 0.5–1 mm | 10,000–14,000 rpm | Single flute, light lubricant, clear chips with air |
| Brass (free cutting) | 0.3–0.5 mm | 8,000–12,000 rpm | Light pass, lubricant, expect noise |
| Carbon fiber sheet | 0.3–0.5 mm | 10,000–12,000 rpm | Diamond or coated cutter, dust extraction with filter |
When the desktop router is no longer enough
Prove the design on the Shapeoko, then move anything with deep pockets, thin walls, tight bores or hard metal to a rigid mill. GreatLight runs 127 CNC machines, including 16 simultaneous 5-axis centers, to ±0.005 mm and 4,000 mm of travel, with quote and DFM feedback inside 12 hours.
Shapeoko setup questions we hear often
How tight should the belts be on a Shapeoko?
Press the middle of a long belt span with a thumb. You want roughly 0.5–1 mm of deflection and a low musical note when you pluck it. A dull thud means too loose, a sharp ping means too tight.
Tighten both belts on the same axis to the same feel. Uneven tension tilts the gantry and cuts a taper into the part, which no amount of feed tuning will remove.
Why do my circles come out oval?
Oval circles usually mean belt tension or wheel preload is off, not a software bug. Check the belt on the axis that is short, then check the V-wheels for a flat spot from overtightening.
If both are fine, look at acceleration. Too high an acceleration value makes the motor skip on direction changes. Drop it by 20–30% and cut the test part again.
Do I need to surface the wasteboard?
Yes, at least once after assembly. The bed and the gantry are never perfectly parallel out of the box, and a shallow facing pass makes the bed match the machine axes.
Take 0.2–0.3 mm per pass with a 25 mm surfacing bit at 50–60% stepover. Repeat only when the surface shows deep marks or you have cut into it.
Can a Shapeoko cut aluminum?
Yes, within limits. Aluminum 6061 at 0.5–1 mm depth per pass with a single-flute cutter and a light mist of lubricant is a realistic working range.
Deep pockets, thin walls and tight bores are where it struggles. The belt-driven gantry deflects, so chatter appears on tall walls and the cutter rubs instead of cutting.
How do I set Z zero without crashing the tool?
Zero Z on the top of the stock, never on the wasteboard, unless the toolpath was written that way. Use a touch plate for repeatability of about 0.02 mm.
Re-zero after every tool change. Most broken small end mills come from a stale Z zero left over from the previous tool.
When should I move a part to a machine shop?
When the part needs a deep pocket, a wall under about 1 mm, a bore held tighter than ±0.05 mm, or a material like steel, titanium or Inconel.
Those jobs need a rigid frame, coolant and a tool changer. A desktop router can prove the design; it cannot hold the tolerance in production.
Send the part that outgrew the desktop machine
Upload a STEP file and we return a quote with DFM notes in 12 hours. No minimum order quantity, from one prototype upward, and your files stay confidential.
12-hour quote±0.005 mm toleranceNo minimum order quantityNDA on request
More from the floor
We publish setup notes, tooling trials and inspection data from the factory floor.
