contrib: example systemd service and config file
Including in light of #977
This commit is contained in:
parent
2c544257f5
commit
cf6654c178
3 changed files with 40 additions and 4 deletions
15
README.md
15
README.md
|
@ -215,16 +215,23 @@ foreground:
|
||||||
|
|
||||||
./bin/bitmonerod
|
./bin/bitmonerod
|
||||||
|
|
||||||
To run in background:
|
|
||||||
|
|
||||||
./bin/bitmonerod --log-file bitmonerod.log --detach
|
|
||||||
|
|
||||||
To list all available options, run `./bin/bitmonerod --help`. Options can be
|
To list all available options, run `./bin/bitmonerod --help`. Options can be
|
||||||
specified either on the command line or in a configuration file passed by the
|
specified either on the command line or in a configuration file passed by the
|
||||||
`--config-file` argument. To specify an option in the configuration file, add
|
`--config-file` argument. To specify an option in the configuration file, add
|
||||||
a line with the syntax `argumentname=value`, where `argumentname` is the name
|
a line with the syntax `argumentname=value`, where `argumentname` is the name
|
||||||
of the argument without the leading dashes, for example `log-level=1`.
|
of the argument without the leading dashes, for example `log-level=1`.
|
||||||
|
|
||||||
|
To run in background:
|
||||||
|
|
||||||
|
./bin/bitmonerod --log-file bitmonerod.log --detach
|
||||||
|
|
||||||
|
To run as a systemd service, copy
|
||||||
|
[bitmonerod.service](utils/systemd/bitmonerod.service) to `/etc/systemd/system/` and
|
||||||
|
[bitmonerod.conf](utils/conf/bitmonerod.conf) to `/etc/`. The [example
|
||||||
|
service](utils/systemd/bitmonerod.service) assumes that the user `bitmonero` exists
|
||||||
|
and its home is the data directory specified in the [example
|
||||||
|
config](utils/conf/bitmonerod.conf).
|
||||||
|
|
||||||
## Internationalization
|
## Internationalization
|
||||||
|
|
||||||
See README.i18n
|
See README.i18n
|
||||||
|
|
7
utils/conf/bitmonerod.conf
Normal file
7
utils/conf/bitmonerod.conf
Normal file
|
@ -0,0 +1,7 @@
|
||||||
|
# Configuration for bitmonerod
|
||||||
|
# Syntax: any command line option may be specified as 'clioptionname=value'.
|
||||||
|
# See 'bitmonerod --help' for all available options.
|
||||||
|
|
||||||
|
data-dir=/var/lib/bitmonero
|
||||||
|
log-file=/var/log/bitmonero/bitmonero.log
|
||||||
|
log-level=0
|
22
utils/systemd/bitmonerod.service
Normal file
22
utils/systemd/bitmonerod.service
Normal file
|
@ -0,0 +1,22 @@
|
||||||
|
[Unit]
|
||||||
|
Description=Monero cryptocurrency node
|
||||||
|
After=network.target
|
||||||
|
|
||||||
|
[Service]
|
||||||
|
User=bitmonero
|
||||||
|
Group=bitmonero
|
||||||
|
WorkingDirectory=~
|
||||||
|
|
||||||
|
Type=forking
|
||||||
|
ExecStart=/usr/bin/bitmonerod --config-file /etc/bitmonerod.conf --detach
|
||||||
|
|
||||||
|
# This is necessary because bitmonerod does not yet support
|
||||||
|
# writing a PID file, which means systemd tries to guess the PID
|
||||||
|
# by default, but it guesses wrong (sometimes, depending on
|
||||||
|
# random timing of events), because the daemon forks twice.
|
||||||
|
# The ultimate fix is for the daemon to write a PID file, and
|
||||||
|
# a workaround is to disable the guessing feature in systemd.
|
||||||
|
GuessMainPID=no
|
||||||
|
|
||||||
|
[Install]
|
||||||
|
WantedBy=multi-user.target
|
Loading…
Reference in a new issue