{"id":46984450,"url":"https://github.com/asdf-community/asdf-odo","last_synced_at":"2026-03-11T13:31:05.882Z","repository":{"id":38400274,"uuid":"468929537","full_name":"asdf-community/asdf-odo","owner":"asdf-community","description":"asdf version manager plugin for odo, the developer-focused CLI for fast and iterative application development on Podman, Kubernetes and OpenShift [maintainer=@rm3l]","archived":false,"fork":false,"pushed_at":"2025-12-05T12:52:55.000Z","size":179,"stargazers_count":6,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-08T23:21:46.060Z","etag":null,"topics":["application-development","asdf","asdf-plugin","developer-tools","kubernetes","odo","openshift","podman"],"latest_commit_sha":null,"homepage":"https://odo.dev","language":"Shell","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/asdf-community.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"contributing.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","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},"funding":{"github":["smorimoto"]}},"created_at":"2022-03-11T23:31:33.000Z","updated_at":"2025-12-05T12:52:58.000Z","dependencies_parsed_at":"2023-02-12T11:31:29.166Z","dependency_job_id":"30a22029-016f-4813-a911-af428e564232","html_url":"https://github.com/asdf-community/asdf-odo","commit_stats":null,"previous_names":["asdf-community/asdf-odo"],"tags_count":11,"template":false,"template_full_name":"asdf-vm/asdf-plugin-template","purl":"pkg:github/asdf-community/asdf-odo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asdf-community%2Fasdf-odo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asdf-community%2Fasdf-odo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asdf-community%2Fasdf-odo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asdf-community%2Fasdf-odo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/asdf-community","download_url":"https://codeload.github.com/asdf-community/asdf-odo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asdf-community%2Fasdf-odo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30382673,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-11T12:49:11.341Z","status":"ssl_error","status_checked_at":"2026-03-11T12:46:41.342Z","response_time":84,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6: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":["application-development","asdf","asdf-plugin","developer-tools","kubernetes","odo","openshift","podman"],"created_at":"2026-03-11T13:31:05.742Z","updated_at":"2026-03-11T13:31:05.873Z","avatar_url":"https://github.com/asdf-community.png","language":"Shell","funding_links":["https://github.com/sponsors/smorimoto"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# asdf-odo [![Build](https://github.com/asdf-community/asdf-odo/actions/workflows/build.yml/badge.svg)](https://github.com/asdf-community/asdf-odo/actions/workflows/build.yml) [![Lint](https://github.com/asdf-community/asdf-odo/actions/workflows/lint.yml/badge.svg)](https://github.com/asdf-community/asdf-odo/actions/workflows/lint.yml)\n\n\n[asdf](https://asdf-vm.com) plugin for managing runtime versions of [odo](https://odo.dev), the developer-focused CLI for fast \u0026 iterative container-based application development on [Podman](https://podman.io/), [OpenShift](https://www.redhat.com/en/technologies/cloud-computing/openshift) and [Kubernetes](https://kubernetes.io/).\n\n\u003c/div\u003e\n\n# Contents\n\n- [Dependencies](#dependencies)\n- [Install](#install)\n- [Additional commands](#additional-commands)\n- [FAQ](#FAQ)\n- [Contributing](#contributing)\n- [License](#license)\n\n# Dependencies\n\n- **Required**: `bash`, `awk`, `curl`, `shasum`\n- **Optional**: `unzip` and [Golang](https://go.dev/doc/install) if you want to install unreleased development branches or specific commits. You may want to install Golang using this other asdf plugin: [asdf-golang](https://github.com/kennyp/asdf-golang) ;)\n\n# Install\n\nYou first need to install and configure [asdf](https://asdf-vm.com/guide/getting-started.html#_1-install-dependencies).\n\nAfter that, you can install this plugin:\n\n```shell\n# The command below works because this plugin is referenced\n# in the central plugins repository: https://github.com/asdf-vm/asdf-plugins\nasdf plugin add odo\n```\n\nor using the full repo URL:\n\n```shell\nasdf plugin add odo https://github.com/asdf-community/asdf-odo.git\n```\n\nTo check that the plugin is installed correctly and to manage versions of `odo`:\n\n```shell\n# Show all installable versions\nasdf list-all odo\n\n# Install latest version\nasdf install odo latest\n\n# Set a version globally (on your ~/.tool-versions file)\nasdf global odo latest\n\n# Set a version depending on the project directory.\n# Note that this creates a file named '.tool-versions' in the current directory.\n# You may want to put that file under version control.\nasdf local odo latest\n\n# Now odo commands are available\nodo version\nodo help\n# You can also run: asdf exec odo -- [odo_options]\n```\n\nCheck [asdf](https://github.com/asdf-vm/asdf) README for more instructions on how to\ninstall \u0026 manage versions.\n\n# Additional commands\n\nThis plugin defines additional `asdf` commands with helpers that extend `odo`.\n\n## Settings management\n\nThis is availabe via the `asdf odo settings` command:\n\n```sh\nasdf odo settings COMMAND\n\nCOMMANDS\n   which    -   Shows the path to the file where the current odo stores its settings.\n   reset    -   Resets the odo settings to their default values.\n                This essentially removes the current settings file,\n                so subsequent odo commands can recreate it.\n   help     -   Shows this help.\n\n```\n\nNOTE:  `odo` already comes bundled with a [`preference` command](https://odo.dev/docs/command-reference/preference), but the additional commands defined here aim at extending it a little bit.\n\n# FAQ\n\n## How do I install specific releases of odo?\n\nYou can first list all installable versions (actually, all Git tags from the [upstream repository](https://github.com/redhat-developer/odo)) with:\n```shell\nasdf list-all odo\n```\n\nNow you can pick and install any version from the list above:\n```shell\nasdf install odo \u003cversion\u003e\n```\n\n## How do I install nightly releases of odo?\n\nRun the command below:\n```shell\nasdf install odo ref:nightly\n```\n\n## How do I install odo from specific (unreleased) Git commits or branches?\n\nNOTE: This will download and build `odo` on your machine. Make sure you installed these optional [dependencies](README.md#dependencies), besides the mandatory ones: `unzip`, `git`, [Golang](https://go.dev/doc/install) and `make`.\nYou may want to install Golang using this other plugin for `asdf`: [asdf-golang](https://github.com/kennyp/asdf-golang)\n\n### Using the upstream `odo` repo\n```shell\nasdf install odo ref:\u003ccommit_or_branch\u003e\n```\n\n### Using a different fork repo on GitHub\nYou need to set the `ASDF_GITHUB_REPO_FOR_ODO` environment variable beforehand. It can either be a complete GitHub HTTPS URL, or formatted as follows: `\u003corg_or_user\u003e/\u003crepo\u003e`.\n\n```shell\nASDF_GITHUB_REPO_FOR_ODO=\u003corg_or_user\u003e/\u003crepo\u003e \\\n  asdf install odo ref:\u003ccommit_or_branch\u003e\n```\n\nOr:\n\n```shell\nASDF_GITHUB_REPO_FOR_ODO=https://github.com/\u003corg_or_user\u003e/\u003crepo\u003e \\\n  asdf install odo ref:\u003ccommit_or_branch\u003e\n```\n\n## Can I override the binary architecture?\n\nThe following environment variables can be used to override the `odo` binary that will get downloaded by this plugin.\nPlease refer to the [artifacts listing page](https://developers.redhat.com/content-gateway/rest/mirror/pub/openshift-v4/clients/odo) for more info about the supported platforms and architectures.\n\n- `ASDF_ODO_BINARY_OS_ARCH`. Defines both the operating system and architecture for the binary. Must follow this pattern: `\u003cplatform\u003e-\u003carchitecture\u003e`. Examples: `darwin-amd64`, `linux-s390x`\n- `ASDF_ODO_BINARY_OS`. Defines the operating system for the binary. In this case, the plugin will attempt to determine the right architecture. Examples: `darwin`, `windows`, `linux`\n- `ASDF_ODO_BINARY_ARCH`. Defines the architecture for the binary. In this case, the plugin will attempt to determine the right operating system. Examples: `arm64`, `s390x`, `amd64`, ...\n\nNote that, if defined, `ASDF_ODO_BINARY_OS_ARCH` always take precedence over the other two environment variables.\n\nExamples:\n\n```shell\n# ASDF_ODO_BINARY_OS_ARCH allows to override both the operation system and architecture to use\nASDF_ODO_BINARY_OS_ARCH=darwin-amd64 asdf install odo latest\n```\n\nor\n\n```shell\n# The architecture will be determined automatically\nASDF_ODO_BINARY_OS=windows asdf install odo latest\n```\n\nor\n\n```shell\n# The operating system will be determined automatically\nASDF_ODO_BINARY_ARCH=arm64 asdf install odo latest\n```\n\n## How do I uninstall a given version of odo?\n\nFirst of all, you can list all installed versions of `odo`, like so:\n```shell\nasdf list odo\n```\n\nYou can now uninstall any version listed above, like so:\n```shell\nasdf uninstall odo \u003cversion\u003e\n```\n\n## How do I reinstall an already installed version of odo?\nBecause of the way `asdf` works (by enforcing exact versions), if you installed odo from a development branch (or a nightly release) and wish to update it, you need to reinstall that specific version.\nTo reinstall an already installed version of odo, first [uninstall it](README.md#how-do-i-uninstall-a-given-version-of-odo), and then [install it](README.md#install) again.\n\n`latest` is a special version number that `asdf` dynamically resolves to the latest known version at the time of execution. So running `asdf install odo latest` might install a newer version of `odo`, if a newer version is available at the time the command is executed.\n\n## Can I use this plugin on Windows?\nNot officially supported :)\n\n`asdf` itself does not support Windows officially, per [their FAQ](http://asdf-vm.com/learn-more/faq.html#faq).\nRunning it on [Windows Subsystem for Linux (WSL) 2](https://docs.microsoft.com/en-us/windows/wsl/about) should work however, as written in [this blog](https://www.joshfinnie.com/blog/setting_up_wsl_with_asdf/). But this is not tested/supported.\n\nSo if you already have `asdf` running on `WSL 2`, you should be able to use this plugin as well.\n\n## How do I know what this plugin really does?\n\nSet the `ASDF_ODO_VERBOSE` environment variable to `true` prior to running this plugin,\nand you will be able to get more detailed information. For example:\n\n```shell\nASDF_ODO_VERBOSE=true asdf install odo 3.0.0\n```\n\n# Contributing\n\nContributions of any kind are welcome! See the [contributing guide](contributing.md).\n\n[Thanks to these contributors](https://github.com/asdf-community/asdf-odo/graphs/contributors)!\n\n# License\n\nSee [MIT License](LICENSE) © [Armel Soro](https://github.com/rm3l/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasdf-community%2Fasdf-odo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fasdf-community%2Fasdf-odo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasdf-community%2Fasdf-odo/lists"}