Skip to main content

OctoShoom

Automated Joomla! Update Server Hash Injector

With this script, you can easily deploy docker containers of Joomla and Openssh. The combination of these tools gives rise to a powerful and very secure shared development environment.
SHA-512 Automated
Git Compatible
JSON Config Driven
CLI Power Tool

Automate your Joomla update workflow like a pro.

OctoShoom scans your update XMLs, hashes every package, injects secure SHA-512 tags, and commits changes — all from a single config.
No manual CLI work.No guesswork.

Getting Started

Install OctoShoom
sudo curl -L ".../octoshoom" -o /usr/local/bin/octoshoom
sudo chmod +x /usr/local/bin/octoshoom
Configure
{
  "update_servers": [
    {
      "owner": "namespace",
      "repo": "repository-name",
      "branch": "main",
      "path": "component_updates.xml"
    }
  ]
}
Set Environment
GIT_AUTHOR_NAME
GIT_AUTHOR_EMAIL
GIT_URL
Run
octoshoom --env="/path/.env" --config="/path/update_servers.json"

Help Menu

octoshoom -h

Example Run

octoshoom --env="$HOME/.config/octoshoom/.env" --config="$HOME/.config/octoshoom/update_servers.json"

Uninstall

sudo rm -f /usr/local/bin/octoshoom

How it Works

1. Connect

  • Clone repository (shallow)
  • Checkout branch
  • Locate XML file

2. Process

  • Parse update XML
  • Download ZIP files
  • Generate SHA-512 hashes

3. Deploy

  • Insert / replace sha512
  • Commit changes
  • Push via SSH
  • Remove temporary clone

Automated Hash Generation

No more manual hash calculations - OctoShoom does it for you.

Self-Updating XML

Automatically injects revised sha512 tags into your update servers.

Git via SSH

Securely clones, commits, and pushes changes using SSH keys.

JSON-Driven Config

Define all targets in one config file - repeatable & shareable.
Stop spending hours updating hashes — let automation do it for you.
  • Save time
  • Eliminate errors
  • Consistent releases

OctoShoom is ready to streamline your Joomla update workflow — start automating today.