{"id":29482859,"url":"https://github.com/agama-project/agama","last_synced_at":"2025-07-15T02:02:37.267Z","repository":{"id":37083091,"uuid":"440244970","full_name":"agama-project/agama","owner":"agama-project","description":"A service-based Linux installer","archived":false,"fork":false,"pushed_at":"2025-07-08T17:05:02.000Z","size":61829,"stargazers_count":187,"open_issues_count":100,"forks_count":54,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-07-08T18:28:03.459Z","etag":null,"topics":["installler","linux","opensuse","suse"],"latest_commit_sha":null,"homepage":"https://agama-project.github.io/","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/agama-project.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-12-20T16:57:45.000Z","updated_at":"2025-07-08T18:17:00.000Z","dependencies_parsed_at":"2023-07-14T01:27:51.431Z","dependency_job_id":"a3d97e47-9b8d-486e-829b-bb770afeba08","html_url":"https://github.com/agama-project/agama","commit_stats":null,"previous_names":["yast/d-installer","agama-project/agama","opensuse/agama"],"tags_count":41,"template":false,"template_full_name":null,"purl":"pkg:github/agama-project/agama","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agama-project%2Fagama","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agama-project%2Fagama/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agama-project%2Fagama/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agama-project%2Fagama/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/agama-project","download_url":"https://codeload.github.com/agama-project/agama/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agama-project%2Fagama/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265386079,"owners_count":23756747,"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":["installler","linux","opensuse","suse"],"created_at":"2025-07-15T02:01:57.923Z","updated_at":"2025-07-15T02:02:37.253Z","avatar_url":"https://github.com/agama-project.png","language":"Ruby","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# Agama: A Service-based Linux Installer\n\n[![CI - Rust](https://github.com/openSUSE/agama/actions/workflows/ci-rust.yml/badge.svg)](https://github.com/openSUSE/agama/actions/workflows/ci-rust.yml)\n[![CI - Service](https://github.com/openSUSE/agama/actions/workflows/ci-service.yml/badge.svg)](https://github.com/openSUSE/agama/actions/workflows/ci-service.yml)\n[![CI - Web](https://github.com/openSUSE/agama/actions/workflows/ci-web.yml/badge.svg)](https://github.com/openSUSE/agama/actions/workflows/ci-web.yml)\n[![CI - Rubocop](https://github.com/openSUSE/agama/actions/workflows/ci-rubocop.yml/badge.svg)](https://github.com/openSUSE/agama/actions/workflows/ci-rubocop.yml)\n[![CI - Documentation Check](https://github.com/openSUSE/agama/actions/workflows/ci-doc-check.yml/badge.svg)](https://github.com/openSUSE/agama/actions/workflows/ci-doc-check.yml)\n[![CI - Integration Tests](https://github.com/openSUSE/agama/actions/workflows/ci-integration-tests.yml/badge.svg)](https://github.com/openSUSE/agama/actions/workflows/ci-integration-tests.yml)\n[![Coverage Status](https://coveralls.io/repos/github/openSUSE/agama/badge.svg?branch=master)](https://coveralls.io/github/openSUSE/agama?branch=master)\n[![Translation Status](https://l10n.opensuse.org/widgets/agama/-/agama-web/svg-badge.svg)](https://l10n.opensuse.org/engage/agama/)\n\nAgama is a new Linux installer born in the core of the YaST team. It is designed to offer\nre-usability, integration with third party tools and the possibility of building advanced user\ninterfaces over it.\n\n| ![Product selection](https://raw.githubusercontent.com/agama-project/agama-project.github.io/refs/heads/main/static/img/user/product-selection.png) | ![Installation overview](https://raw.githubusercontent.com/agama-project/agama-project.github.io/refs/heads/main/static/img/user/overview.png) |\n| --- | --- |\n\n\u003cdetails\u003e\n\u003csummary\u003eClick to show/hide more screenshots\u003c/summary\u003e\n\n---\n\n| ![Software page](https://raw.githubusercontent.com/agama-project/agama-project.github.io/refs/heads/main/static/img/user/software.png) | ![Storage settings](https://raw.githubusercontent.com/agama-project/agama-project.github.io/refs/heads/main/static/img/storage.png) |\n| --- | --- |\n| ![Installing](./doc/images/screenshots/installing.png) | ![Installation finished](./doc/images/screenshots/finished.png) |\n\u003c!-- TODO: move these ^^^ screenshots to the web repository as well --\u003e\n\n\u003c/details\u003e\n\n## Why a New Installer\n\nThis new project follows two main motivations: to overcome some of the limitations of YaST and to\nserve as installer for new projects, like those based on SUSE Linux Framework One.\n\nYaST is a mature installer and control center for SUSE and openSUSE operating systems. With more\nthan 20 years behind it, YaST is a competent and flexible installer able to cover uncountable use\ncases. But time goes by, and the good old YaST is starting to show its age in some aspects:\n\n- The architecture of YaST is complex and its code-base has too much technical debt.\n- Designing and building rich and modern user interfaces is a real challenge.\n- Sharing logic with other tools like Salt or Ansible is very difficult.\n- Some in-house solutions like [libyui](https://github.com/libyui/libyui) make more difficult to\n  contribute to the project.\n\n## Running Agama\n\nThe easiest way to give Agama a try is to grab a live ISO image and boot it in a virtual machine.\nThis is also the recommended way if you only want to play and see it in action. If you want to have\na closer look, then clone and configure the project as explained in the next section.\n\nYou can download the ISO from the\n[openSUSE Build Service](https://download.opensuse.org/repositories/systemsmanagement:/Agama:/Devel/images/iso/).\n\n\u003e [!NOTE]\n\u003e Make sure to download the correct ISO file according to your system architecture (eg. you would\n\u003e need to choose a file including `x86_64` if you use an Intel or AMD 64-bit processor).\n\n## Remote access\n\nThe Live ISO automatically starts a graphical interface (using the local browser). However, you\nmight want to access remotely to the installer. If you know the IP address of the system, you just\nneed to point your browser to `https://$IP`.\n\nFor the case you do not know the address, or just for convenience, the Live ISO is configured to use\n[Multicast DNS](https://en.wikipedia.org/wiki/Multicast_DNS) (sometimes called mDNS, Avahi,\nZeroconf, Bonjour) for hostname resolution. Therefore, connecting to `https://agama.local` should do\nthe trick.\n\n\u003e [!WARNING]\n\u003e Do not use the `.local` hostnames in untrusted networks (like public WiFi networks, shared\n\u003e networks), it is a security risk. An attacker can easily send malicious responses for the `.local`\n\u003e hostname resolutions and point you to a wrong Agama instance which could for example steal your\n\u003e root password!\n\nIf you have troubles or you want to know more about this feature, check our [Remote\naccess](https://agama-project.github.io/docs/user/remote) documentation.\n\n## Other Resources\n\n- If you want to know how Agama works, you should read about\n  [Agama's architecture](https://agama-project.github.io/docs/devel/architecture)\n- If you would like to [contribute](#how-to-contribute), you might be interested in:\n  - [Running Agama from sources](https://agama-project.github.io/docs/devel/running).\n  - [Working with Agama's web server](./rust/WEB-SERVER.md).\n  - [Working with Agama's web UI](./web/README.md).\n- You can check the overall status of the project through the [status page](/STATUS.md).\n\n## How to Contribute\n\nIf you want to contribute to Agama, then please open a pull request or report an issue. You can also\nget involved in [our discussions](https://github.com/openSUSE/agama/discussions).\n\nFor more details, please read the [contributing](CONTRIBUTING.md) guidelines.\n\n### Translators\n\nThank you for translating Agama to your language!\n\nIf something is broken about the translations, see the detailed\n[Agama i18n workflow and internals][i18n] documentation.\n\nSee also the [openSUSE Translation][trans-ml] mailing list and its archives.\n\n[i18n]: https://agama-project.github.io/docs/devel/i18n\n[trans-ml]: https://lists.opensuse.org/manage/lists/translation.lists.opensuse.org/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagama-project%2Fagama","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagama-project%2Fagama","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagama-project%2Fagama/lists"}