Skip to content

Releases: trilitech/octez-manager

v0.3.0

11 Feb 13:30

Choose a tag to compare

octez-manager v0.3.0

This release brings major new features for RPC interaction, web-based access, improved stability, and extensive code quality improvements.

🎯 Highlights

Interactive RPC Browser

Press r in the TUI to explore your node's RPC endpoints interactively:

  • Navigate the endpoint tree with cursor keys
  • JSON syntax highlighting for responses
  • Real-time streaming for monitor endpoints (e.g., /monitor/heads/main)
  • Quick shortcuts (1-5) for common endpoints
  • Query any managed node via Tab key

Web Interface

Access octez-manager from your browser with octez-manager web:

  • Full terminal interface via xterm.js over WebSocket
  • Controller and viewer roles with optional password auth
  • Perfect for remote server management

RPC CLI Tools

New octez-manager rpc commands for scripting and automation:

  • rpc get -i INSTANCE PATH - Execute GET requests
  • rpc list -i INSTANCE [PATH] - List available endpoints
  • rpc interactive -i INSTANCE - Interactive mode with tab completion

✨ New Features

  • Update notifications: TUI shows when new octez-manager versions are available
  • Streaming RPC support: Monitor endpoints now display live-updating content
  • Better form navigation: Tab/Shift+Tab to cycle between fields
  • Architecture tools: Code health tracking with arch_index and arch_query

🐛 Bug Fixes

  • Fixed weeklynet installation (name truncation and snapshot URL issues)
  • Removed deprecated Ghostnet network from all selections
  • System metrics now appear immediately on startup (no delay)
  • Long-running installs (snapshot downloads) no longer timeout
  • App shutdown is now instant (~0.5s instead of up to 10 minutes)
  • Fixed forms flashing default values on submit
  • Fixed Esc key accidentally quitting the app after closing modals
  • Multi-column layout navigation improvements

🔧 Improvements

  • Massive CI speedup: Build times reduced from ~45 min to ~10-12 min
  • Better test isolation: All 56 integration tests now have guaranteed cleanup
  • Code quality: Extensive refactoring reducing code duplication by 63%
  • Better documentation: 138+ new doc comments across the codebase
  • Updated to Miaou TUI library v0.2.6

📦 Installation

One-liner:

curl -fsSL https://raw.githubusercontent.com/trilitech/octez-manager/main/install.sh | sh

Debian/Ubuntu:

wget https://github.com/trilitech/octez-manager/releases/download/v0.3.0/octez-manager_0.3.0_ubuntu_amd64.deb
sudo dpkg -i octez-manager_0.3.0_ubuntu_amd64.deb

Direct download:

wget https://github.com/trilitech/octez-manager/releases/download/v0.3.0/octez-manager-v0.3.0-linux-x86_64
chmod +x octez-manager-v0.3.0-linux-x86_64
sudo mv octez-manager-v0.3.0-linux-x86_64 /usr/local/bin/octez-manager

🔐 Verify Checksums

wget https://github.com/trilitech/octez-manager/releases/download/v0.3.0/sha256sums.txt
sha256sum -c sha256sums.txt

Full Changelog: v0.2.1...v0.3.0

v0.2.1

03 Feb 10:11

Choose a tag to compare

Added

  • TUI now shows notification when octez-manager update is available and recommends running self-update command

Changed

  • Renamed "linked directories" to "registered directories" (CLI commands: binaries linkbinaries register, binaries unlinkbinaries unregister)

Fixed

  • Systemd service template warnings about unknown keys StartLimitIntervalSec and StartLimitBurst in [Service] section (moved to [Unit] section)

Removed

  • Ghostnet support - Ghostnet testnet has been deprecated and is no longer available as a network option

What's Changed

  • Fix #512: Enable cascade import for accusers by @vch9 in #525
  • feat(ui): auto-find available ports for DAL instances by @vch9 in #519
  • fix(installer): remove obsolete logrotate sync calls by @vch9 in #520
  • fix(ui): force immediate refresh after instance removal by @vch9 in #526
  • docs: add OCaml LSP server guide to AGENTS.md by @mathiasbourgoin in #539
  • feat: drop Ghostnet support by @vch9 in #521
  • docs: add missing changelog entry for PR #496 to v0.2.0 by @vch9 in #533
  • Fix #515: Rename 'linked' to 'registered' directories by @vch9 in #522
  • Fix #541: Move StartLimitIntervalSec and StartLimitBurst to [Unit] section by @vch9 in #551
  • feat(tui): add self-update notification on startup by @vch9 in #554

Full Changelog: v0.2.0...0.2.1

v0.2.0

29 Jan 17:48

Choose a tag to compare

Added

  • Self-Update System: Check for and install octez-manager updates
  • Binary Management: Download and manage official Octez binary releases
  • Installer Integration: Use managed binaries when installing services
  • Version Notifications: Get notified when new Octez versions are available
  • Update Version Action: Change the binary version used by running services
  • Cascade Update and Rollback: Update services along with their dependents
  • Unmanaged Instances Detection: Automatically detect Octez services not installed by octez-manager
  • Import External Services: Convert detected external services into managed instances

Changed

  • Default network changed from mainnet to shadownet for new installations

