INFLUX(1)

💫 INFLUX(1) — the InfluxDB client, bestie edition 💫

okay so real talk, this is your manual page for influx, the manual name is INFLUX(1) and like, it's giving "command line bestie for InfluxDB." stay with me, we're gonna go through it together 🫶

---

✨ NAME ✨

influx — the InfluxDB client. that's it, that's the vibe. 💖

---

🎀 SYNOPSIS 🎀

influx [options]
influx -execute <command> [options]
influx -import -path <path> (-compressed) [options]
influx -version

---

🌸 DESCRIPTION 🌸

so influx is literally the command line program you use to talk to an InfluxDB server. main character energy, honestly. 👑

here's the four forms, bestie:

1. first form — the program starts a CLI that you can use to write data or query the database. the command line is described in COMMAND LINE, so go read that if you wanna know more iykyk.
2. second form — this executes a single command, usually a query. it's lowkey the equivalent of starting the command line, running one command, and then exiting. one and done, periodt.
3. third form — this imports a previously exported database to the database. cute little database glow-up ✨
4. fourth form — outputs the version of the command line and then immediately exits. bye girlie 👋

---

💅 OPTIONS 💅

okay this is the part you're really here for, no cap. every single flag, every detail:

• -host <host> — host to connect to. default is localhost. that's where your server lives, bestie 🏠
• -port <port> — port to use when connecting to the host. default is 8086. iconic number fr fr.
• -database <database> — database to use when connecting to the database. the way this one just picks your db for you 💖
• -username <username> — username to connect to the server. your lil identity, slay.
• -password <password> — password to connect to the server. if left blank, this will prompt for a password. so you won't be out here leaking it in your shell history, we love safety 🎀
• -ssl — use https for requests. secure connections only, periodt 🔒
• -unsafeSsl — set this with -ssl to allow unsafe connections. careful bestie, this is the "i trust this server with my life" button 💀
• -execute <command> — executes the command and exits. hit it and quit it, one-shot style 🔥
• -format <json|csv|column> — sets the format of the server responses. default is column. pick your aesthetic 💐
• -precision <rfc3339|h|m|s|ms|u|ns> — specifies the format of the timestamp. default is ns. time is a construct but the units are real ⏰
• -consistency <any|one|quorum|all> — set the write consistency level. default is one. how many nodes gotta agree before it counts, you know? 🫶
• -pretty — turns on pretty print format for the JSON format. make it cute, make it readable 🌈
• -node <n> — specifies the data node that should be queried for data. this option is only valid on enterprise clusters. fancy enterprise behavior only, iykyk 💅
• -import — import a previous database export from a file. if specified, -path <path> must also be specified. no path, no import, that's the rule 🚨
• -path <path> — path to the database export file to import. must be used with -import. they're a package deal, bestie 🎁
• -pps <n> — how many points per second the import will allow. by default, it is zero and will not throttle importing. so zero means go fast, no brakes 🏎️
• -compressed — set if the import file is compressed. must be used with -import. zip it up, import it out 🦋
• -version — outputs the version of the influx client. lil flex of what you're running ⭐

---

🌟 ENVIRONMENT 🌟

the environment variables can be specified in lower case or upper case. the upper case version has precedence. so HTTP_PROXY beats http_proxy, periodt. 👑

• HTTP_PROXY [protocol://]<host>[:port] — sets the proxy server to use for HTTP. your HTTP traffic's designated driver 🚗
• HTTPS_PROXY [protocol://]<host>[:port] — sets the proxy server to use for HTTPS. takes precedence over HTTP_PROXY for HTTPS. so for HTTPS, this one is the main character 💖
• NO_PROXY <comma-separated list of hosts> — list of host names that shouldn't go through any proxy. if set to an asterisk '*' only, it matches all hosts. the "nope, not you" list, iconic honestly 🚫

---

💀 BUGS 💀

report bugs to the GitHub issue tracker at https://github.com/influxdata/influxdb. bestie if something's broken, tell the devs, don't suffer in silence 😭

---

🧚 AUTHORS 🧚

InfluxDB is written and maintained by InfluxData at https://influxdata.com. they're the blueprint, honestly. 🫶

---

👑 COPYRIGHT 👑

InfluxDB is released under the MIT license. slay, open source queen 💅

this man page is released under Creative Commons Attribution 4.0 International License. go share it, credit it, live your truth ✨

---

and that's the whole thing bestie, no cap fr fr. this was INFLUX(1), dated 08/09/2024, straight from the INFLUX(1) source. mwah, go query something gorgeous 💖🌸🦋