ngandrass/moodle-archiving-worker repository overview

⁠Moodle Archiving Worker

Archiving worker service to work in conjunction with Moodle archiving plugins, such as quiz_archiver⁠.

This application processes Moodle archiving jobs. It renders Moodle user content, such as quiz attempts, inside a headless webbrowser and exports it to PDF/HTML files, including MathJax formulas and other complex elements that require JavaScript processing. Generated PDFs can be converted into a PDF/A compliant format for long-term storage. Moodle backups can optionally be included in the generated archive. The checksum for each file within the archive as well as the checksum of the archive itself is calculated to allow integrity checks.

For more information and the full documentation see:
https://github.com/ngandrass/moodle-archiving-worker⁠

⁠Configuration / Environment Variables

A full list of all available environment variables can be found here: Configuration⁠

• MOODLE_ARCHIVER_SERVER_HOST: Host to bind to (default='0.0.0.0')
• MOODLE_ARCHIVER_SERVER_PORT: Port to bind to (default=8080)
• MOODLE_ARCHIVER_LOG_LEVEL: Logging level. One of 'CRITICAL', 'FATAL', 'ERROR', 'WARN', 'WARNING', 'INFO', 'DEBUG' (default='INFO')
• MOODLE_ARCHIVER_QUEUE_SIZE: Maximum number of jobs to enqueue (default=32)
• MOODLE_ARCHIVER_PARALLEL_JOBS: Number of jobs to run in parallel (default=4)
• MOODLE_ARCHIVER_REQUEST_TIMEOUT_SEC: Maximum number of seconds a single job is allowed to run before it is terminated (default=1800)
• MOODLE_ARCHIVER_BACKUP_STATUS_RETRY_SEC: Number of seconds to wait between backup status queries (default=30)
• MOODLE_ARCHIVER_BACKUP_DOWNLOAD_MAX_FILESIZE_BYTES: Maximum number of bytes Moodle backups are allowed to have (default=(1024 * 10e6))
• MOODLE_ARCHIVER_PDFA_CONVERSION: Convert generated PDFs to PDF/A format (default=True)
• MOODLE_ARCHIVER_STATUS_REPORTING_INTERVAL_SEC: Number of seconds between job status updates sent to Moodle (default=15)

⁠Help

• Installation⁠
• Configuration⁠

⁠Reporting a bug or security vulnerability

If you have problems installing the the Moodle Archiving Worker Service, or you have further questions, please feel free to open an issue within the GitHub issue tracker⁠.

If you want to report a security problem please take a look at our Security Policy⁠

⁠License

2026 Niels Gandraß [email protected]⁠

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/⁠.