LITECOIN.CONF(5)

📦 version 0.21.4, in debian bookworm, debian trixie

💖 litecoin.conf — the config file, bestie edition 💖

okay so real talk: this is the manual for litecoin.conf, the litecoin configuration file (section 5 of the File Formats Manual, iykyk). grab a snack, we're going through everything. 🍓

✨ NAME ✨

litecoin.conf — the litecoin configuration file. that's it, that's the name, iconic behavior honestly 👑

🌸 SYNOPSIS 🌸

okay so here's the whole deal:

  • every command-line option (except for -datadir and -conf) can be dropped into a configuration file instead.
  • and every configuration file option can also be thrown on the command line.
  • if both exist? command-line options override the values set in the configuration file. periodt. 💅

the config file itself is just a list of setting=value pairs, one per line, with optional comments that start with the # character. that's the entire format, no cap.

🫶 heads up bestie: the configuration file is not automatically created. you gotta make it yourself with your favorite plain-text editor. by default, litecoind(1) will look for a file named litecoin.conf(5) in the litecoin data directory — but both the data directory and the configuration file path can be changed using the -datadir and -conf command-line arguments. flexible queen ✨

🦋 LOCATION 🦋

litecoin.conf should be located in $HOME/.litecoin

like, that's home. that's where she lives. 🏠

  • testnet=['1'|'0'] — turn on or off running on the test network instead of the real litecoin network. testnet is the practice-mode vibe, fr fr.
  • proxy='127.0.0.1:9050' — connect via a socks4 proxy. sneaky, lowkey.
  • addnode='10.0.0.2:8333' — use as many addnode= settings as you like to connect to specific peers. one is fine, forty is also fine, we don't judge. 💜
  • connect='10.0.0.1:8333' — use as many connect= settings as you like to connect ONLY to specific peers. note the ONLY, bestie, that word is doing heavy lifting. no other peers, just these. 🎯
  • noirc=['1'|'0'] — use or do not use Internet Relay Chat (irc.lfnet.org #litecoin channel) to find other peers. yes that's a real channel, yes it's giving 2011, we love her anyway.
  • maxconnections='value' — maximum number of inbound + outbound connections. the guest list limit. 🎀

💅 JSON-RPC OPTIONS 💅

  • server=['1'|'0'] — tells litecoin to accept or not accept JSON-RPC commands. the on/off switch for being bossable. 😌
  • rpcuser='username' — you must set rpcuser to secure the JSON-RPC api.
  • rpcpassword='password' — you must set rpcpassword to secure the JSON-RPC api. yes, both. no, you can't skip one. this is the lock on the door bestie 🔐
  • rpctimeout='30' — how many seconds litecoin will wait for a complete RPC HTTP request, after the HTTP connection is established. she's patient but not that patient.
  • rpcallowip='192.168.1.*' — by default, only RPC connections from localhost are allowed. specify as many rpcallowip= settings as you like to allow connections from other hosts — and yes, you may use * as a wildcard character. use this power responsibly pls 🙈
  • rpcport='8332' — listen for RPC connections on this TCP port. that's the default port, she's a classic.
  • rpcconnect='127.0.0.1' — you can use litecoin or litecoind(1) to send commands to litecoin/litecoind(1) running on another host using this option. long-distance relationship, but make it RPC 💞
  • rpcssl='1' — use Secure Sockets Layer (also known as TLS or HTTPS) to communicate with litecoin -server or litecoind(1). example of OpenSSL settings used when rpcssl='1':
  • rpcsslciphers='TLSv1+HIGH:!SSLv2:!aNULL:!eNULL:!AH:!3DES:@STRENGTH'
  • rpcsslcertificatechainfile='server.cert'
  • rpcsslprivatekeyfile='server.pem'

⭐ MISCELLANEOUS OPTIONS ⭐

the grab bag section, we love a mixed bag 💖

  • gen=['0'|'1'] — enable or disable attempt to generate litecoins. mining arc, but optional.
  • 4way=['0'|'1'] — enable or disable use SSE instructions to try to generate litecoins faster. speedrun strats 🏃♀️
  • keypool='100' — pre-generate this many public/private key pairs, so wallet backups will be valid for both prior transactions and several dozen future transactions. future-proofing, we stan a planner. ✨
  • paytxfee='0.00' — pay an optional transaction fee every time you send litecoins. transactions with fees are more likely than free transactions to be included in generated blocks, so may be validated sooner. tl;dr: paying the fee is the fast pass, skipping it is the standby line. 🎢
  • allowreceivebyip='1' — allow direct connections for the pay via IP address feature.

🧚 USER INTERFACE OPTIONS 🧚

  • min=['0'|'1'] — enable or disable start litecoind minimized. tiny window, big mood.
  • minimizetotray=['0'|'1'] — enable or disable minimize to the system tray. she tucks herself away so politely 🎀

👑 SEE ALSO 👑

litecoind(1)

that's the whole list. one icon. the main character herself.

🫶 AUTHOR 🫶

This manual page was written by Micah Anderson <micah@debian.org> for the Debian system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3 or any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.

like, slay. legally slay. 💜

okay that's the whole page bestie, you're officially literate in litecoin.conf now 💖✨

litecoin.conf 3.19 🌸 January 2011 🌸 LITECOIN.CONF(5) — bye pookie, go configure something 🫶🎀

📦 where this page comes from