The Castopod Plugin Repository (plugins.castopod.org) 📼🧩

The Castopod Plugin Repository is the place to discover, download, and manage your plugins for Castopod. Built with CodeIgniter4, a powerful PHP framework with a very small footprint.

👉 Visit the official Castopod plugin repository: plugins.castopod.org 👈

• 🎯 Requirements
• Bundle for production
• ⚙️ Configure
  • Set environment variables
  • Supervisor
  • Cron task
• 🛡️ Security
• 💸 Funding
• 📜 License

🎯 Requirements

• PHP 8.4 with the following extensions:

  • intl
  • mbstring
  • json
  • pgsql (with pdo_pgsql)
  • zip

• PostgreSQL

• Supervisor & Git to crawl plugins automatically

• (optional) Redis for caching

Bundle for production

Run ./scripts/bundle.sh script to bundle the app into a dist folder, discarding any file meant for development only.

⚙️ Configure

Set environment variables

Rename the .env.example file to .env and replace placeholder values with yours.

Supervisor

Supervisor is used to consume the crawls queue, whenever a new plugin is added to the queue, the supervisor program will run a job to crawl it.

# /etc/supervisor/conf.d/plugin-crawler.conf

[program:castopod_plugin_repository-crawler]
command=php spark queue:work crawls -wait 10
directory=/path/to/castopod-plugin-repository
autostart=true
autorestart=true
stdout_logfile=/path/to/castopod-plugin-repository/writable/logs/crawls-worker.log
stderr_logfile=/path/to/castopod-plugin-repository/writable/logs/crawls-worker.err.log

Cron task

For computing downloads every day at midnight, set the following cron job:

* * * * * php spark tasks:run >> /dev/null 2>&1

🛡️ Security

Make all files read only except writable folder.

💸 Funding

The Castopod Plugin Repository project received funding through NGI0 Entrust, a fund established by NLnet with financial support from the European Commission's Next Generation Internet program. Learn more at the NLnet project page.

📜 License

Code released under the AGPL v3 License.

Copyright (c) 2025-present, Ad Aures.