Ansible Galaxy

App · 10 actions

Find and track Ansible content on Ansible Galaxy: search collections, namespaces and roles, read a collection's versions, dependencies, modules and module documentation, and start a workflow when a collection publishes a new version. No account or API key required.

Actions

ActionWhat it does
Get a collectionGet a collection at its latest version or any other: description, downloads, dependencies, the ansible-core versions it works with, how many modules, plugins and roles it holds, its links and its download address and checksum.
Get a module's documentationRead the documentation of a module or plugin in a collection: what it does, its options (type, default, choices, whether required), requirements, notes, examples and the values it returns.
Get a namespaceGet a namespace and the collections it publishes, with each one's latest version and downloads, plus its company, description and links.
Get a roleGet a standalone role: what it does, its latest version, downloads, tags, the roles it depends on, and the GitHub repository and commit it was last imported from.
List a collection's contentList the modules, roles and plugins in a collection version, each with what it does in one line, optionally only one kind or names containing a word.
List a collection's versionsList the versions a collection has published, highest or newest first, with when each came out, the ansible-core versions it works with and the command that installs it.
List a role's versionsList the versions a standalone role has released, newest first, with when each was tagged and where to download it.
Search collectionsFind Ansible collections on Galaxy by words, namespace and tags, or the ones that depend on a collection, each with its latest version, description, tags, dependencies and the ansible-core versions it works with.
Search namespacesFind the namespaces that publish collections on Galaxy, by name or company, with each one's company, description and logo.
Search rolesFind standalone Ansible roles on Galaxy by a word, author or tag, most downloaded first, with each one's latest version, downloads and GitHub repository.

Get a collection

Get a collection at its latest version or any other: description, downloads, dependencies, the ansible-core versions it works with, how many modules, plugins and roles it holds, its links and its download address and checksum.

Inputs

CollectioncollectiontextRequired
The collection as namespace.name, like community.general, or the address of its page on galaxy.ansible.com. Search collections finds both.
Versionversiontext
Which version, picked from the list or typed. Empty for the latest.

Outputs

authorslist
Its authors, as they list themselves.
collectiontext
The collection as namespace.name, e.g. community.general.
content_countslist
How many modules, roles and plugins of each kind this version holds.
dependencieslist
The collections this version needs.
deprecatedtrue/false
Whether its publisher has deprecated the collection.
descriptiontext
What it does, in its authors' words.
documentationtext
Its documentation site.
download_countnumber
How many times it has been downloaded, all versions together.
download_urltext
Where to download this version's archive.
filenametext
The archive's file name, e.g. community-general-13.5.0.tar.gz.
first_published_attext
When the collection first appeared on Galaxy.
homepagetext
Its home page.
install_commandtext
The command that installs this version (the latest, unless a version was picked).
is_latesttrue/false
Whether the version described is the latest.
issuestext
Where to report problems with it.
last_updated_attext
When the collection last changed, usually its latest release.
latest_versiontext
The collection's latest version.
licensetext
Its licences (SPDX ids), comma separated.
module_countnumber
How many modules this version holds.
nametext
Its name within the namespace, e.g. general.
namespacetext
The namespace that publishes it, e.g. community.
plugin_countnumber
How many plugins (lookup, filter, callback and the rest) it holds.
published_attext
When this version was published.
repositorytext
Its source code repository.
requires_ansibletext
The ansible-core versions this version works with, e.g. >=2.18.0.
role_countnumber
How many roles it holds.
sha256text
The archive's SHA-256 checksum.
size_bytesnumber
The archive's size in bytes.
summarytext
One sentence saying what came back, for a message or a log.
tagslist
Its tags, e.g. aws or cloud.
urltext
This version's page on galaxy.ansible.com.
versiontext
The version described.
Example output
{
  "authors": [
    "Ansible (https://github.com/ansible)"
  ],
  "collection": "amazon.aws",
  "content_counts": [
    {
      "content_type": "module",
      "count": 141,
      "label": "Modules"
    },
    {
      "content_type": "lookup",
      "count": 5,
      "label": "Lookup plugins"
    }
  ],
  "dependencies": [],
  "deprecated": false,
  "description": "A variety of Ansible content to help automate the management of AWS services.",
  "documentation": "https://ansible-collections.github.io/amazon.aws/branch/main/collections/amazon/aws/index.html",
  "download_count": 95040745,
  "download_url": "https://galaxy.ansible.com/api/v3/plugin/ansible/content/published/collections/artifacts/amazon-aws-12.0.0.tar.gz",
  "filename": "amazon-aws-12.0.0.tar.gz",
  "first_published_at": "2023-05-08T20:50:47Z",
  "homepage": "https://github.com/ansible-collections/amazon.aws",
  "install_command": "ansible-galaxy collection install amazon.aws",
  "is_latest": true,
  "issues": "https://github.com/ansible-collections/amazon.aws/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc",
  "last_updated_at": "2026-10-13T20:50:17Z",
  "latest_version": "12.0.0",
  "license": null,
  "module_count": 141,
  "name": "aws",
  "namespace": "amazon",
  "plugin_count": 12,
  "published_at": "2026-10-13T20:50:17Z",
  "repository": "https://github.com/ansible-collections/amazon.aws",
  "requires_ansible": ">=2.18.0",
  "role_count": 0,
  "sha256": "521982d74fa6a5268887fc1b9aff5477b89fb8889a1428a05737ff5615f26685",
  "size_bytes": 1511297,
  "summary": "amazon.aws 12.0.0 (the latest version): 141 modules, 12 plugins and 0 roles, downloaded 95,040,745 times in all.",
  "tags": [
    "amazon",
    "aws",
    "cloud"
  ],
  "url": "https://galaxy.ansible.com/ui/repo/published/amazon/aws/",
  "version": "12.0.0"
}

