landscape-client(1)

💖 landscape-client — no cap, the manual 💖

okay so bestie, this is the manual page for landscape-client, section 1 of the manual (the "run this in your shell" section, iykyk). Sit down, grab a strawberry, we're doing this together. 🍓

---

✨ NAME ✨

landscape-client — the Landscape system client 👑

---

✨ SYNOPSIS ✨

landscape-client [options]

that's it. that's the whole summoning spell. options go in, magic comes out. 💅

---

🌸 DESCRIPTION 🌸

so landscape-client is literally the client program for the Landscape system management software. main character energy, fr fr. ✨

its whole job? it's responsible for two things, and it does them both:

• communicating system information to the Landscape server 📡
• executing remote management commands on the system 🫡

so it talks to the server, and it does the stuff the server tells it to do. that's the vibe. 🌈

---

🎀 OPTIONS 🎀

okay this is the part where you actually pay attention. every single one, no skipping, we don't do that here. 💖

• --version — shows the program's version number and dips. ✌️
• -h, --help — shows this help message and exits. the classic. the icon. 🌟
• -c FILE, --config=FILE — use config from this file. heads up bestie: any command line options override settings from the file, so CLI wins every argument. (default: /etc/landscape/client.conf) 📄
• -d PATH, --data-path=PATH — the directory to store data files in. (default: /var/lib/landscape/client/) 🗂️
• -q, --quiet — do not log to the standard output. silence is golden, periodt. 🤫
• -l FILE, --log-dir=FILE — the directory to write log files to. (default: /var/log/landscape) 📝
• --log-level=LOG_LEVEL — one of debug, info, warning, error or critical. pick your drama level. 🎚️
• -u URL, --url=URL — the server URL to connect to. 🌐
• --ping-url=PING_URL — the URL to perform lightweight exchange initiation with. 👋
• -k SSL_PUBLIC_KEY, --ssl-public-key=SSL_PUBLIC_KEY — the public SSL key is a CA Certificate to verify the server. only used if the given server URL is https. 🔐
• --ignore-sigusr1 — ignore the SIGUSR1 signal to rotate logs. 🙈
• --daemon — fork and run in the background. ✨
• --pid-file=PID_FILE — the file to write the PID to. 🆔
• --monitor-only — don't enable management features. this is useful if you want to run the client as a non-root user. lowkey the move for non-root besties. 🫶

---

🌟 EXAMPLES 🌟

here's where it gets real. copy these, they're exact, don't freestyle. 💅

to run the client in the foreground, with all logging data printed to standard I/O:

landscape-client

to run the client in the background with a particular configuration file:

landscape-client --config=my.conf --daemon

to run the client in the foreground, with a configuration file, but overriding the bus option:

landscape-client --config=my.conf --bus=session

and if you want to run the client in non-root mode, please use --monitor-only (or add it to the config file as monitor_only = True) and add the user you want to run as to the /etc/default/landscape-client file:

DAEMON_USER=landscape

not me giving you four whole examples. ate. 🔥

---

🦋 SEE ALSO 🦋

• landscape-config (1)

go read that one too, bestie, it's giving sibling energy. 💜

---

👑 AUTHOR 👑

Landscape Development Team <landscape-team@canonical.com>

they made this. respect. 🫡

---

okay that's the whole page!! this one came out on 02 February 2026, and it's the landscape-client page from the landscape-client manual — literally the same name twice, iconic. 💖✨🎀 bye bestie, go configure something 🌸🦋💅