What size enclosure does a ball python need?

Adult ball pythons need a minimum 4x2x2 foot enclosure — the modern standard is a PVC enclosure of that size. Hatchlings can start in a 20-gallon tub or tank, and juveniles in a 40-gallon breeder or equivalent PVC, but you'll be upgrading within a year or two.

What humidity does a ball python need?

60–80% at all times, with temporary spikes to 90%+ during shed. Use a humidity-holding substrate like coconut fiber or cypress mulch, a large water bowl on the warm side, and cover most of the screen top if you're using a glass tank. Measure with a digital hygrometer, not a dial gauge.

What's the best substrate for a ball python?

Coconut fiber (coco coir) is the most popular — it holds humidity well and spot-cleans easily. Cypress mulch and a topsoil/play-sand mix also work, with the soil mix being best for bioactive setups. Avoid aspen (molds at ball python humidity) and cedar or pine (toxic oils).

Why won't my ball python eat or shed properly?

Almost always temperature or humidity. Low humidity causes stuck shed and retained eye caps; a too-cool warm side or oversized, insecure hides cause feeding refusal from stress. Fix the gradient, raise humidity into the 60–80% range, and give two snug hides before assuming anything is wrong with the snake.

← All exotic animals

Snakes & Pythons

Ball Python Enclosure Setup: A Complete Beginner's Guide

Q: Do ball pythons need UVB light?

Not strictly for survival, but recent research suggests low-level UVB (a 5–7% bulb in Ferguson Zone 1–2) improves immune function, appetite, and natural behavior. If you provide it, use a 6% T5 HO bulb on a 12-hour cycle with a mesh screen between bulb and snake. At minimum, give a consistent day/night cycle.

By Matt Goren · Updated June 25, 2026

Ball pythons (Python regius) are the most popular pet snake in the world, and for good reason: they're docile, easy to handle, and live 20–30 years or more in captivity. But that long, healthy life depends almost entirely on getting the enclosure right before the snake moves in. Nearly every ball python problem I get asked about — refusing food, stuck sheds, respiratory infections, chronic hiding and stress — traces back to a setup that's too cold, too dry, or missing proper hides. Get the box right and a ball python is one of the most rewarding, low-drama reptiles you can keep.

This is the complete setup guide: enclosure size, the temperature gradient, humidity, hides, substrate, an optional bioactive build, lighting, the common mistakes, and a checklist you can shop from.

Enclosure size

Ball pythons grow into substantial snakes, and the enclosure scales with them.

Ball python age	Minimum enclosure	Recommended
Hatchling (under 300 g)	20-gallon (30×12×12)	Tub or small PVC (24×18×12)
Juvenile (300–800 g)	40-gallon breeder (36×18×18)	4×2×2 PVC
Adult (800 g+)	4×2×2 ft (≈120-gallon equivalent)	4×2×2 PVC — the modern standard

The 4×2×2 foot PVC enclosure is the gold standard for an adult ball python. Glass tanks work, but they fight you on humidity. If you use glass, cover 75–80% of the screen top with aluminum foil or HVAC tape to stop moisture from venting straight out. PVC holds heat and humidity far better, which is why serious keepers default to it.

Temperature gradient

Ball pythons are ectotherms — they regulate body temperature by moving between warm and cool zones, so you must provide both ends of the gradient.

Warm side: 88–92°F surface temperature
Cool side: 76–80°F
Ambient air: 78–82°F
Nighttime drop: 72–75°F is natural and beneficial

Measure the warm side with an infrared temperature gun, not a stick-on dial — the dials are wildly inaccurate. For heat, use a halogen flood bulb or a deep heat projector on a dimming thermostat. Overhead heat is preferable because it warms the ambient air and creates a true gradient; an under-tank mat only heats the belly. Two hard rules: every heat source runs through a thermostat (an unregulated source causes burns and overheating), and never use a heat rock — they cause serious thermal burns.

Humidity

This is where most ball python keepers fail. Ball pythons need 60–80% humidity at all times, with temporary spikes to 90%+ during a shed cycle. Chronic low humidity is the leading cause of stuck shed, retained eye caps, respiratory infection, and dehydration.