Get a module's documentation

Read the documentation of a module or plugin in a collection: what it does, its options (type, default, choices, whether required), requirements, notes, examples and the values it returns.

Inputs

CollectioncollectiontextRequired
The collection as namespace.name, like community.general, or the address of its page on galaxy.ansible.com. Search collections finds both.
Module or pluginplugintextRequired
Its name, like s3_bucket, or its full name, like amazon.aws.s3_bucket. List a collection's content lists them.
Typecontent_typetext
A module unless you pick a kind of plugin.One of: module, become (Become plugin), cache (Cache plugin), callback (Callback plugin), cliconf (Cliconf plugin), connection (Connection plugin), filter (Filter plugin), httpapi (HttpApi plugin), inventory (Inventory plugin), lookup (Lookup plugin), and 6 more. Default: module.
Versionversiontext
Which version, picked from the list or typed. Empty for the latest.

Outputs

authorslist
Who wrote it.
collectiontext
The collection as namespace.name, e.g. community.general.
content_typetext
Galaxy's name for its kind, e.g. module or lookup.
content_type_labeltext
Its kind in words, e.g. Lookup plugin.
deprecationtext
Why it is deprecated, when it goes and what to use instead. Empty when it is not deprecated.
descriptiontext
What it does, in full.
examplestext
Its examples, as playbook YAML.
full_nametext
Its full name, e.g. amazon.aws.s3_bucket.
nametext
The module's or plugin's short name, e.g. s3_bucket.
noteslist
Its notes and caveats.
option_countnumber
How many options it takes.
optionslist
The options it takes, by name.
required_optionslist
The names of the options it requires.
requirementslist
What the machine running it needs, e.g. python >= 3.6.
return_valueslist
The values it returns.
short_descriptiontext
What it does, in one line.
summarytext
One sentence saying what came back, for a message or a log.
urltext
Its documentation page on galaxy.ansible.com.
versiontext
The collection version read.
version_addedtext
The collection version that added it.
Example output
{
  "authors": [
    "Gerben Geijteman (@hyperized)"
  ],
  "collection": "amazon.aws",
  "content_type": "module",
  "content_type_label": "Module",
  "deprecation": null,
  "description": "Lists S3 buckets and details about those buckets.\n\nPrior to release 5.0.0 this module was called community.aws.aws_s3_bucket_info. The usage did not change.",
  "examples": "# Lists all S3 buckets\n- amazon.aws.s3_bucket_info:\n  register: result",
  "full_name": "amazon.aws.s3_bucket_info",
  "name": "s3_bucket_info",
  "notes": [
    "Caution: For modules, environment variables and configuration files are read from the Ansible 'host' context and not the 'controller' context."
  ],
  "option_count": 14,
  "options": [
    {
      "aliases": [
        "aws_access_key_id",
        "aws_access_key"
      ],
      "choices": [],
      "default": null,
      "description": "AWS access key ID.\n\nThe AWS_ACCESS_KEY_ID or AWS_ACCESS_KEY environment variables may also be used in decreasing order of preference.",
      "elements": null,
      "name": "access_key",
      "required": false,
      "suboptions": [],
      "type": "str",
      "version_added": null
    },
    {
      "aliases": [],
      "choices": [],
      "default": null,
      "description": "A dictionary to modify the botocore configuration.",
      "elements": null,
      "name": "aws_config",
      "required": false,
      "suboptions": [],
      "type": "dict",
      "version_added": null
    }
  ],
  "required_options": [],
  "requirements": [
    "python >= 3.6",
    "boto3 >= 1.38.23",
    "botocore >= 1.38.23"
  ],
  "return_values": [
    {
      "description": "A list of S3 buckets.",
      "name": "buckets",
      "returned": "always",
      "sample": null,
      "type": "complex"
    }
  ],
  "short_description": "Lists S3 buckets in AWS",
  "summary": "amazon.aws.s3_bucket_info (module, amazon.aws 12.0.0): Lists S3 buckets in AWS. 14 options (none required).",
  "url": "https://galaxy.ansible.com/ui/repo/published/amazon/aws/content/module/s3_bucket_info/",
  "version": "12.0.0",
  "version_added": "1.0.0"
}

