‹ Reports
The Dispatch

OSS Report: coollabsio/coolify


Coolify Faces Persistent Deployment Challenges Amidst Active Development

Coolify, an open-source platform for self-hosting applications, continues to experience significant user-reported deployment issues, particularly with Docker configurations and external service integrations, despite ongoing development efforts.

The project aims to provide an alternative to cloud services like Heroku by allowing users to manage their servers and applications on their own hardware. It is actively maintained with a strong community presence, as evidenced by its high number of stars and forks on GitHub.

Recent Activity

Recent issues highlight recurring problems with deployment failures, environment variable management, and integration with services such as GitHub. Notable issues include #3220 regarding server connectivity (504 Gateway Time-out) and #3218 concerning unwanted app restarts. These indicate potential areas where the platform's reliability could be improved.

Development Team and Recent Activity

  1. Andras Bacsai (andrasbacsai)

    • Refactored service variables in parseDockerComposeFile.
    • Added features for PostgreSQL database selection.
    • Fixed bugs related to deployment and storage management.
  2. Stuart Rowlands (stooit)

    • Fixed API return for applications and databases.
  3. Telokis

    • Enhanced homepage service template.
  4. Peaklabs-dev (ayntk-ai)

    • Addressed unique constraint errors and improved settings functionalities.
  5. Gabriel Peralta (kunumigab)

    • Added Minecraft server template.
  6. Alexzvn

    • Implemented graceful shutdown features.
  7. Jonathan Müller (J-o-n-a-t-h-a-n-M-u-e-l-l-e-r)

    • Resolved Plausible TOTP key encoding issue.
  8. Filip Gornitzka Abelson (filiabel)

    • Updated Formbricks template with new environment variables.

Of Note

  1. High Volume of Open Issues: With 269 open issues, many users report challenges with deployment and configuration management, suggesting a need for enhanced documentation or tooling improvements.

  2. Service Template Expansion: Numerous pull requests focus on adding new service templates, indicating a strategic push to broaden the platform's capabilities.

  3. Dominant Contributor: Andras Bacsai leads development efforts significantly, contributing the majority of recent commits, which may impact project direction and decision-making dynamics.

  4. Collaborative Environment: Despite the dominance of a single contributor, there is active collaboration among team members, fostering a diverse contribution landscape.

  5. Testing Emphasis: The introduction of tests alongside new features reflects a commitment to maintaining code quality and reliability through robust testing practices.

Quantified Reports

Quantify Issues



Recent GitHub Issues Activity

Timespan Opened Closed Comments Labeled Milestones
7 Days 10 38 9 6 1
30 Days 74 69 141 40 1
90 Days 389 196 1016 276 1
All Time 1552 1283 - - -

Like all software activity quantification, these numbers are imperfect but sometimes useful. Comments, Labels, and Milestones refer to those issues opened in the timespan in question.

Quantify commits



Quantified Commit Activity Over 30 Days

