diff --git a/docs/development/self-hosting.md b/docs/development/self-hosting.md
index bfbc9febea1e227a07f1d416222ebbae7ffeb77f..b1868f8832d7c221112587a0af271d497b7eed70 100644
--- a/docs/development/self-hosting.md
+++ b/docs/development/self-hosting.md
@@ -1,10 +1,6 @@
 # Self-Hosting Renovate
 
-## Open Source vs Commercial versions
-
-Although Renovate is now best known as a "service" via the GitHub App, that service is actually running this same open source project, so you can get the same functionality if running it yourself. The version you see here in this repository can be cloned or `npm` installed in seconds and give you the same core functionality as in the app. The main feature that's missing is the responsiveness that comes from the app's use of a webhook listener (something not possible in a CLI tool).
-
-## Installing Renovate OSS
+## Installing Renovate OSS CLI
 
 #### npmjs
 
@@ -18,6 +14,8 @@ Since renovate v20 `npm`, `pnpm` and `yarn` are no longer embedded, so you need
 $ npm install -g yarn pnpm
 ```
 
+The same goes for any other third party binary tool that may be needed, such as `gradle` or `poetry` - you need to make sure they are installed and the appropriate version you need before running Renovate.
+
 #### Docker
 
 Renovate is available for Docker via an automated build [renovate/renovate](https://hub.docker.com/r/renovate/renovate/). It builds `latest` based on the `master` branch and all semver tags are published too. All the following are valid:
@@ -103,9 +101,17 @@ stringData:
   renovate-autodiscover: 'true'
 ```
 
+## Configuration
+
+Self-hosted Renovate can be configured using any of the following (or a combination):
+
+- A `config.js` file (can also be named `config.json`, but you can't have both at the same time)
+- CLI params
+- Environment params
+
 ## Authentication
 
-You need to select a user account for `renovate` to assume the identity of, and generate a Personal Access Token. It is recommended to be `@renovate-bot` if you are using a self-hosted server and can pick any username you want.
+Regardless of platform, you need to select a user account for `renovate` to assume the identity of, and generate a Personal Access Token. It is recommended to be `@renovate-bot` if you are using a self-hosted server with free choice of usernames.
 It is also recommended that you configure `config.gitAuthor` with the same identity as your Renovate user, e.g. like `"gitAuthor": "Renovate Bot <renovate@whitesourcesoftware.com>"`.
 
 #### GitHub Enterprise
@@ -147,9 +153,9 @@ Don't forget to configure `platform=gitea` somewhere in config.
 
 ## GitHub.com token for release notes
 
-If you are running on any platform except github.com, it's important to also configure `GITHUB_COM_TOKEN` containing a personal access token for github.com. This account can actually be _any_ account on GitHub, and needs only read-only access. It's used when fetching release notes for repositories in order to increase the hourly API limit.
+If you are running on any platform except github.com, it's important to also configure the environment variable `GITHUB_COM_TOKEN` containing a personal access token for github.com. This account can actually be _any_ account on GitHub, and needs only read-only access. It's used when fetching release notes for repositories in order to increase the hourly API limit. It's also OK to configure the same as a host rule instead, if you prefer that.
 
-**Note:** If you're using renovate in a project where dependencies are loaded from github (such as go modules hosted on github) it is highly reccomended to add a github token as you will run in the rate limit from the github api, which will lead to renovate closing and reopening PRs because it could not get reliable info on updated dependencies.
+**Note:** If you're using renovate in a project where dependencies are loaded from github.com (such as Go m=Modules hosted on github) it is highly recommended to add a token as you will run in the rate limit from the github.com api, which will lead to renovate closing and reopening PRs because it could not get reliable info on updated dependencies.
 
 ## File/directory usage
 
@@ -163,14 +169,6 @@ If you wish to override the base directory to be used (e.g. instead of `/tmp/ren
 
 If you wish to override the cache location specifically then configure a value for `cacheDir` instead.
 
-### Identification and Authorization
-
-It's possible to sign git commits, but for this you need to set up the GPG key and setting out of band. In short:
-
-- Make sure the private key is added via GPG
-- Tell git about the private key (e.g. `git config --global user.signingkey AABBCCDDEEFF`)
-- Configure git to sign all commits (`git config --global commit.gpgsign true`)
-
 ## Usage
 
 The following example uses the Renovate CLI tool, which can be installed by running `npm i -g renovate`.
@@ -184,10 +182,7 @@ module.exports = {
   endpoint: 'https://self-hosted.gitlab/api/v4/',
   token: '**gitlab_token**',
   platform: 'gitlab',
-  logFileLevel: 'warn',
-  logLevel: 'info',
-  logFile: '/home/user/renovate.log',
-  onboarding: true,
+  logLevel: 'debug',
   onboardingConfig: {
     extends: ['config:base'],
   },