Get a namespace

Get a namespace and the collections it publishes, with each one's latest version and downloads, plus its company, description and links.

Inputs

NamespacenamespacetextRequired
The namespace's name, like community or amazon, or the address of its page on galaxy.ansible.com.

Outputs

avatar_urltext
Its logo.
collection_countnumber
How many collections it publishes.
collectionslist
The collections it publishes, by name (up to 100).
companytext
The company or person behind it.
descriptiontext
What it says about itself.
linkslist
The links it lists.
nametext
The namespace's name, e.g. community.
summarytext
One sentence saying what came back, for a message or a log.
total_downloadsnumber
Downloads of the listed collections, together.
urltext
Its page on galaxy.ansible.com.
Example output
{
  "avatar_url": "https://galaxy.ansible.com/api/pulp/api/v3/content/ansible/namespaces/0191278f-3a63-771c-9793-0313c4951790/avatar/",
  "collection_count": 2,
  "collections": [
    {
      "collection": "companieshouse.general",
      "deprecated": false,
      "download_count": 4395,
      "last_updated_at": "2026-07-03T09:40:28Z",
      "latest_version": "1.2.4",
      "name": "general",
      "url": "https://galaxy.ansible.com/ui/repo/published/companieshouse/general/"
    },
    {
      "collection": "companieshouse.security",
      "deprecated": false,
      "download_count": 4316,
      "last_updated_at": "2026-10-23T10:03:11Z",
      "latest_version": "1.0.22",
      "name": "security",
      "url": "https://galaxy.ansible.com/ui/repo/published/companieshouse/security/"
    }
  ],
  "company": "Companies House",
  "description": "Companies House is an executive agency, sponsored by the Department for Business and Trade.",
  "links": [
    {
      "name": "main",
      "url": "https://www.gov.uk/government/organisations/companies-house"
    }
  ],
  "name": "companieshouse",
  "summary": "The companieshouse namespace (Companies House) publishes 2 collections, downloaded 8,711 times in all.",
  "total_downloads": 8711,
  "url": "https://galaxy.ansible.com/ui/namespaces/companieshouse/"
}

Get a role

Get a standalone role: what it does, its latest version, downloads, tags, the roles it depends on, and the GitHub repository and commit it was last imported from.