Developer Avatar Branches PRs Commits Files Changes
Andras Bacsai 2 5/5/0 114 163 15009
ayntk-ai 1 18/2/5 19 11 468
Telokis 1 4/1/0 1 1 112
Gabriel Peralta 1 1/1/0 2 2 49
Filip Gornitzka Abelson 1 1/1/0 1 1 48
Alexzvn 1 1/1/0 2 1 45
Luan Estradioto (LEstradioto) 1 2/2/0 1 1 14
Stuart Rowlands 1 1/1/0 1 1 2
Jonathan Müller 1 2/1/1 1 1 2
Nicolas Bondoux (Nsbx) 0 1/0/1 0 0 0
Kaotic (Kaotic) 0 0/1/0 0 0 0
Toby Brancher (Loque-) 0 0/1/0 0 0 0
Sylvain Autran (Pilpin) 0 2/0/0 0 0 0
Givan (givanz) 0 1/0/0 0 0 0
Jay (mj-dcb) 0 1/0/0 0 0 0
8x4 (8times4) 0 1/0/0 0 0 0
Giorgi Gagoshidze (ggagosh) 0 1/0/0 0 0 0
Peter Tran (nekomi2) 0 1/0/0 0 0 0
Franck Kerbiriou (FranckKe) 0 4/0/0 0 0 0
Eric Dahl (Skeyelab) 0 1/0/0 0 0 0
Darren Sisson (djsisson) 0 3/1/1 0 0 0
Lucas (mirsella) 0 1/0/0 0 0 0
Alexander G. (rennokki) 0 1/0/0 0 0 0
None (sroepges) 0 1/0/0 0 0 0
Maximilian Pluskat (Seiikatsu) 0 1/0/0 0 0 0
Stoufiler (Stoufiler) 0 0/0/1 0 0 0
busybox (busybox11) 0 1/1/0 0 0 0
Matt (OhThatMatt) 0 3/2/0 0 0 0
None (nullishamy) 0 1/0/0 0 0 0
Juan Felipe [Married Games] (JuanxCursed) 0 1/0/0 0 0 0
Bohdan Shulha (bohdan-shulha) 0 1/0/0 0 0 0
Code Wizard (pieter-berkel) 0 1/0/1 0 0 0
Tiago Miguel (tiagomiguel29) 0 1/0/0 0 0 0
Christian Kolbow (christiankolbow) 0 8/0/3 0 0 0
Jonathan Reisdorf (jonathan-reisdorf) 0 1/1/0 0 0 0
Lorenzo Migliorero (lorenzomigliorero) 0 0/1/0 0 0 0
Valentin Schabschneider (valentinschabschneider) 0 1/0/0 0 0 0

PRs: created by that dev and opened/merged/closed-unmerged during the period

Detailed Reports

Report On: Fetch issues



Recent Activity Analysis

The Coolify project has been experiencing a high volume of activity with 269 open issues, indicating ongoing user engagement and a variety of challenges being reported. Notably, many issues are related to deployment failures, environment variable management, and integration problems with external services like GitHub and Supabase.

Several issues exhibit recurring themes, such as problems with health checks failing for various applications, difficulties in managing environment variables, and complications arising from Docker configurations. The presence of multiple reports regarding SSL certificate issues and network configurations suggests that users are facing significant hurdles in setting up their applications correctly.

Issue Details

Recent Issues

  1. Issue #3220: [Bug]: 504 Gateway Time-out when validating server

    • Priority: High
    • Status: Open
    • Created: 0 days ago
    • Updated: N/A
  2. Issue #3218: [Bug]: dont start app when app explicitly stopped

    • Priority: Medium
    • Status: Open
    • Created: 1 day ago
    • Updated: N/A
  3. Issue #3211: [Bug]: Invite links via E-Mail not working

    • Priority: Medium
    • Status: Open
    • Created: 3 days ago
    • Updated: N/A
  4. Issue #3209: [Bug]: Unable to Identify github_app_uuid for Deploying Private Repository via Coolify API

    • Priority: High
    • Status: Open
    • Created: 4 days ago
    • Updated: N/A
  5. Issue #3196: [Bug]: Force Deploy without Cache only works when the project is stopped!

    • Priority: Medium
    • Status: Open
    • Created: 5 days ago
    • Updated: N/A
  6. Issue #3191: [Bug]: column "image" of relation "service_applications" does not exist

    • Priority: High
    • Status: Open
    • Created: 6 days ago
    • Updated: 3 days ago
  7. Issue #3189: [Bug]: WordPress and ClassicPress with MySQL have no ARM image

    • Priority: Medium
    • Status: Open
    • Created: 7 days ago
    • Updated: N/A
  8. Issue #3150: [Bug]: /artifacts/build.sh times out attempting to load .dockerignore & Dockerfile

    • Priority: High
    • Status: Open
    • Created: 10 days ago
    • Updated: 4 days ago
  9. Issue #3126: [Bug]: Cannot share a volume between services in docker-compose

    • Priority: Medium
    • Status: Open
    • Created: 11 days ago
    • Updated: N/A
  10. Issue #3114: [Bug]: "Preserve Repository During Deployment" option has trouble with directories

    • Priority: Medium
    • Status: Open
    • Created: 12 days ago
    • Updated: N/A

