acr-browser is a terminal-based user interface for managing container images and artifacts in Azure Container Registry.
This project owes a huge debt of gratitude to the fantastic Azure Key Vault Browser, from which it is forked, and of course, to the underlying technologies that make both of these projects possible: textual and rich!
acr-browser requires Python 3.9 or later.
pip install acr-browser
Once the app is installed you can run the application from your terminal with the
Alternatively, you can run with Docker:
docker run --rm -it --volume $HOME:/app --volume $HOME/.azure:/root/.azure ghcr.io/samdobson/acr-browser:latest
acr-browser uses the Azure CLI for authentication. Before using the app, make sure that you have logged in and set your subscription.
az login az account set --subscription "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx"
On first run you will be asked for some information so that the app can build your configuration file.
You’ll need to enter a valid Azure Container Registry name.
Alternatively you can create a config file at
# .acr-browser.toml registry = ""
This project has been tested on macOS and Linux with Python 3.9.
For Ubuntu 20.04, it may be necessary to install the
If you would like to contribute to
acr-browser head over to the contributing guide to find out more.