@ -10,14 +10,14 @@ can be found in the contrib/init folder.
contrib/init/bitcoind.conf: Upstart service configuration file
contrib/init/bitcoind.conf: Upstart service configuration file
contrib/init/bitcoind.init: CentOS compatible SysV style init script
contrib/init/bitcoind.init: CentOS compatible SysV style init script
1. Service User
Service User
---------------------------------
---------------------------------
All three Linux startup configurations assume the existence of a "bitcoin" user
All three Linux startup configurations assume the existence of a "bitcoin" user
and group. They must be created before attempting to use these scripts.
and group. They must be created before attempting to use these scripts.
The OS X configuration assumes bitcoind will be set up for the current user.
The OS X configuration assumes bitcoind will be set up for the current user.
2. Configuration
Configuration
---------------------------------
---------------------------------
At a bare minimum, bitcoind requires that the rpcpassword setting be set
At a bare minimum, bitcoind requires that the rpcpassword setting be set
@ -46,10 +46,10 @@ relative to the data directory. `wallet` *only* supports relative paths.
For an example configuration file that describes the configuration settings,
For an example configuration file that describes the configuration settings,
see `contrib/debian/examples/bitcoin.conf` .
see `contrib/debian/examples/bitcoin.conf` .
3. Paths
Paths
---------------------------------
---------------------------------
3a) Linux
### Linux
All three configurations assume several paths that might need to be adjusted.
All three configurations assume several paths that might need to be adjusted.
@ -65,17 +65,17 @@ reasons to make the configuration file and data directory only readable by the
bitcoin user and group. Access to bitcoin-cli and other bitcoind rpc clients
bitcoin user and group. Access to bitcoin-cli and other bitcoind rpc clients
can then be controlled by group membership.
can then be controlled by group membership.
3b) Mac OS X
### Mac OS X
Binary: `/usr/local/bin/bitcoind`
Binary: `/usr/local/bin/bitcoind`
Configuration file: `~/Library/Application Support/Bitcoin/bitcoin.conf`
Configuration file: `~/Library/Application Support/Bitcoin/bitcoin.conf`
Data directory: `~/Library/Application Support/Bitcoin`
Data directory: `~/Library/Application Support/Bitcoin`
Lock file: `~/Library/Application Support/Bitcoin/.lock`
Lock file: `~/Library/Application Support/Bitcoin/.lock`
4. Installing Service Configuration
Installing Service Configuration
-----------------------------------
-----------------------------------
4a) systemd
### systemd
Installing this .service file consists of just copying it to
Installing this .service file consists of just copying it to
/usr/lib/systemd/system directory, followed by the command
/usr/lib/systemd/system directory, followed by the command
@ -84,14 +84,14 @@ Installing this .service file consists of just copying it to
To test, run `systemctl start bitcoind` and to enable for system startup run
To test, run `systemctl start bitcoind` and to enable for system startup run
`systemctl enable bitcoind`
`systemctl enable bitcoind`
4b) OpenRC
### OpenRC
Rename bitcoind.openrc to bitcoind and drop it in /etc/init.d. Double
Rename bitcoind.openrc to bitcoind and drop it in /etc/init.d. Double
check ownership and permissions and make it executable. Test it with
check ownership and permissions and make it executable. Test it with
`/etc/init.d/bitcoind start` and configure it to run on startup with
`/etc/init.d/bitcoind start` and configure it to run on startup with
`rc-update add bitcoind`
`rc-update add bitcoind`
4c) Upstart (for Debian/Ubuntu based distributions)
### Upstart (for Debian/Ubuntu based distributions)
Drop bitcoind.conf in /etc/init. Test by running `service bitcoind start`
Drop bitcoind.conf in /etc/init. Test by running `service bitcoind start`
it will automatically start on reboot.
it will automatically start on reboot.
@ -99,7 +99,7 @@ it will automatically start on reboot.
NOTE: This script is incompatible with CentOS 5 and Amazon Linux 2014 as they
NOTE: This script is incompatible with CentOS 5 and Amazon Linux 2014 as they
use old versions of Upstart and do not supply the start-stop-daemon utility.
use old versions of Upstart and do not supply the start-stop-daemon utility.
4d) CentOS
### CentOS
Copy bitcoind.init to /etc/init.d/bitcoind. Test by running `service bitcoind start` .
Copy bitcoind.init to /etc/init.d/bitcoind. Test by running `service bitcoind start` .
@ -107,7 +107,7 @@ Using this script, you can adjust the path and flags to the bitcoind program by
setting the BITCOIND and FLAGS environment variables in the file
setting the BITCOIND and FLAGS environment variables in the file
/etc/sysconfig/bitcoind. You can also use the DAEMONOPTS environment variable here.
/etc/sysconfig/bitcoind. You can also use the DAEMONOPTS environment variable here.
4e) Mac OS X
### Mac OS X
Copy org.bitcoin.bitcoind.plist into ~/Library/LaunchAgents. Load the launch agent by
Copy org.bitcoin.bitcoind.plist into ~/Library/LaunchAgents. Load the launch agent by
running `launchctl load ~/Library/LaunchAgents/org.bitcoin.bitcoind.plist` .
running `launchctl load ~/Library/LaunchAgents/org.bitcoin.bitcoind.plist` .
@ -118,7 +118,7 @@ NOTE: This approach is intended for those wanting to run bitcoind as the current
You will need to modify org.bitcoin.bitcoind.plist if you intend to use it as a
You will need to modify org.bitcoin.bitcoind.plist if you intend to use it as a
Launch Daemon with a dedicated bitcoin user.
Launch Daemon with a dedicated bitcoin user.
5. Auto-respawn
Auto-respawn
-----------------------------------
-----------------------------------
Auto respawning is currently only configured for Upstart and systemd.
Auto respawning is currently only configured for Upstart and systemd.