Filament-Sync-Service is the background service for Filament-Sync. If you are looking for the main tool application, visit Filament-Sync. This service automatically restores your custom filament profiles and database elements, preventing the printer from overwriting them with factory defaults upon reboot.
This service is actively seeking testers for K1 series machines. Please share your feedback or open an issue on GitHub to report your results.
Note
Use these instructions for manual installation if the automated install tool encounters errors.
- Download and extract the Latest Release.
- Open Fluidd in your web browser:
<your.printer.ip>:4408. - Select the Configuration
{...}tab from the left sidebar. - Click the + icon, then select Upload Folder.
- Select and upload the extracted
Filament-Sync-Servicefolder.
Open your terminal (macOS/Linux) or PowerShell (Windows) and connect to your printer:
ssh root@<your.printer.ip>
# Default Password: creality_2024Navigate to the uploaded directory and run the installation script matching your hardware model:
cd /mnt/UDISK/printer_data/config/Filament-Sync-Service/-
For K2 Series Printers:
- Install
sh install.sh
-
For K1 Series Printers:
- Install
sh install.sh k1
Once the printer service is active, finish the setup by installing the companion desktop software: 👉 Filament-Sync (Desktop Application)
Updates are managed automatically through Moonraker. When a new version is released, an update notification will appear directly inside the Fluidd interface.
If you performed a manual installation, Fluidd might not track repository updates immediately. To repair tracking:
- Open Fluidd Settings.
- Scroll to the bottom Software Updates section.
- Click the Recover button.
Alternatively, fetch the latest changes manually over SSH if git is installed on your printer:
cd /mnt/UDISK/printer_data/config/Filament-Sync-Service/
git pull