pgmoneta-config(1)

📦
version 0.21.0 · 2 versions
, in nixos 26.05

✨ pgmoneta-config ✨ (that's the pgmoneta-config(1) general commands manual page, bestie)

Okay so picture this: you've got pgmoneta and you need to actually configure it, and you're like "ma'am, where do I even start" — enter pgmoneta-config, the configuration utility for pgmoneta. It's literally the little helper that writes your config file for you or pokes at values in a file you already have. Iconic behavior, no notes. 🎀

✨ SYNOPSIS ✨

pgmoneta-config [ -o FILE ] [ COMMAND ]

That's it. That's the whole vibe check. 💅

🌸 DESCRIPTION 🌸

pgmoneta-config is a configuration utility for pgmoneta. Lowkey its whole personality.

It can do two things, and it does them well:

  • generate an initial configuration file interactively (it literally asks you questions, like a friend who cares), or
  • get/set individual configuration values in an existing configuration file (surgical. precise. main character energy).

💖 OPTIONS 💖

  • -o, --output FILE — set the output file path for the init command (default: ./pgmoneta.conf). Yes, the default is literally ./pgmoneta.conf, right there in your current directory. 🫶
  • -q, --quiet — generate default options without prompts (for init). No questions, no small talk, just vibes and a file.
  • -F, --force — force overwrite if the output file already exists. ⚠️ This one will absolutely clobber what's already there, so like… be sure. It's giving "no take-backs."
  • -V, --version — display version information. Everyone loves a little self-introduction. 💁‍♀️
  • -?, --help — display help. When in doubt, ask for help, that's growth. 🌱

🦋 COMMANDS 🦋

  • init — generate a pgmoneta.conf file interactively. The user will be prompted for required values such as host, base_dir, and server connection details. Use it with the -q flag to generate a template file without prompting. 🧚
  • get <file> <section> <key> — get a configuration value from a file. Prints the value to stdout. Clean, simple, zero drama.

Example: pgmoneta-config get pgmoneta.conf primary port

  • set <file> <section> <key> <value> — set a configuration value in a file. Creates the section and key if they do not exist. Preserves comments and formatting — which is honestly so respectful of it. 😭

Example: pgmoneta-config set pgmoneta.conf pgmoneta compression lz4

  • del <file> <section> [key] — delete a section entirely, or just a specific key from a section. Choose your fighter. 💀

Example: pgmoneta-config del pgmoneta.conf pgmoneta compression

  • ls <file> [section] — list all sections within a configuration file, or list all keys within a specific section. It's the "so what have we got here" command. 🔍

Example: pgmoneta-config ls pgmoneta.conf pgmoneta

🌈 EXAMPLES 🌈

Generate a new configuration file interactively:

pgmoneta-config init

Generate a template automatically without prompting:

pgmoneta-config -q init

Generate a configuration file to a specific path:

pgmoneta-config -o /etc/pgmoneta/pgmoneta.conf init

Read the port of the primary server:

pgmoneta-config get /etc/pgmoneta/pgmoneta.conf primary port

Change the compression algorithm:

pgmoneta-config set /etc/pgmoneta/pgmoneta.conf pgmoneta compression lz4

🙈 REPORTING BUGS 🙈

pgmoneta is maintained on GitHub at <https://github.com/pgmoneta/pgmoneta>

Found something cursed? Take it there, bestie. That's where the people who can actually fix it live. 🐛

pgmoneta is licensed under the 3-clause BSD License.

⭐ SEE ALSO ⭐

pgmoneta.conf(5), pgmoneta(1), pgmoneta-cli(1), pgmoneta-admin(1)

k bye bestie, go configure something beautiful 💜 — this lil' page is pgmoneta-config(1) from the General Commands Manual, and it's dated right there in the footer as pgmoneta-config(1). Slay. 🎀

📦 where this page comes from