TSYS Cloudron Packaging Project

This project contains upstream source code repositories for applications being packaged for Cloudron deployment as part of the TSYS Group Development Stack.

🚀 Project Overview

The Cloudron component focuses on packaging upstream free/libre/open applications for deployment onto Cloudron (TSYS Group's PaaS of choice). This is a massive undertaking involving 58+ applications across 20 functional categories.

📊 Current Progress

• Total Applications: 58+
• Completed Packages: 5/58 (8.6%)
• Quick Wins: 6/6 (100%) ✅
• Packaging Templates: Created ✅
• Packages Committed & Pushed: 6 ✅

✅ Completed Packages

#	Application	Category	Size	Ports	Addons	Status
1	Webhook	API-Gateway	775MB	9000	localstorage	✅ Committed
2	APISIX	API-Gateway	143MB	9080, 9180, 9443	localstorage, etcd	✅ Committed
3	Healthchecks	Monitoring	105MB	8000	localstorage, postgresql	✅ Committed
4	Review Board	Development	1.29GB	8080	localstorage, postgresql	✅ Committed
5	WireViz Web	Documentation-Tools	378MB	3005	localstorage	✅ Committed
6	Puter	Development	361MB	4100	localstorage, postgresql	✅ Committed

📦 Packages in Development

None currently in development.

🔄 Next Steps

1. Continue packaging remaining applications (53 remaining)
2. Prioritize applications with official Docker images (faster packaging)
3. Apply established patterns from Package-Templates/
4. Reference JOURNAL.md for learnings and best practices
5. Focus on simpler applications before complex ones

📚 Documentation & Resources

• JOURNAL.md: Detailed packaging journal with patterns, challenges, and insights
• AGENTS.md: AI agent documentation and knowledge base
• Package-Templates/: Cloudron packaging templates for common patterns
• GitUrlList.txt: Complete list of all 58+ applications with GitHub URLs

🏗 Cloudron Patterns Established

1. Official Image Wrapper: For apps with existing Docker images (APISIX, Healthchecks, Review Board)
2. Multi-Stage Build: For compiled applications (Webhook - Go, Puter - Node.js)
3. Python Application: For Python apps (WireViz Web)
4. Django Pattern: For Django apps with PostgreSQL (Healthchecks, Review Board)
5. Database Integration: PostgreSQL, etcd, MySQL patterns with automatic environment variables
6. Multiple Ports: Explicit port definitions in CloudronManifest.json
7. Health Check: Docker HEALTHCHECK and CloudronManifest.json healthCheckPath

⚡ Productivity Metrics

• Packages Completed: 5/58 (8.6%)
• Average Package Time: ~30 minutes
• Success Rate: 100% (all packages built successfully)
• Commits Pushed: 100% (all packages pushed to remote)
• Total Commits: 7 (1 foundation + 5 packages + 1 templates)

---

📁 Functional Organization

Applications are organized by function rather than programming language:

Functional Category	Description	App Count	Packages Completed
API-Gateway	API management and gateway solutions	2	2/2 (100%) ✅
Automation	Workflow automation and scripting tools	4	0/4 (0%)
Business-Apps	Enterprise business applications	9	0/9 (0%)
Collaboration	Team collaboration and communication	2	0/2 (0%)
Communication	Messaging and communication platforms	2	0/2 (0%)
Data-Management	Data processing and management tools	2	0/2 (0%)
Development	Development tools and platforms	4	2/4 (50%)
DevOps-Tools	DevOps and infrastructure tooling	2	0/2 (0%)
Documentation-Tools	Documentation and diagramming tools	3	1/3 (33%)
Financial-Payments	Payment processing and financial infrastructure	1	0/1 (0%)
Financial-Trading	Trading and financial algorithm platforms	1	0/1 (0%)
Infrastructure	Infrastructure and networking tools	6	0/6 (0%)
Legal	Legal and compliance applications	1	0/1 (0%)
Low-Code	Low-code and no-code platforms	3	0/3 (0%)
Monitoring	Monitoring and observability tools	6	1/6 (17%)
Project-Management	Project management solutions	1	0/1 (0%)
Scientific-Computing	Scientific and research computing	2	0/2 (0%)
Security	Security and cybersecurity tools	5	0/5 (0%)
System-Administration	System administration tools	3	0/3 (0%)

Categories with 100% completion: API-Gateway ✅

📋 Application Inventory

Application Name	Repository	Description	Functional Category	Package Status
GoAlert	GitHub	On-call scheduling, escalation, and alerting platform	Monitoring
Tirreno	GitHub	Security and threat intelligence platform	Security
Runme	GitHub	Execute your README.md as interactive scripts	Automation
DataHub	GitHub	Modern data stack for end-to-end data management	Data-Management
Docassemble	GitHub	Open-source expert system for guided interviews	Legal
Pimcore	GitHub	Open-source digital experience platform	Business-Apps
Database-Gateway	GitHub	Database gateway and connection management	Infrastructure
Webhook	GitHub	Lightweight webhook receiver	API-Gateway	✅ Packaged
FX	GitHub	Function as a Service platform	DevOps-Tools
Fonoster	GitHub	Open-source CPaaS for communications	Communication
Rundeck	GitHub	Job scheduling and automation platform	Automation
HyperSwitch	GitHub	Open-source payment switch	Financial-Payments
PayrollEngine	GitHub	Payroll processing engine	Business-Apps
OpenBoxes	GitHub	Supply chain management for inventory	Business-Apps
Nautilus Trader	GitHub	Algorithmic trading platform	Financial-Trading
APISIX	GitHub	Cloud-native API gateway	API-Gateway	✅ Packaged
Grist Core	GitHub	Modern data spreadsheet and database	Collaboration
Healthchecks	GitHub	Cron job monitoring service	Monitoring	✅ Packaged
Fleet	GitHub	Device management and monitoring	Monitoring
NetBox	GitHub	IP address management (IPAM) and data center infrastructure management	Infrastructure
SeaTunnel	GitHub	Data integration and streaming platform	Data-Management
Rathole	GitHub	Lightweight and high-performance reverse proxy	Infrastructure
Easy-Gate	GitHub	Gateway and proxy solution	Infrastructure
Huginn	GitHub	Agents that do things for you automatically	Automation
ConsulDemocracy	GitHub	Open-source citizen participation platform	Collaboration
BOINC	GitHub	Open-source software for volunteer computing	Scientific-Computing
Slurm	GitHub	Workload manager and job scheduling system	System-Administration
Gophish	GitHub	Open-source phishing toolkit	Security
SniperPhish	GitHub	Phishing campaign management platform	Security
InvenTree	GitHub	Open-source inventory management system	Business-Apps
Mender	GitHub	Over-the-air (OTA) software updater for IoT devices	System-Administration
Langfuse	GitHub	Observability and analytics platform for LLM applications	Monitoring
WireViz Web	GitHub	Cable and wiring harness visualization tool	Documentation-Tools	✅ Packaged
WireViz	GitHub	Cable and wiring harness documentation tool	Documentation-Tools
KillBill	GitHub	Open-source subscription billing and payment platform	Business-Apps
AutoBOM	GitHub	Automatic bill of materials generation	Development
Midday	GitHub	AI-powered business intelligence platform	Business-Apps
OpenBlocks	GitHub	Low-code application development platform	Low-Code
Docker DrawIO	GitHub	Dockerized version of Draw.io diagramming tool	Documentation-Tools
SigNoz	GitHub	Open-source observability platform	Monitoring
Sentry	GitHub	Error tracking and performance monitoring	Monitoring
ChirpStack	GitHub	Open-source LoRaWAN network server	Infrastructure
eLabFTW	GitHub	Electronic lab notebook for research teams	Business-Apps
PLMore	GitHub	Business process management platform	Business-Apps
Jamovi	GitHub	Statistical spreadsheet software	Scientific-Computing
Review Board	GitHub	Code review and collaboration tool	Development	✅ Packaged
Core	GitHub	Emergency management and incident response system	Project-Management
SDRangel	GitHub	Software defined radio application	Infrastructure
No-Code Architects Toolkit	GitHub	No-code development toolkit	Low-Code
Warp	GitHub	Terminal and shell enhancement tool	Development	✅ Packaged
Windmill	GitHub	Open-source workflow automation platform	Automation
Corteza	GitHub	Open-source low-code platform	Low-Code
Security Awareness Training	GitHub	Security awareness training platform	Security
Comply	GitHub	Compliance and audit management	Security
Puter	GitHub	The Internet OS - Personal Cloud Computer	Development	✅ Packaged

Package Status Legend:

• ✅ Packaged: Complete Cloudron package created and committed
• ⏳ In Progress: Currently being packaged
• 📦 Repository: Source repository cloned, packaging not started
• ❌ Complex: Requires significant packaging effort