bigtreetech / bigtreetech/CB1

CB1 Image Ships With Unnecessary, Locked Klipper/Moonraker Configs That Prevent a Clean Install

Open
#235 2 comments 1 reaction 0 assignees View on GitHub
Dominant language
No language data
Stars
496
Forks
86
PR merge metrics
No merged PRs in 30d

Description

Summary
The current CB1 OS image includes preloaded Klipper, Moonraker, and system configuration files that are unnecessary, undocumented, and cannot be removed or modified. These files interfere with clean Klipper installations, override user configurations, and prevent users from building their own modular setup. The image does not behave like a standard Linux environment and blocks normal Klipper workflows.

Environment
Board: BTT CB1

Image: Latest release from GitHub

Use case: Clean Klipper + Moonraker installation

Multiple SD cards tested

No custom modifications

Major Problems
1. Unneeded Klipper/Moonraker configs are preinstalled
The image ships with:

Predefined printer.cfg fragments
Preloaded Moonraker configs
Old or mismatched Klipper directories
Precreated service files
These configs:
Do not match the user’s hardware
Are not documented
Cannot be safely removed
Cause conflicts with fresh installs
Break modular configuration setups
A CB1 image should not include any printer‑specific or user‑specific configs.

2. These configs are locked read‑only
Even with root access, the preloaded configs cannot be edited or deleted.
Attempts to modify or remove them result in: Read-only file system

This prevents:

Replacing incorrect configs
Removing vendor presets
Installing a clean Klipper environment
Using KIAUH
Creating a modular config structure
This forces users into a locked, vendor‑defined configuration that is unusable for most printers.

3. Clean Klipper workflows are blocked
Because the preloaded configs cannot be removed or overwritten, users cannot:

Install their own Klipper version
Install their own Moonraker version
Create their own service files
Use their own printer.cfg
Build a clean, modular configuration
This breaks every standard Klipper installation method.

4. Image behavior does not match documentation
Documentation suggests:

Users can install Klipper normally
Users can configure their own printer
The system behaves like a standard Linux environment
But the actual image:
Locks critical directories
Forces vendor configs
Prevents clean installs
Contains mismatched or outdated components
This creates confusion and makes troubleshooting impossible.

Expected Behavior

No preinstalled Klipper or Moonraker configs
No vendor printer.cfg
Writable filesystem
Ability to install Klipper cleanly
Ability to create a modular config structure
Behavior consistent with documentation

Actual Behavior

Unnecessary configs are preloaded
These configs are locked read‑only
Clean installs are blocked
User configs cannot be applied
System behaves inconsistently with documentation

Image

Request

Please provide a clean CB1 image with:

No preinstalled Klipper/Moonraker configs
No vendor printer.cfg
No locked configuration directories
A writable filesystem
A standard Linux environment suitable for clean Klipper installs
This would restore the CB1 to a usable state for the majority of Klipper users.

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by inspecting the latest CB1 image for the preloaded Klipper and Moonraker directories, printer.cfg fragments, service files, and their filesystem permissions. Compare the image contents with the documented clean-install workflow. Done means the image contains no vendor-specific configs, configuration locations are writable, and a clean Klipper/Moonraker installation can be created.

Written by the indexing model from the issue text.

Assessment

Tech stack
linux
Domain
embedded-iot, operating-systems
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.