{"id":13484851,"url":"https://github.com/codecov/self-hosted","last_synced_at":"2025-04-08T01:35:00.310Z","repository":{"id":184019719,"uuid":"659790884","full_name":"codecov/self-hosted","owner":"codecov","description":"Example of how to setup Codecov with docker compose","archived":false,"fork":false,"pushed_at":"2025-01-31T15:30:24.000Z","size":42,"stargazers_count":469,"open_issues_count":13,"forks_count":40,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-04-01T00:33:54.269Z","etag":null,"topics":["fair-source"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codecov.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-06-28T15:06:37.000Z","updated_at":"2025-03-30T00:51:02.000Z","dependencies_parsed_at":"2023-07-26T19:38:07.043Z","dependency_job_id":"9485a5af-f6bb-4a93-8398-6007f25951a5","html_url":"https://github.com/codecov/self-hosted","commit_stats":null,"previous_names":["codecov/self-hosted"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codecov%2Fself-hosted","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codecov%2Fself-hosted/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codecov%2Fself-hosted/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codecov%2Fself-hosted/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codecov","download_url":"https://codeload.github.com/codecov/self-hosted/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247761042,"owners_count":20991531,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fair-source"],"created_at":"2024-07-31T17:01:36.352Z","updated_at":"2025-04-08T01:35:00.278Z","avatar_url":"https://github.com/codecov.png","language":"Shell","readme":"# Self-Hosted Codecov\n\u003e Code coverage done right.® Empower your developers with Codecov to improve code quality.\n\n\u003e We believe that everyone should have access to quality software (like Sentry), that’s why we have always offered Codecov for free to open source maintainers.\n\u003e\n\u003e By open sourcing Codecov, we’re not only joining the community that’s supported us from the start — but also want to make sure that every developer can contribute to and build on the Codecov experience.\n\nTesting software is crucial for deploying healthy code. Codecov provides metrics and insight in the results of tests through code coverage reports. Coverage reports are used to determine what lines of code were tested and what lines were missed entirely. These reports are uploaded to Codecov to be analyzed and stored historically. This information helps your developers save time tracking down bugs and commit stronger code that is well tested, to increase code coverage to 100%.\n\n### Features\n\nCommit statuses and pull request comments are key to maintaining a healthy product. Codecov provides valuable metrics in the pull request feed and promotes healthy development.\n\nOur unique Coverage Diff® will describe the commit in relation to its impact on tests which significantly improves code reviews.\n\n### Usage\n\nThis repo is meant for a quick POC that can be ran locally. It is recommended to use Helm or Terraform to deploy Codecov in production.\n\nCodecov currently requires your team to use one or more of the following: GitHub, GitHub Enterprise, GitLab, Gitlab CE, GitLab Enterprise, Bitbucket and Bitbucket Server. You will need to configure one (or more) of these providers for your self-hosted install of Codecov to function correctly. \n\nWe recommend using our [Self-Hosted Configuration Guide](https://docs.codecov.com/docs/configuration) to ensure that your self-hosted install is properly configured.\n\n### Disclaimer\n\nAs mentioned above, this is meant for a quick POC or example of how to run Codecov. This configuration is not hardened for security and any usage is at your own risk. Default database credentials are included in the docker compose config. At a minimum, this should be updated at a minimum before wider usage. The minio bucket is also exposed via the docker compose. This is needed for Codecov to function locally. While no secret data is stored in this bucket, it is still recommended to make this private and interface with storage via presigned urls. This necessitates using a [storage backend such as S3 or GCS](https://docs.codecov.com/v5.0/docs/archiving-reports#configuration-ii-minio-with-s3).\n\n### License Generation\n\nCodecov self-hosted is based on Codecov's Enterprise On-Premises offering which is now deprecated. As a result, this software requires a license to run properly. **This is purely a technical requirement of the software at this time** and you will never be asked to purchase a license from Codecov or any other entity in order to use Codecov self-hosted. \n\nThe installation comes with a general license with a 50 user seat limit. We chose 50 seats as we believe this is the maximum number of users a Docker Compose based PoC can reliably support out of the box, but your mileage may vary depending on how you plan to use Codecov. \n\nIf you require more seats, a `license.py` script has been added that you can use from the command line to generate a license. From the scripts directory, run the following command:\n\n```\npython3 license.py new --expires=2030-12-25 --company=company-name  --users=50\n```\nYou can set `expires`, `company`, and `users` to whatever future date, name, and user count you wish respectively, but those arguments are required for the script to function properly. \n\nNote that this script requires pycryptodome to be installed on your system. You can install it with:\n\n```\npip install pycryptodome\n```\n","funding_links":[],"categories":["Shell"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodecov%2Fself-hosted","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodecov%2Fself-hosted","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodecov%2Fself-hosted/lists"}