flatpak_remote – Manage flatpak repository remotes

New in version 2.6.

Synopsis

  • Allows users to add or remove flatpak remotes.
  • The flatpak remotes concept is comparable to what is called repositories in other packaging formats.
  • Currently, remote addition is only supported via flatpakrepo file URLs.
  • Existing remotes will not be updated.
  • See the flatpak module for managing flatpaks.

Requirements

The below requirements are needed on the host that executes this module.

  • flatpak

Parameters

Parameter Choices/Defaults Comments
executable
-
Default:
"flatpak"
The path to the flatpak executable to use.
By default, this module looks for the flatpak executable on the path.
flatpakrepo_url
-
The URL to the flatpakrepo file representing the repository remote to add.
When used with state=present, the flatpak remote specified under the flatpakrepo_url is added using the specified installation method.
When used with state=absent, this is not required.
Required when state=present.
method
-
    Choices:
  • system ←
  • user
The installation method to use.
Defines if the flatpak is supposed to be installed globally for the whole system or only for the current user.
name
- / required
The desired name for the flatpak remote to be registered under on the managed host.
When used with state=present, the remote will be added to the managed host under the specified name.
When used with state=absent the remote with that name will be removed.
state
-
    Choices:
  • absent
  • present ←
Indicates the desired package state.

Examples

- name: Add the Gnome flatpak remote to the system installation
  flatpak_remote:
    name: gnome
    state: present
    flatpakrepo_url: https://sdk.gnome.org/gnome-apps.flatpakrepo

- name: Add the flathub flatpak repository remote to the user installation
  flatpak_remote:
    name: flathub
    state: present
    flatpakrepo_url: https://dl.flathub.org/repo/flathub.flatpakrepo
    method: user

- name: Remove the Gnome flatpak remote from the user installation
  flatpak_remote:
    name: gnome
    state: absent
    method: user

- name: Remove the flathub remote from the system installation
  flatpak_remote:
    name: flathub
    state: absent

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
command
string
When a flatpak command has been executed
The exact flatpak command that was executed

Sample:
/usr/bin/flatpak remote-add --system flatpak-test https://dl.flathub.org/repo/flathub.flatpakrepo
msg
string
failure
Module error message

Sample:
Executable '/usr/local/bin/flatpak' was not found on the system.
rc
integer
When a flatpak command has been executed
Return code from flatpak binary

stderr
string
When a flatpak command has been executed
Error output from flatpak binary

Sample:
error: GPG verification enabled, but no summary found (check that the configured URL in remote config is correct)
stdout
string
When a flatpak command has been executed
Output from flatpak binary

Sample:
flathub Flathub https://dl.flathub.org/repo/ 1


Status

Authors

  • John Kwiatkoski (@JayKayy)
  • Alexander Bethke (@oolongbrothers)

Hint

If you notice any issues in this documentation you can edit this document to improve it.