Inputs

RoleroletextRequired
The role as namespace.name, like geerlingguy.docker, the address of its page on galaxy.ansible.com, or Galaxy's number for it. Search roles finds all three.

Outputs

committext
The commit Galaxy last imported.
commit_messagetext
That commit's message.
created_attext
When it was added to Galaxy.
dependencieslist
The roles it needs, as namespace.name.
descriptiontext
What it does, in its author's words.
download_countnumber
How many times it has been downloaded.
github_branchtext
The branch Galaxy imports.
github_repotext
The GitHub repository it comes from.
github_usertext
The GitHub account it comes from.
idnumber
Galaxy's number for the role.
imported_attext
When Galaxy last imported it.
install_commandtext
The command that installs it, e.g. ansible-galaxy role install geerlingguy.docker.
latest_versiontext
Its latest version.
nametext
Its name, e.g. docker.
namespacetext
Who publishes it, e.g. geerlingguy.
repository_urltext
The GitHub repository it is built from.
roletext
The role as namespace.name, e.g. geerlingguy.docker.
summarytext
One sentence saying what came back, for a message or a log.
tagslist
Its tags, e.g. docker or web.
updated_attext
When Galaxy last updated it.
urltext
Its page on galaxy.ansible.com.
Example output
{
  "commit": "1d3968dbf0df48515ffda0f6561cbd25206f502a",
  "commit_message": "Merge pull request #534 from hollow/no-nightly\n\nRemove broken nightly repo",
  "created_at": "2023-05-08T20:49:45Z",
  "dependencies": [],
  "description": "Docker for Linux.",
  "download_count": 30319806,
  "github_branch": "master",
  "github_repo": "ansible-role-docker",
  "github_user": "geerlingguy",
  "id": 10923,
  "imported_at": "2026-01-15T16:31:55Z",
  "install_command": "ansible-galaxy role install geerlingguy.docker",
  "latest_version": "8.0.0",
  "name": "docker",
  "namespace": "geerlingguy",
  "repository_url": "https://github.com/geerlingguy/ansible-role-docker",
  "role": "geerlingguy.docker",
  "summary": "geerlingguy.docker 8.0.0: Docker for Linux. Downloaded 30,319,806 times.",
  "tags": [
    "web",
    "system",
    "containers",
    "docker",
    "orchestration",
    "compose"
  ],
  "updated_at": "2026-01-15T16:31:56Z",
  "url": "https://galaxy.ansible.com/ui/standalone/roles/geerlingguy/docker/"
}

List a collection's content

List the modules, roles and plugins in a collection version, each with what it does in one line, optionally only one kind or names containing a word.

Inputs

CollectioncollectiontextRequired
The collection as namespace.name, like community.general, or the address of its page on galaxy.ansible.com. Search collections finds both.
Versionversiontext
Which version, picked from the list or typed. Empty for the latest.
Typecontent_typetext
Only modules, only roles, or one kind of plugin. Everything by default.One of: all (Everything), module, role, playbook, action (Action plugin), become (Become plugin), cache (Cache plugin), callback (Callback plugin), cliconf (Cliconf plugin), connection (Connection plugin), and 15 more. Default: all.
Name containsname_containstext
Only items whose name contains this, like s3 or user.

Outputs

collectiontext
The collection as namespace.name, e.g. community.general.
content_countslist
How many of each kind the version holds.
countnumber
How many match.
itemslist
The matching modules, roles and plugins.
summarytext
One sentence saying what came back, for a message or a log.
totalnumber
How many items the version holds in all.
versiontext
The version read.
Example output
{
  "collection": "amazon.aws",
  "content_counts": [
    {
      "content_type": "module",
      "count": 141,
      "label": "Modules"
    },
    {
      "content_type": "lookup",
      "count": 5,
      "label": "Lookup plugins"
    }
  ],
  "count": 2,
  "items": [
    {
      "content_type": "module",
      "content_type_label": "Module",
      "description": "Manage S3 buckets in AWS, DigitalOcean, Ceph, Walrus, FakeS3 and StorageGRID",
      "full_name": "amazon.aws.s3_bucket",
      "name": "s3_bucket",
      "url": "https://galaxy.ansible.com/ui/repo/published/amazon/aws/content/module/s3_bucket/"
    },
    {
      "content_type": "module",
      "content_type_label": "Module",
      "description": "Lists S3 buckets in AWS",
      "full_name": "amazon.aws.s3_bucket_info",
      "name": "s3_bucket_info",
      "url": "https://galaxy.ansible.com/ui/repo/published/amazon/aws/content/module/s3_bucket_info/"
    }
  ],
  "summary": "amazon.aws 12.0.0 holds 213 items; 2 modules with \"s3_bucket\" in the name.",
  "total": 213,
  "version": "12.0.0"
}

