derivative-update - Source Code Updater

Kicksecure ™

Download

On Computer USB Installation Intel / AMD64 ARM64 Raspberry Pi PPC64 Windows (VM) Mac Linux (VM) VirtualBox (VM) Qubes (VM) KVM (VM) Debian morph to Kicksecure More options Source Code

About

Overview Features Why Open Source? Project Activities Contributors Mission & Vision

Docs

Documentation FAQ Troubleshooting

Community

Forums Forum Best Practices Contribute

Support

Self Support First Policy Search Engines, Docs and AI Support (Limited) Reporting Bugs Contact (Restricted)

Tools Upload file Special pages Recent changes Print Version Page meta What links here Related changes Page information

Page Read Edit History Move Protection Unwatch Watch Delete Purge

User Preferences Watchlist Contributions Logout Create account Login

Donate

• Derivative-Maker Image Builder
• Build Kicksecure from Source Code Overview
• Build Kicksecure Images from Source
• Source Code Updater (derivative-update)
• Upgrading Kicksecure from Source
• Build Configuration
• Expected Build Warnings

derivative-update is a secure command-line tool for updating a derivative-maker Git repository and its submodules. It supports updating to specific signed commits, branches, or tags with verification, submodule synchronization, and rollback protection in case of errors. This tool ensures a consistent, trusted codebase.

Purpose:

derivative-update safely updates a derivative-maker Git repository (and its submodules) to a specific signed commit, branch, or tag, while verifying integrity and rolling back on errors.

Key functions:

• Checks environment: Ensures it is not run as root and that the repository is clean unless explicitly allowed to have uncommitted changes.
• Performs safety checks: Runs Git sanity test to verify repository state and digital software signatures.
• Fetches updates: Retrieves latest changes from remote repository and submodules.
• Handles tag updates: Verifies and checks out the tag, then updates submodules.
• Handles branch updates: Checks out the branch, fast-forwards to upstream, verifies commit, and updates submodules.
• Submodule synchronization: Ensures submodule URLs match .gitmodules and updates them to recorded commits.
• Error recovery: If verification or updates fail, resets repository to a known good commit.
• Final checks: Ensures no unexpected uncommitted changes remain and runs git describe for informational purposes.

Usage:

derivative-update can be found in the root of derivative-maker source code folder.

Example. To update to the latest signed git tag.

./derivative-update --tag latest

Options:

• Parses update options: Supports:
  • --tag <tag> → Move to a specific signed tag
  • --tag latest → Move to the latest signed tag
  • --ref <ref> → Move to a specific commit or branch
  • --update-only → Only update submodules

Summary:

derivative-update safely updates code and submodules to the requested state with verification and rollback protection.

Kicksecure A secure by default operating system with the latest security research in place.

Dark mode

Follow us on social media

Supported by Power Up Privacy

Kicksecure is proudly supported until 2026 by Power Up Privacy, a privacy advocacy group that seeks to supercharge privacy projects with resources so they can complete their mission of making our world a better place. (Strictly subject to our sponsorship policy.)

At Kicksecure we value freedom and trust, supporting Open Source and Freedom Software

By using this website, you acknowledge you have read, understood, and agree to be bound by these agreements: Terms of Service, Privacy Policy, Cookie Policy, E-Sign Consent, DMCA, Imprint 2012- 2025 ENCRYPTED SUPPORT LLC

Your support makes
all the difference!

We believe security software like Kicksecure needs to remain Open Source and independent. Would you help sustain and grow the project? Learn more about our 13 year success story and maybe DONATE!