Where Are CUPS Config Files?
CUPS server files live in /etc/cups with printers.conf and cupsd.conf as the main files. Jobs and logs live under spool and log folders.
Last updated
CUPS keeps printer definitions in /etc/cups/printers.conf and server behavior in /etc/cups/cupsd.conf. PPD files and subscriptions sit alongside them.
Active jobs spool under /var/spool/cups and logs write to /var/log/cups. macOS uses the same /etc/cups layout with launchd control instead of systemd.
Where CUPS stores this, by platform
/etc/cups/cupsd.conf
Server config. Needs root to edit. Restart with systemctl on Linux after changes. Back up before altering Listen or policy sections.
/etc/cups/printers.conf
Printer queues and device URIs. CUPS rewrites this file at runtime, so stop the scheduler or use lpadmin for changes. Check permissions if printers vanish after edits.
/var/spool/cups/
Job spool with request and document files. Needs root to inspect. PreserveJobFiles controls retention. Large stuck jobs here can fill disk space.
/etc/cups/cupsd.conf
Same layout on macOS through recent releases. Managed by launchd. Web interface is disabled by default on newer builds. Needs admin rights to edit.
Frequently asked questions
Why are my printers.conf edits overwritten?
The scheduler saves state on exit and job changes. Use lpadmin or the web interface, then confirm the file after a clean restart.
Where are CUPS logs when printing fails?
Check /var/log/cups/error_log with LogLevel raised to debug if needed. Access and page logs in the same folder show job submission and page counts.
Notice an outdated path? Let us know.