quipucordsctl is a management tool that you can use to install and configure Quipucords and all of its required components to run in Podman containers on your local system.
Important
Installing the quipucordsctl RPM itself requires sudo or elevated root privileges, but all other commands for installing and interacting with Quipucords through the quipucordsctl program should be executed as a regular non-root user. If you install and run Quipucords as root, expect no support from the maintainers.
To prepare quipucordsctl:
sudo dnf copr enable -y @quipucords/quipucordsctl
sudo dnf install -y quipucordsctlTo install, configure, and start Quipucords:
quipucordsctl install
podman login registry.redhat.io # REQUIRED before starting quipucords-app
systemctl --user start quipucords-appA few seconds later, you may access Quipucords on https://localhost:9443
If you want to access Quipucords from systems outside of localhost, you may need to add a rule to allow access through the firewall:
sudo firewall-cmd --permanent --add-port=9443/tcp # optional if you want external access
sudo firewall-cmd --reload # optional if you want external accessNote: If you use AI tools to generate code, please review our Policy for AI-Generated Code for disclosure and quality requirements.
git clone [email protected]:quipucords/quipucordsctl.git quipucordsctl
cd quipucordsctl
uv sync
uv run ruff check
uv run ruff format --check
uv run pytest# export strings to template
uv run bin/translations.py extract
# update each language-specific po file
uv run bin/translations.py update
# compile binary mo file(s) after filling out all po file(s)
uv run bin/translations.py compileuv run python -m quipucordsctl --helpuv tool uninstall quipucordsctl
uv tool install --no-cache --from . quipucordsctl
quipucordsctl --helpYou can override the locale using LC_MESSAGES, LC_ALL, LANGUAGE, or LANG.
# when running directly from source
LANG=pt uv run python -m quipucordsctl --help
# when running installed
LANG=pt quipucordsctl --help