summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMateusz Piotrowski <mpp302@gmail.com>2021-05-07 19:22:05 +0200
committerGitHub <noreply@github.com>2021-05-07 19:22:05 +0200
commit189e0d5b983088342aee58e9e1d5dd76c0ace384 (patch)
tree414a22f80ff094e31e35198e83ce804829b534da
parent56e5a83e682a862673f9b127ad6a2b5626198a7f (diff)
Update FreeBSD install method (#12815)
The easiest way to install QMK CLI and all the necessary dependencies on FreeBSD is to use the packages from the official FreeBSD Ports Collection. This is possible since QMK CLI has been added to the Ports Collection: https://www.freshports.org/sysutils/py-qmk/
-rw-r--r--docs/newbs_getting_started.md20
1 files changed, 4 insertions, 16 deletions
diff --git a/docs/newbs_getting_started.md b/docs/newbs_getting_started.md
index ff8337f382..b434a04bbe 100644
--- a/docs/newbs_getting_started.md
+++ b/docs/newbs_getting_started.md
@@ -104,19 +104,13 @@ You can also try the `qmk-git` package from AUR:
### ** FreeBSD **
-#### Prerequisites
-
-You will need to install Git and Python. It's possible that you already have both, but if not, run the following commands to install them:
-
- pkg install git python3
-
-Make sure that `$HOME/.local/bin` is added to your `$PATH` so that locally installed Python packages are available.
-
#### Installation
-Install the QMK CLI by running:
+Install the FreeBSD package for QMK CLI by running:
- python3 -m pip install --user qmk
+ pkg install -g "py*-qmk"
+
+NOTE: remember to follow the instructions printed at the end of installation (use `pkg info -Dg "py*-qmk"` to show them again).
<!-- tabs:end -->
@@ -162,12 +156,6 @@ After installing QMK you can set it up with this command:
In most situations you will want to answer `y` to all of the prompts.
-?>**Note on FreeBSD**:
-It is suggested to run `qmk setup` as a non-`root` user to start with, but this will likely identify packages that need to be installed to your
-base system using `pkg`. However the installation will probably fail when run as an unprivileged user.
-To manually install the base dependencies, run `./util/qmk_install.sh` either as `root`, or with `sudo`.
-Once that completes, re-run `qmk setup` to complete the setup and checks.
-
<!-- tabs:end -->
?> The qmk home folder can be specified at setup with `qmk setup -H <path>`, and modified afterwards using the [cli configuration](cli_configuration.md?id=single-key-example) and the variable `user.qmk_home`. For all available options run `qmk setup --help`.