Automic VaultAutomic Vault

brew

Install wal-g with Homebrew, Nix

Archival restoration tool for databases. Version 3.0.8 via Homebrew; verified from local package data.

install

Additional install commands

macOS

Homebrewverified · 100%
brew install wal-g

local Homebrew formula metadata

Linux

Nixverified · 92%
nix profile install nixpkgs#wal-g

nixpkgs package indexes · pkgs/by-name/wa/wal-g/package.nix · source: api.github.com

overview

Package summary

Archival restoration tool for databases

Commands and aliases

  • wal-g-etcd
  • wal-g-fdb
  • wal-g-gp
  • wal-g-mongo
  • wal-g-mysql
  • wal-g-pg
  • wal-g-redis
  • wal-g-sqlserver

history

Project history and usage

WAL-G is a cloud-oriented database backup and restore tool best known in the PostgreSQL world, where it archives WAL segments and base backups for point-in-time recovery. It began as a Go rewrite and successor to WAL-E, the older Python tool used for continuous PostgreSQL archiving, and its identity is closely tied to faster restore paths, parallelism, compression choices, and object-storage workflows.

Project history

Citus Data introduced WAL-G publicly in August 2017 as a successor to WAL-E and described it as a complete rewrite in Go. The launch rationale was not just language churn: Citus reported restore performance improvements over WAL-E, highlighted parallel restore work, compatibility with existing WAL-E archives, and additional safety checks for incomplete restores.

The first GitHub release, v0.1.0, was published on August 18, 2017. Early 0.1 releases established the PostgreSQL-focused feature set, including encryption and delta backups in v0.1.3 in December 2017, then continued through safety and performance work around WAL prefetching, parallel reads, delta backup behavior, and WAL-E compatibility during 2018 and 2019.

WAL-G later grew beyond its original PostgreSQL-only niche. The project README now presents it as an archival and restoration tool for PostgreSQL, MySQL/MariaDB, SQL Server, MongoDB, Redis, and related database variants, with separate binaries named for target database families. The release stream also shows ecosystem expansion: v3.0.0 in March 2024 collected a large set of changes, while later 3.x releases mention OrioleDB, Cloudberry, MongoDB 8.0, Greenplum, Redis, and SQL Server work.

Adoption history

WAL-G's adoption followed the operational pattern created by WAL-E: use object storage as the durable archive for physical database backups and transaction logs. The WAL-E repository now calls WAL-E obsolete and points users to alternatives including WAL-G, noting that WAL-G can read, but not write, WAL-E archives and that it is a broader system supporting more databases and compression formats.

The tool became a common package-ecosystem fixture for self-managed PostgreSQL backup setups because it fits common cloud storage and PITR designs without requiring a full backup server. Community and operator writeups describe it as a practical way to stream PostgreSQL backups and WAL to S3-compatible storage and restore to a specific point in time.

By 2026, WAL-G was mature enough to be the compatibility target for newer experiments. ClickHouse's WAL-RUS announcement described WAL-G as mature, battle-tested, and well served in the PostgreSQL community, while proposing a Rust implementation mainly for more predictable memory behavior rather than for replacing WAL-G's backup model.

How it is used

For PostgreSQL, WAL-G is typically wired into backup scripts and PostgreSQL archiving settings: operators run base-backup commands, push WAL segments as they are generated, and later fetch backups and WAL for recovery. Its documentation frames the PostgreSQL mode around encrypted and compressed full or incremental backups pushed to remote storage rather than staged locally.

Package nerd significance comes from the way WAL-G sits between database internals and cloud object stores. It is not a generic compression tool; it encodes the operational assumptions of WAL archiving, PITR, restore prefetching, backup retention, and compatibility with earlier WAL-E archive layouts.

Timeline

  • 2017-08-18: WAL-G v0.1.0 was released on GitHub, the same day Citus published its introduction of WAL-G as a Go successor to WAL-E.
  • 2017-12-19: v0.1.3 added encryption support and delta backups.
  • 2018-11-13: v0.2.0 introduced WAL-delta technology and page-prefault work for faster restore/replay workflows.
  • 2024-03-17: v3.0.0 shipped as a major accumulated release.
  • 2024-08-08: v3.0.3 added full OrioleDB support.
  • 2025-01-10: v3.0.5 listed Cloudberry database support and MongoDB 8.0 support among its major features.
  • 2026-01-21: v3.0.8 continued the 3.x stable line with infrastructure, PostgreSQL, Redis, MongoDB, Greenplum/Cloudberry, and other database updates.

Related projects

  • WAL-E is the direct predecessor in concept and archive model, while pgBackRest and Barman are adjacent PostgreSQL backup systems. WAL-RUS is a later Rust implementation designed for WAL-G-compatible PostgreSQL archival with a different memory-management profile.

security posture

Risk level: blue

broad file, network, media, or database tool signal.

Risk classifier

blue risk · medium confidence · tool

Why

  • broad file, network, media, or database tool signal

Signals

  • text:database,sql,server

Install behavior

  • No Homebrew post-install hook is recorded in formula metadata.
  • Homebrew bottle metadata is available for 6 platform targets.
  • Installs with 3 runtime dependencies.
  • Build metadata lists 2 build dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Credential files

Credential-bearing paths to review before unattended agent runs.

Unix
~/.pgpass~/.aws/credentials

executables

Installed executables

CommandKindExposureNote
wal-g-etcdcliglobal executable
wal-g-fdbcliglobal executable
wal-g-gpcliglobal executable
wal-g-mongocliglobal executable
wal-g-mysqlcliglobal executable
wal-g-pgcliglobal executable
wal-g-rediscliglobal executable
wal-g-sqlservercliglobal executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08
manager version3.0.8
manager updated
local dataok
upstreamcurrent
latest detectedv3.0.8

https://github.com/wal-g/wal-g

  • infoNo package-manager update timestamp was available.low confidence

install metadata

Package metadata

Package keybrew:wal-g
Version3.0.8
Package managerHomebrew
Package manager pagehttps://formulae.brew.sh/formula/wal-g
Homepagehttps://github.com/wal-g/wal-g
Repositoryhttps://github.com/wal-g/wal-g
Upstream docshttps://github.com/wal-g/wal-g#readme
LicenseApache-2.0
Source archivehttps://github.com/wal-g/wal-g/archive/refs/tags/v3.0.8.tar.gz
Dependenciesbrotli, libsodium, lzo
Build dependenciesgo, pkgconf
Bottleavailable (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-installnot defined
Servicenone declared

registry facts

Source database details

Source DatabaseHomebrew formula API
Taphomebrew/core
Full Namewal-g
Version Scheme0
Revision0
Bottle Stable Root URLhttps://ghcr.io/v2/homebrew/core
Deprecatedno
Disabledno
Keg Onlyno
URL Keys
  • stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Nix95%

wal-g

nix profile install nixpkgs#wal-g
  • normalized package name match
  • Matched by: Wal G
nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/wa/wal-g/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Used sources

  • Geiger risk classifier
  • Nucleus package database
  • av.db category and tag curation
  • cross-ecosystem install command graph
  • curated configuration and credential file locations
  • curated package history
  • external package-manager database matches
  • package relationship graph
  • package version freshness
  • package-page enrichment