:url_pm2: https://github.com/Unitech/pm2
:url_config_logrotation: lisk-docs::run-blockchain/logging.adoc#logrotation
:url_mgmt_pm2: management/pm2.adoc
:url_ref_cli: reference/cli.adoc


// :url_config_logrotation: ROOT::run-blockchain/logging.adoc#logrotation
// TODO: un-comment links and respective descriptions when guides are available
:url_process_management: pm2.adoc


== Post-installation (optional)

=== Use pm2 to run Lisk Core in the background

It is recommended to use a process manager such as {url_pm2}[PM2^] to run Lisk Core in the background.
// For further information, please see the xref:url_process_management[Process management guide].

//TODO: Add links back, once the respective docs are updated
//Check the guide xref:{url_mgmt_pm2}[] for more information.

=== Enable IPC & WS in the config

To make use of all the Lisk Core commands, enable IPC in the config.

.Example: Enable IPC & WS via config.json
[source,json]
----
"rpc": {
    // Enable RPC communication over 'ipc' and 'ws'
    "modes": ["ipc", "ws"]

    // In case `modes` include `ws` then, the following port is used
    "port": 7887,

    // Change to 0.0.0.0 to connect from a remote server
    "host": "127.0.0.1"
},
----

Alternatively, start Lisk Core with the flag `--api-ipc` to enable IPC:

.Example: Enable IPC via flag
[source,bash]
----
lisk-core start --api-ipc
----

NOTE: Please note that specifying any of the `--api-ipc`, `--api-ws`, or `--api-http` flags in the `lisk-core start` command overrides the `rpc.modes` settings in the `config.json`.

// === Log rotation

// It is recommended to set up a log rotation, as the log of the Lisk Core files can grow very large over time.


// Check the guide xref:{url_config_logrotation}[Managing logs] in the SDK docs for more information.

// TODO: Enable Log rotation section above and add link back, once the respective docs are updated. (after issue Lisk-docs#1533 Update managing logs is completed).