List a collection's versions

List the versions a collection has published, highest or newest first, with when each came out, the ansible-core versions it works with and the command that installs it.

Inputs

CollectioncollectiontextRequired
The collection as namespace.name, like community.general, or the address of its page on galaxy.ansible.com. Search collections finds both.
Ordersorttext
Highest version number first by default; most recently published first puts fixes to older lines (a 12.6.6 after 13.4.0) in the order they came out.One of: version (Highest version first), published (Most recently published first), oldest (Oldest first). Default: version.
Number of versionslimitnumber
How many versions to return on each page, 1 to 100. 20 by default.From 1 to 100. Default: 20.
Pagepagenumber
Which page of results, from 1: use next_page from the last one.At least 1. Default: 1.

Outputs

collectiontext
The collection as namespace.name, e.g. community.general.
countnumber
How many are on this page.
latest_versiontext
The collection's latest version.
nametext
Its name within the namespace, e.g. general.
namespacetext
The namespace that publishes it, e.g. community.
next_pagenumber
The Page value for the next page. Empty on the last page.
pagenumber
Which page this is, from 1.
summarytext
One sentence saying what came back, for a message or a log.
totalnumber
How many match in all.
versionslist
The versions on this page.
Example output
{
  "collection": "community.general",
  "count": 2,
  "latest_version": "13.5.0",
  "name": "general",
  "namespace": "community",
  "next_page": 2,
  "page": 1,
  "summary": "community.general has 243 versions; showing 1 to 2, highest version first. Latest: 13.5.0.",
  "total": 243,
  "versions": [
    {
      "install_command": "ansible-galaxy collection install community.general:==13.5.0",
      "is_latest": true,
      "published_at": "2026-10-05T17:30:02Z",
      "requires_ansible": ">=2.18.0",
      "url": "https://galaxy.ansible.com/ui/repo/published/community/general/?version=13.5.0",
      "version": "13.5.0"
    },
    {
      "install_command": "ansible-galaxy collection install community.general:==13.4.0",
      "is_latest": false,
      "published_at": "2026-09-07T20:10:28Z",
      "requires_ansible": ">=2.18.0",
      "url": "https://galaxy.ansible.com/ui/repo/published/community/general/?version=13.4.0",
      "version": "13.4.0"
    }
  ]
}

List a role's versions

List the versions a standalone role has released, newest first, with when each was tagged and where to download it.

Inputs

RoleroletextRequired
The role as namespace.name, like geerlingguy.docker, the address of its page on galaxy.ansible.com, or Galaxy's number for it. Search roles finds all three.
Number of versionslimitnumber
How many versions to return, newest first, 1 to 500. 20 by default.From 1 to 500. Default: 20.

Outputs

countnumber
How many are listed.
idnumber
Galaxy's number for the role.
latest_versiontext
Its latest version.
roletext
The role as namespace.name.
summarytext
One sentence saying what came back, for a message or a log.
totalnumber
How many versions it has in all.
versionslist
The versions, newest first.
Example output
{
  "count": 2,
  "id": 10923,
  "latest_version": "8.0.0",
  "role": "geerlingguy.docker",
  "summary": "geerlingguy.docker has 81 versions; showing the newest 2. Latest: 8.0.0.",
  "total": 81,
  "versions": [
    {
      "added_at": "2026-01-15T16:31:55Z",
      "download_url": "https://github.com/geerlingguy/ansible-role-docker/archive/8.0.0.tar.gz",
      "is_latest": true,
      "released_at": "2026-01-15T16:31:08Z",
      "version": "8.0.0"
    },
    {
      "added_at": "2025-12-01T21:52:20Z",
      "download_url": "https://github.com/geerlingguy/ansible-role-docker/archive/7.9.0.tar.gz",
      "is_latest": false,
      "released_at": "2025-11-28T05:17:17Z",
      "version": "7.9.0"
    }
  ]
}

