{"id":33077414,"url":"https://github.com/mayope/keycloakmigration","last_synced_at":"2026-01-19T13:02:31.118Z","repository":{"id":41478008,"uuid":"162558921","full_name":"mayope/keycloakmigration","owner":"mayope","description":"Manage your Keycloak configuration with code.","archived":false,"fork":false,"pushed_at":"2025-12-05T16:47:38.000Z","size":45980,"stargazers_count":126,"open_issues_count":5,"forks_count":25,"subscribers_count":5,"default_branch":"master","last_synced_at":"2026-01-15T02:06:08.441Z","etag":null,"topics":["devops","gradle","gradle-plugin","infrastructure-as-code","keycloak","kotlin","migration"],"latest_commit_sha":null,"homepage":"https://mayope.net","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mayope.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/contributing/index.html","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2018-12-20T09:45:54.000Z","updated_at":"2025-12-30T06:39:21.000Z","dependencies_parsed_at":"2025-08-12T20:23:20.011Z","dependency_job_id":"bddda921-e610-4f67-b98b-49379e560e64","html_url":"https://github.com/mayope/keycloakmigration","commit_stats":null,"previous_names":["klg71/keycloakmigration"],"tags_count":122,"template":false,"template_full_name":null,"purl":"pkg:github/mayope/keycloakmigration","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mayope%2Fkeycloakmigration","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mayope%2Fkeycloakmigration/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mayope%2Fkeycloakmigration/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mayope%2Fkeycloakmigration/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mayope","download_url":"https://codeload.github.com/mayope/keycloakmigration/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mayope%2Fkeycloakmigration/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28568833,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-19T12:50:50.164Z","status":"ssl_error","status_checked_at":"2026-01-19T12:50:42.704Z","response_time":67,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["devops","gradle","gradle-plugin","infrastructure-as-code","keycloak","kotlin","migration"],"created_at":"2025-11-14T11:00:29.138Z","updated_at":"2026-01-19T13:02:31.094Z","avatar_url":"https://github.com/mayope.png","language":"Kotlin","funding_links":[],"categories":["Tools"],"sub_categories":[],"readme":"# Keycloakmigration ![Maven metadata URL](https://img.shields.io/maven-metadata/v/https/repo.maven.apache.org/maven2/de/klg71/keycloakmigration/keycloakmigration/maven-metadata.xml.svg?label=mavenCentral)\n\nThis projects aims to automate the configuration of the keycloak authentication provider.\nIt is inspired by the database migration tool liquibase.\nThe goal is to provide a similar mechanism for Keycloak. \n\n## Documentation\nFor full documentation please visit: https://mayope.github.io/keycloakmigration/\n\n## Quickstart\n### Gradle\nApply the current version of the Plugin:\n\n```gradle\nplugins {\n  id \"de.klg71.keycloakmigrationplugin\" version \"x.x.x\"\n}\n```\n\nUse the Tasks to execute the migration:\n#### Groovy\n```groovy\n    task keycloakMigrateLocal(type: KeycloakMigrationTask) {\n      group = \"keycloak\"\n      description = \"Migrate the keycloak instance\"\n\n      migrationFile = \"migration/keycloak-changelog.yml\"\n      adminUser = \"admin\"\n      adminPassword = \"admin\"\n      baseUrl = \"http://localhost:8080\"\n      realm = \"master\"\n      parameters = [USERNAME: \"testUser\", PASSWORD: \"testPassword\"]\n      waitForKeycloak = false\n      waitForKeycloakTimeout = 0L // infinit wait time\n      failOnUndefinedVariables = false\n      warnOnUndefinedVariables = true\n    }\n```\n\n### Kotlin\n```kotlin\n    register\u003cKeycloakMigrationTask\u003e(\"keycloakMigrateLocal\") {\n        group = \"keycloak\"\n        description = \"Migrate the keycloak instance\"\n\n        migrationFile = \"migration/keycloak-changelog.yml\"\n        adminUser = \"admin\"\n        adminPassword = \"admin\"\n        baseUrl = \"http://localhost:8080/auth\"\n        realm = \"master\"\n        parameters = mapOf(\n                \"USER_NAME\" to \"testUser\",\n                \"PASSWORD\" to \"password\"\n        )\n        waitForKeycloak = false\n        waitForKeycloakTimeout = 0L // infinit wait time\n        failOnUndefinedVariables = false\n        warnOnUndefinedVariables = true\n    }\n```\n   To correct existing hashes please use the `KeycloakMigrationCorrectHashesTask`.\n   \n### Using the fatjar\nThen migration can simply be invoked through the jar. (Found attached to the latest release on github https://github.com/klg71/keycloakmigration/releases)\n\n    java -jar keycloakmigration.jar --help\n    usage: [-h] [-u USER] [-p PASSWORD] [-b BASEURL] [MIGRATION-FILE] [-r REALM]\n           [-c CLIENT] [--correct-hashes] [-k PARAMETER]... [--wait-for-keycloak]\n           [--wait-for-keycloak-timeout WAIT_FOR_KEYCLOAK_TIMEOUT]\n\n    optional arguments:\n      -h, --help                                              show this help message and exit\n\n      -u USER, --user USER                                    Username for the migration user, defaulting to admin.\n\n      -p PASSWORD, --password PASSWORD                        Password for the migration user, defaulting to admin.\n\n      -b BASEURL, --baseurl BASEURL                           Base url of keycloak server, defaulting to\n                                                              http://localhost:18080/auth.\n                                                              \n      -r REALM, --realm REALM                                 Realm to use for migration, defaulting to master\n\n      -c CLIENT, --client CLIENT                              Client to use for\n                                                              migration,\n                                                              defaulting to master\n\n      --correct-hashes                                        Correct hashes to most recent version, defaulting to false\n\n                                                              Just choose this option if you didn't change anything in\n                                                              the changelog since the last migration!\n                                                              This will replace all old hashes with the new hash version\n                                                              and can be omitted next time the migration is run.\n                                                              See README.md for further explanation!\n\n      -k PARAMETER, --parameter PARAMETER                     Parameters to substitute in changelog, syntax is:\n                                                              -k param1=value1\n                                                              will replace\n                                                              ${param1} with\n                                                              value1 in changelog\n\n      --wait-for-keycloak                                     Wait for Keycloak to become ready.\n\n      --wait-for-keycloak-timeout WAIT_FOR_KEYCLOAK_TIMEOUT   Wait for Keycloak to become ready timeout in seconds (defaulting to 0=infinit).\n      \n      --fail-on-undefined-variables                           Fail if variables could not be replaced, defaulting to false.\n  \n      --warn-on-undefined-variables                           Fail if variables could not bereplaced, to true.                                                \n      \n\n    positional arguments:\n      MIGRATION-FILE                                          File to migrate, defaulting to keycloak-changelog.yml\n      \n\n\n## TODOS\n- Add commands for identity providers (see issues)\n- batch updates for users\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmayope%2Fkeycloakmigration","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmayope%2Fkeycloakmigration","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmayope%2Fkeycloakmigration/lists"}