Fixed

  • Import wizard navigation and error handling improvements
  • Binary download progress no longer causes display glitches
  • Various keyboard shortcuts and UI fixes
  • Clean exit without hanging on quit

Full changelog: https://github.com/trilitech/octez-manager/blob/main/CHANGELOG.md

What's Changed

Read more

v0.1.1

15 Jan 16:09

Choose a tag to compare

What's Changed

Full Changelog: v0.1.0...v0.1.1

v0.1.0

15 Jan 08:35
e96653a

Choose a tag to compare

Highlights

  • Export logs command for diagnostics
  • Disk space check before snapshot download
  • UI as default command (run octez-manager instead of octez-manager ui)
  • Comprehensive documentation with demo GIFs
  • Integration test suite with Docker-based testing

What's Changed

Added

  • Export logs command (octez-manager instance <name> export-logs)
  • Disk space check before snapshot download
  • Snapshot integrity verification option
  • Auto-generated instance names for all service types
  • System monitor graphs for accusers
  • TUI flow tests using headless driver

Fixed

  • Cache invalidation after editing instances
  • Instance naming no longer includes redundant "node-" prefix
  • DAL node uses correct binary (octez-dal-node)
  • Service failure detection and status display
  • Form field truncation on narrow terminals

Documentation

  • Documentation now focuses on Shadownet for examples
  • Added Nomadic Labs and Trilitech credits
  • Comprehensive CLI reference with examples
  • TUI guide focused on workflows
  • Dark mode support for logos

See CHANGELOG.md for full details.

What's Changed

Read more

v0.0.2

19 Dec 19:33

Choose a tag to compare

What's Changed

Full Changelog: v0.0.1...v0.0.2

v0.0.1

18 Dec 16:09

Choose a tag to compare

What's Changed

  • Address CI workflow review feedback and fix missing dependencies by @Copilot in #9
  • Validate snapshot history mode matches node configuration before import by @Copilot in #4
  • Add --snapshot-no-check flag to install-node command by @Copilot in #20
  • Copilot/monitoring dashboard by @mathiasbourgoin in #22
  • Resolve teztnets network aliases to URLs before passing to octez-node by @Copilot in #12
  • Simplify network prompt text in CLI by @Copilot in #28
  • Add purge-all command to purge all registered instances by @Copilot in #26
  • Convert relative --app-bin-dir paths to absolute before storing in systemd units by @Copilot in #31
  • Add service name to instance show output by @Copilot in #32
  • Make install-baker prompt interactively for instance name by @Copilot in #36
  • Fix baker remote command from "run with remote node" to "run remotely" by @Copilot in #38
  • Enforce unique instance names across all service roles by @Copilot in #41
  • Add mandatory liquidity baking vote configuration for baker instances by @Copilot in #43
  • Add DAL node endpoint configuration with opt-out support for baker by @Copilot in #45
  • Remove --role flag from instance management commands by @Copilot in #47
  • Leftover from !47 by @vch9 in #48
  • Make install-dal-node instance parameter optional with interactive prompting by @Copilot in #51
  • Add net-addr and endpoint parameters to install-dal-node by @Copilot in #53
  • Remove install-smart-rollup-node command by @Copilot in #58
  • Fix CLI input prompts: arrow keys now work instead of printing escape sequences by @Copilot in #55
  • CLI: Default install-baker to pass/none, add interactive node/DAL selection with autocompletion by @Copilot in #60
  • Fix DAL node network display by hiding incorrect network field by @Copilot in #57
  • Baker: resolve network from connected octez-node endpoint by @Copilot in #64
  • Baker: make the install baker simpler by @vch9 in #72
  • Validate instance names for systemd compatibility by @Copilot in #71
  • Fix node endpoint handling in install-baker interactive prompt by @Copilot in #75
  • Feature/form builder core by @mathiasbourgoin in #76
  • Feature/form builder bundles by @mathiasbourgoin in #77
  • Feature/node form v3 by @mathiasbourgoin in #78
  • Feature/accuser form v3 by @mathiasbourgoin in #79
  • feat: Add DAL node and signer installers using field bundles by @mathiasbourgoin in #80
  • Feature/form builder cleanup by @mathiasbourgoin in #81
  • Add zsh autocompletion for octez-manager CLI by @Copilot in #66
  • Chore: Update modals width to new miaou features by @mathiasbourgoin in #82
  • A bunch of improvements by @vch9 in #83
  • Form parity and defaults improvements by @mathiasbourgoin in #84
  • ci: switch to Alpine-based static builds without SDL by @mathiasbourgoin in #85
  • Fix service command line generation by @mathiasbourgoin in #86
  • refactor: Simplify logging to journald-only by @mathiasbourgoin in #88
  • fix(ui): Modal callback, form navigation and reset fixes by @mathiasbourgoin in #87
  • feat(ui): add system metrics and version tracking for nodes by @mathiasbourgoin in #89
  • feat(ui): Improve Instances Page by @mathiasbourgoin in #90
  • Add form field help hints and purge-all directory cleanup by @mathiasbourgoin in #91
  • Prepare repository for open-source release by @mathiasbourgoin in #92
  • docs: add UI screenshot to README by @mathiasbourgoin in #93

New Contributors

Full Changelog: https://github.com/mathiasbourgoin/octez-manager/commits/v0.0.1