{"id":27193347,"url":"https://github.com/raphiz/renovate-devshell","last_synced_at":"2025-09-04T18:38:35.977Z","repository":{"id":281992708,"uuid":"946735231","full_name":"raphiz/renovate-devshell","owner":"raphiz","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-20T07:17:01.000Z","size":44,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-20T08:23:10.733Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/raphiz.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":"2025-03-11T15:41:25.000Z","updated_at":"2025-03-20T07:17:04.000Z","dependencies_parsed_at":"2025-03-12T08:40:02.608Z","dependency_job_id":null,"html_url":"https://github.com/raphiz/renovate-devshell","commit_stats":null,"previous_names":["raphiz/renovate-devshell"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raphiz%2Frenovate-devshell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raphiz%2Frenovate-devshell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raphiz%2Frenovate-devshell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raphiz%2Frenovate-devshell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/raphiz","download_url":"https://codeload.github.com/raphiz/renovate-devshell/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248093992,"owners_count":21046762,"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":[],"created_at":"2025-04-09T18:55:32.756Z","updated_at":"2025-04-09T18:55:33.344Z","avatar_url":"https://github.com/raphiz.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Renovate for Nix Devshells\n\nRun and configure [Renovate](https://github.com/renovatebot/renovate) via devshell.\nThis setup allows Renovate to run as an on-demand or scheduled CI job without requiring a continuously running server.\n\nIf you're using NixOS, consider the [NixOS Renovate module](https://github.com/NixOS/nixpkgs/blob/nixos-24.11/nixos/modules/services/misc/renovate.nix), as it runs Renovate as a continuously running systemd service.\n\nThis project also includes `renovate-preview`, a wrapper around Renovate that prints pending updates in a human-readable format.\n\n## Installation\n\nAdd this repository as a flake input:\n\n```nix\ninputs.renovate.url = \"github:raphiz/renovate-devshell\";\n```\n\n## Usage\n\nImport the module into your [devenv.sh](https://devenv.sh/) or [devshell.nix](https://github.com/numtide/devshell) setup:\n\n```nix\nimports = [\n  inputs.renovate.modules.default\n];\n\nrenovate.enable = true;\nrenovate.settings = {\n  # Your Renovate configuration, for example:\n  # platform = \"gitea\";\n  # endpoint = \"https://git.example.com\";\n};\n```\n\nThis setup:\n\n- Adds the `renovate` and `renovate-preview` commands to your `$PATH`.\n- Automatically sets the `RENOVATE_CONFIG_FILE` environment variable with the provided settings.\n\n\u003e [!NOTE]\n\u003e It's recommended to use a dedicated shell environment for Renovate to reduce the closure size for both CI jobs and local development.\n\nEnsure your project includes a [`renovate.json`](https://docs.renovatebot.com/getting-started/installing-onboarding/#configuration-location) file.\n\nPreview pending updates with:\n\n```bash\nrenovate-preview\n```\n\n### Running Renovate in CI\n\nTo integrate Renovate into your CI system, [configure Renovate settings](https://docs.renovatebot.com/examples/self-hosting/) according to your needs.\nAt a minimum, configure the [platform-specific](https://docs.renovatebot.com/modules/platform/) settings.\n\nFor sensitive information such as tokens (`RENOVATE_GITHUB_COM_TOKEN`, `RENOVATE_PASSWORD`, `RENOVATE_TOKEN`), use environment variables and your CI's secret management system.\n\n### Supported CI Systems\n\nThis approach supports any CI system, including:\n\n- GitHub Actions\n- GitLab CI/CD\n- Jenkins\n\n## `renovate-preview`\n\nThe `renovate-preview` CLI provides a simple, readable summary of available updates.\nIn most cases, you can run the command without additional parameters:\n\n![Example output of renovate-preview showing updates grouped by manager and kind (major, minor, etc.)](renovate-preview.png)\n\nFor more details, run:\n\n```bash\nrenovate-preview --help\n```\n\nYou can run this preview script independently of the devshell module by executing:\n\n```nix\nnix run github:raphiz/renovate-devshell#renovate-preview -- --no-validate\n```\n\n## Examples\n\n### GitHub Action\n\n...to be done...\n\n## Contributing\n\nContributions are welcome!\nFeel free to open an issue or submit a pull request.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraphiz%2Frenovate-devshell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraphiz%2Frenovate-devshell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraphiz%2Frenovate-devshell/lists"}