Substrate choice matters most. Coconut fiber, cypress mulch, or a 70/30 topsoil/play-sand mix all hold humidity well. Avoid aspen — it molds at the moisture levels ball pythons need.
Mist as needed. If humidity drops below 60%, mist the substrate (not the snake directly).
Use a big water bowl. A large bowl on the warm side evaporates steadily and props up ambient humidity.
Measure with a digital hygrometer, placed on the cool side at substrate level. Dial gauges lie.

Hides

A ball python needs at least two hides — one warm side, one cool side — and both should be snug. The snake should touch the walls on all sides when coiled inside. This is the part beginners underestimate: a snake that feels exposed will choose security over correct temperature, parking in whichever hide feels safest regardless of its thermal needs. Two tight hides let it thermoregulate and feel safe. Add a third humid hide (a hide packed with damp sphagnum moss) during shed cycles, placed in the middle or warm side.

Substrate

Substrate controls humidity, odor, and whether you can go bioactive later.

Coconut fiber (coco coir): excellent humidity retention, easy to spot-clean, widely available. My default for a standard setup.
Cypress mulch: good humidity, natural look, resists mold.
Topsoil/play-sand mix (70/30): best base for a bioactive build with a live cleanup crew.
Avoid: aspen (molds at high humidity), cedar and pine (toxic aromatic oils), and paper towels for anything but quarantine (they hold no humidity).

Bioactive ball python enclosures

A bioactive setup uses live plants, leaf litter, and a cleanup crew of isopods and springtails to build a self-maintaining, naturalistic environment. The cleanup crew breaks down waste, suppresses mold, and dramatically cuts your routine maintenance. For a ball python's humidity range, use tropical isopod species that thrive in the wet:

Powder Blue isopods — prolific, hardy, an excellent starter cleanup crew
Powder Orange isopods — same easy care, adds visual contrast
Tropical springtails — colonize the substrate fast and graze mold and fungus

A bioactive build needs a drainage layer (clay balls or egg crate), a mesh barrier, a bioactive substrate (topsoil/sand mix plus leaf litter), and lighting for the live plants. The upfront effort is higher, but the long-term maintenance is much lower. When I'm seeding a bioactive enclosure I start the cleanup crew with All Angles Creatures' isopods — get the colony established in the substrate before the snake moves in so it's already processing waste from day one.

Lighting

Ball pythons don't strictly require UVB to survive, but the research has shifted: low-level UVB (Ferguson Zone 1–2, a 5–7% bulb) appears to improve immune function, appetite, and natural behavior. If you provide it, use a 6% T5 HO bulb on a 12-hour cycle with a mesh screen between the bulb and the snake to prevent overexposure. At a minimum, give a consistent day/night photoperiod — ball pythons are crepuscular (most active at dawn and dusk), and a stable light cycle supports their rhythm. For an evidence-based primer on reptile lighting and UV needs, the Merck Veterinary Manual's reptile husbandry section is a solid non-commercial reference.

Common ball python setup mistakes

Humidity too low. The number-one mistake. Below 60% means stuck sheds and respiratory issues — fix substrate and cover screen tops.
Only one hide. Forces the snake to trade security against temperature. Always provide both.
Oversized hides. A roomy hide gives no security. Snug is the point.
Heat rocks. Thermal burns. Use thermostat-controlled overhead heat.
No thermostat. Every heat source must be regulated, full stop.
Unmodified screen-top glass tanks. They vent humidity fast. Cover 75–80% of the top.

Essential equipment checklist

4×2×2 PVC enclosure (adult) or appropriately sized tub/tank
Halogen flood bulb or deep heat projector + dimming thermostat
Digital thermometer with probe (warm side) and an infrared temp gun
Digital hygrometer (cool side, substrate level)
Two snug hides (warm + cool) plus a humid hide for sheds
Large, heavy water bowl
Humidity-holding substrate (coco fiber, cypress mulch, or bioactive mix)
Optional: 6% T5 UVB bulb, isopod and springtail cleanup crew, live plants

Lock in the gradient, hold humidity in the 60–80% range, give two snug hides, and pick a moisture-friendly substrate, and you've eliminated the vast majority of ball python problems before they ever start.

Next steps: see my 10 essential ball python care tips for the day-to-day husbandry, or compare beginner snakes with my corn snake and Kenyan sand boa guides. The full exotic animal care library covers the rest.

More snakes & pythons