Analysis of Notable Issues

  • The issue regarding the 504 Gateway Time-out (#3220) indicates potential server connectivity problems that could affect user experience significantly.
  • The problem with apps restarting automatically despite being explicitly stopped (#3218) raises concerns about the deployment logic and user control over application states.
  • The invite link issue (#3211) suggests possible misconfigurations in user management or email handling, which could hinder onboarding processes.
  • Issues related to Docker configurations (#3196, #3126) highlight ongoing challenges users face in managing their application environments effectively.

Common Themes and Implications

The recurring themes across these issues suggest that users are struggling primarily with:

  1. Deployment and configuration management, particularly around Docker and environment variables.
  2. Integration with external services (e.g., GitHub), which is critical for CI/CD workflows.
  3. User management features that directly impact onboarding and collaboration.

These challenges could imply a need for improved documentation, more robust error handling within the application, and potentially a reevaluation of how certain features are implemented to enhance user experience and reliability.

In summary, while Coolify is actively maintained and has a vibrant community, addressing these persistent issues will be crucial for maintaining user trust and satisfaction as the platform continues to grow.

Report On: Fetch pull requests



Report on Pull Requests

Overview

The analysis of the pull requests (PRs) for the Coolify project reveals a total of 73 open PRs, with a significant focus on adding new service templates, fixing bugs, and enhancing existing features. The activity indicates a vibrant development environment with ongoing contributions from multiple developers.

Summary of Pull Requests

Open Pull Requests

  1. PR #3219: Add Vvveb CMS template

    • Significance: Introduces a new CMS template with multiple database options.
    • Notable: Includes a logo and various YAML configurations.
  2. PR #3216: Fix install.sh to use the correct port

    • Significance: Corrects the port used in the installation script.
    • Notable: A minor but crucial fix for user experience.
  3. PR #3215: Avoid crash if the team is not set

    • Significance: Prevents application crashes by ensuring null checks are performed correctly.
    • Notable: Addresses an existing issue reported in Sentry.
  4. PR #3214: Add FreshRSS service template

    • Significance: Expands service offerings by adding FreshRSS.
    • Notable: Documentation updates included.
  5. PR #3213: Add Traccar template

    • Significance: Another addition to service templates, enhancing user options.
    • Notable: Similar contributions from the same developer indicate focused efforts.
  6. PR #3202: Add Mailpit template

    • Significance: Introduces Mailpit as a service option.
    • Notable: Follows documentation from official sources.
  7. PR #3201: Add Plunk template

    • Significance: Adds another service template to the project.
    • Notable: Consistent contributions from the same developer.
  8. PR #3199: Add Nextcloud with Postgres template

    • Significance: Enhances Nextcloud deployment options with Postgres support.
    • Notable: Follows best practices for production setups.
  9. PR #3198: Update Authentik

    • Significance: Updates dependencies for Authentik.
    • Notable: Addresses breaking changes in newer versions.
  10. PR #3194: Add CloudBeaver template

    • Significance: Introduces CloudBeaver as a database management tool.
    • Notable: Follows similar patterns of adding new services.

Analysis of Pull Requests

The current state of open pull requests in the Coolify repository reflects several key themes and trends:

  1. Service Template Additions: A significant number of PRs focus on adding new service templates (e.g., Vvveb CMS, FreshRSS, Traccar). This trend indicates an ongoing effort to expand the platform's capabilities and provide users with more options for self-hosted applications. The contributions are diverse, showcasing various developers' interests and expertise in different technologies.

  2. Bug Fixes and Enhancements: Several PRs aim to fix existing issues or enhance functionality (e.g., correcting installation scripts, avoiding crashes). This reflects a commitment to maintaining code quality and improving user experience. Notably, PRs like #3215 highlight proactive measures taken to address previously reported bugs, which is essential for fostering community trust and satisfaction.

  3. Community Engagement and Collaboration: The involvement of multiple contributors suggests a healthy collaborative environment within the project. Developers are actively engaging with one another through comments and discussions on PRs, which can lead to improved code quality through peer reviews and shared knowledge.

  4. Old PRs and Merge Activity: While there is a robust influx of new PRs, it’s important to monitor older PRs that may not have received attention recently. The lack of merge activity on some older submissions could indicate potential bottlenecks in the review process or prioritization challenges within the development team.

  5. Documentation and User Guidance Improvements: Many recent PRs include updates to documentation alongside code changes (e.g., PRs #3214, #3202). This practice is crucial as it ensures that users can easily understand how to implement new features or troubleshoot issues effectively.

  6. Anomalies in Recent Activity: There are instances where certain PRs have been marked as drafts or closed without merging (e.g., PR #2998). These decisions should be communicated clearly to contributors to maintain transparency regarding project direction and priorities.

In conclusion, the current landscape of pull requests for Coolify showcases active development focused on expanding functionality through new service templates while addressing existing issues through bug fixes and enhancements. Continued engagement from contributors will be vital in sustaining this momentum and ensuring that the platform remains responsive to user needs and technological advancements.

Report On: Fetch commits



Repo Commits Analysis

Development Team and Recent Activity

Team Members and Activities

Andras Bacsai (andrasbacsai)

  • Total Commits: 114
  • Recent Work:
    • Major refactoring of the service variables in the parseDockerComposeFile function.
    • Introduced a new parser with tests for Docker Compose files.
    • Implemented features to allow selection of different PostgreSQL databases and custom Docker container options.
    • Fixed various bugs related to deployment, environment variable handling, and storage management.
    • Collaborated with other developers on multiple pull requests, merging contributions from stooit, Telokis, peaklabs-dev, and others.

Stuart Rowlands (stooit)

  • Total Commits: 1
  • Recent Work:
    • Contributed a fix for returning applications and databases in the service API.

Telokis

  • Total Commits: 1
  • Recent Work:
    • Improved the homepage service template with significant changes.

Peaklabs-dev (ayntk-ai)

  • Total Commits: 19
  • Recent Work:
    • Focused on fixing unique constraint errors in development environments and enhancing settings functionalities.

Gabriel Peralta (kunumigab)

  • Total Commits: 2
  • Recent Work:
    • Added a Minecraft server template and made updates to related YAML files.

Alexzvn

  • Total Commits: 2
  • Recent Work:
    • Worked on graceful shutdown features and fixed conflicts in the codebase.

Jonathan Müller (J-o-n-a-t-h-a-n-M-u-e-l-l-e-r)

  • Total Commits: 1
  • Recent Work:
    • Fixed the Plausible TOTP key issue by changing its encoding method.

Filip Gornitzka Abelson (filiabel)

  • Total Commits: 1
  • Recent Work:
    • Updated the Formbricks template with additional environment variables.

Patterns, Themes, and Conclusions

  1. Dominance of Andras Bacsai: The majority of commits (114 out of approximately 138) come from Andras Bacsai, indicating he is the primary contributor driving most of the recent development efforts. His work spans across various aspects of the project including feature implementation, bug fixes, and refactoring.

  2. Collaborative Efforts: There is a notable collaboration among team members, with multiple pull requests being merged that include contributions from various developers. This suggests a healthy collaborative environment where team members are actively contributing to shared goals.

  3. Focus on Bug Fixes and Features: Recent activities show a balanced focus on both fixing existing issues (like unique constraints and deployment bugs) and adding new features (such as improved database handling and new templates). This dual focus is essential for maintaining software quality while also enhancing functionality.

  4. Testing Emphasis: The introduction of tests alongside new features indicates a commitment to maintaining code quality and reliability through testing practices.

  5. Diverse Contributions: While Andras leads in contributions, other team members also engage in meaningful ways, particularly in addressing specific issues or enhancing particular features. This diversity in contributions helps distribute knowledge across the team.

In summary, the development team is actively engaged in improving the Coolify project through significant contributions, collaboration, and a balanced approach to feature development and bug fixing.