Search collections

Find Ansible collections on Galaxy by words, namespace and tags, or the ones that depend on a collection, each with its latest version, description, tags, dependencies and the ansible-core versions it works with.

Inputs

Search forkeywordstext
Words to look for in collections' names, descriptions, tags and contents, e.g. postgresql or windows firewall.
Namespacenamespacetext
Only collections from this namespace, like community or cisco.
Tagstagstext
Only collections with every one of these tags, like cloud or networking. Separate several with commas.
Depends ondepends_ontext
Only collections that need this one, as namespace.name, like amazon.aws: who builds on it.
Deprecated collectionsdeprecatedtext
Leave out the collections their publishers have deprecated, or not.One of: hide (Leave deprecated collections out), include (Include deprecated collections), only (Only deprecated collections). Default: hide.
Ordersorttext
Best match first by default (newest first when nothing is searched for).One of: relevance (Best match first), updated (Most recently updated first), name (By name, A to Z), namespace (By namespace, A to Z). Default: relevance.
Number of collectionslimitnumber
How many collections to return on each page, 1 to 100. 20 by default.From 1 to 100. Default: 20.
Pagepagenumber
Which page of results, from 1: use next_page from the last one.At least 1. Default: 1.

Outputs

collectionslist
The collections on this page.
countnumber
How many are on this page.
next_pagenumber
The Page value for the next page. Empty on the last page.
pagenumber
Which page this is, from 1.
summarytext
One sentence saying what came back, for a message or a log.
totalnumber
How many match in all.
Example output
{
  "collections": [
    {
      "collection": "amazon.aws",
      "dependencies": [],
      "deprecated": false,
      "description": "A variety of Ansible content to help automate the management of AWS services.",
      "install_command": "ansible-galaxy collection install amazon.aws",
      "name": "aws",
      "namespace": "amazon",
      "published_at": "2026-10-13T20:50:17Z",
      "publisher": null,
      "requires_ansible": ">=2.18.0",
      "tags": [
        "amazon",
        "aws",
        "cloud"
      ],
      "url": "https://galaxy.ansible.com/ui/repo/published/amazon/aws/",
      "version": "12.0.0"
    },
    {
      "collection": "amazon.cloud",
      "dependencies": [
        {
          "collection": "amazon.aws",
          "version_range": ">=6.0.0"
        },
        {
          "collection": "community.aws",
          "version_range": ">=5.3.0"
        }
      ],
      "deprecated": false,
      "description": null,
      "install_command": "ansible-galaxy collection install amazon.cloud",
      "name": "cloud",
      "namespace": "amazon",
      "published_at": "2023-07-02T22:14:25Z",
      "publisher": null,
      "requires_ansible": ">=2.12.0",
      "tags": [
        "amazon",
        "cloud",
        "aws"
      ],
      "url": "https://galaxy.ansible.com/ui/repo/published/amazon/cloud/",
      "version": "0.4.0"
    }
  ],
  "count": 2,
  "next_page": null,
  "page": 1,
  "summary": "Found 2 collections matching \"aws\" in amazon; showing 1 to 2, best match first.",
  "total": 2
}

Search namespaces

Find the namespaces that publish collections on Galaxy, by name or company, with each one's company, description and logo.

Inputs

Search forkeywordstext
Words to look for in namespaces' names and companies, e.g. cisco.
Ordersorttext
By name, A to Z, by default.One of: name (By name, A to Z), company (By company, A to Z), newest (Newest first). Default: name.
Number of namespaceslimitnumber
How many namespaces to return on each page, 1 to 100. 20 by default.From 1 to 100. Default: 20.
Pagepagenumber
Which page of results, from 1: use next_page from the last one.At least 1. Default: 1.

Outputs

countnumber
How many are on this page.
namespaceslist
The namespaces on this page.
next_pagenumber
The Page value for the next page. Empty on the last page.
pagenumber
Which page this is, from 1.
summarytext
One sentence saying what came back, for a message or a log.
totalnumber
How many match in all.
Example output
{
  "count": 2,
  "namespaces": [
    {
      "avatar_url": null,
      "company": null,
      "description": null,
      "name": "amazon",
      "url": "https://galaxy.ansible.com/ui/namespaces/amazon/"
    },
    {
      "avatar_url": "https://galaxy.ansible.com/api/pulp/api/v3/content/ansible/namespaces/018d19ff-4d5e-7226-bcbb-d0e672d3ec76/avatar/",
      "company": "Amazon Web Services, Inc.",
      "description": "David Duncan",
      "name": "davdunc",
      "url": "https://galaxy.ansible.com/ui/namespaces/davdunc/"
    }
  ],
  "next_page": 2,
  "page": 1,
  "summary": "Found 3 namespaces matching \"amazon\"; showing 1 to 2, by name, A to Z.",
  "total": 3
}

Search roles

Find standalone Ansible roles on Galaxy by a word, author or tag, most downloaded first, with each one's latest version, downloads and GitHub repository.

Inputs

Search forkeywordstext
A word to look for in roles' names, authors and descriptions, e.g. nginx.
Namespacenamespacetext
Only roles by this author, like geerlingguy.
Tagtagtext
Only roles with this tag, like web or database.
Ordersorttext
Most downloaded first by default.One of: downloads (Most downloaded first), updated (Most recently updated first), newest (Newest first), name (By name, A to Z). Default: downloads.
Number of roleslimitnumber
How many roles to return on each page, 1 to 100. 20 by default.From 1 to 100. Default: 20.
Pagepagenumber
Which page of results, from 1: use next_page from the last one.At least 1. Default: 1.

Outputs

countnumber
How many are on this page.
next_pagenumber
The Page value for the next page. Empty on the last page.
pagenumber
Which page this is, from 1.
roleslist
The roles on this page.
summarytext
One sentence saying what came back, for a message or a log.
totalnumber
How many match in all.
Example output
{
  "count": 2,
  "next_page": null,
  "page": 1,
  "roles": [
    {
      "created_at": "2023-05-08T20:49:45Z",
      "description": "Docker for Linux.",
      "download_count": 30319806,
      "id": 10923,
      "install_command": "ansible-galaxy role install geerlingguy.docker",
      "latest_version": "8.0.0",
      "name": "docker",
      "namespace": "geerlingguy",
      "repository_url": "https://github.com/geerlingguy/ansible-role-docker",
      "role": "geerlingguy.docker",
      "tags": [
        "web",
        "system",
        "containers",
        "docker",
        "orchestration",
        "compose"
      ],
      "updated_at": "2026-01-15T16:31:56Z",
      "url": "https://galaxy.ansible.com/ui/standalone/roles/geerlingguy/docker/"
    },
    {
      "created_at": "2023-05-08T20:49:45Z",
      "description": "Docker setup for Rasbperry Pi and ARM-based devices.",
      "download_count": 376509,
      "id": 10924,
      "install_command": "ansible-galaxy role install geerlingguy.docker_arm",
      "latest_version": "5.0.0",
      "name": "docker_arm",
      "namespace": "geerlingguy",
      "repository_url": "https://github.com/geerlingguy/ansible-role-docker_arm",
      "role": "geerlingguy.docker_arm",
      "tags": [
        "arm",
        "containers",
        "docker",
        "pi",
        "raspberry",
        "system"
      ],
      "updated_at": "2023-10-29T18:45:22Z",
      "url": "https://galaxy.ansible.com/ui/standalone/roles/geerlingguy/docker_arm/"
    }
  ],
  "summary": "Found 2 roles matching \"docker\" by geerlingguy; showing 1 to 2, most downloaded first.",
  "total": 2
}

On this page