Skip to content

Commit cdd7ab1

Browse files
committed
MAINTENANCE: Describe old and new channels
Machinekit currently has 'deb.machinekit.io' and Cloudsmith based Debian package repositories. This is simple note explaining the difference and how to set the new channel up.
1 parent 3b1c2ae commit cdd7ab1

File tree

1 file changed

+54
-0
lines changed

1 file changed

+54
-0
lines changed

docs/getting-started/installing-packages.asciidoc

+54
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,60 @@
33

44
:skip-front-matter:
55

6+
= OLD and NEW Debian package repositories
7+
8+
Currently, the situation in Machinekit it such that there are two channels from which one can install Machinekit binaries. The newer version is using the https://cloudsmith.io/~machinekit/repos[Cloudsmith service] with repositories https://cloudsmith.io/~machinekit/repos/machinekit/packages/[Machinekit] (with dependency packages common to all other repositories), https://cloudsmith.io/~machinekit/repos/machinekit-hal/packages/[Machinekit-HAL] (with packages from the https://github.com/machinekit/machinekit-hal[Machinekit-HAL project]) and https://cloudsmith.io/~machinekit/repos/emcapplication/packages/[EMCApplication] (with packages from the https://github.com/machinekit/emcapplication[EMCApplication project]. You will need to have usually two or all three set up on you local machine to install Machinekit-HAL or EMCApplication.
9+
10+
To set up, you should follow instruction from Cloudsmith landing page of respective repository under _**S**et-**M**e-**U**p_ icon (here for example for https://cloudsmith.io/~machinekit/repos/machinekit-hal/setup/#formats-deb[Machinekit-HAL]):
11+
12+
[source,bash]
13+
----
14+
sudo apt install curl
15+
curl -1sLf \
16+
'https://dl.cloudsmith.io/public/machinekit/machinekit-hal/cfg/setup/bash.deb.sh' \
17+
| sudo -E bash
18+
----
19+
20+
Or if the automatic script is causing problems, use manual procedure:
21+
22+
[source,bash]
23+
----
24+
sudo apt-get install -y debian-keyring
25+
sudo apt-get install -y debian-archive-keyring
26+
sudo apt-get install -y apt-transport-https
27+
curl -1sLf 'https://dl.cloudsmith.io/public/machinekit/machinekit-hal/cfg/gpg/gpg.D35981AB4276AC36.key' | sudo apt-key add -
28+
curl -1sLf 'https://dl.cloudsmith.io/public/machinekit/machinekit-hal/cfg/setup/config.deb.txt?distro=$(lsb_release -is | tr "[:upper:]" "[:lower:]")\&codename=$(lsb_release -cs) | sudo tee -a /etc/apt/sources.list.d/machinekit-machinekit-hal.list'
29+
apt-get update
30+
----
31+
32+
This setup will allow you to install the currently maintained and developed Machinekit-HAL and EMCApplication packages.
33+
34+
For EMCApplication:
35+
36+
[source,bash]
37+
----
38+
sudo apt install emcapplication
39+
----
40+
41+
For Machinekit-HAL (optionaly Machinekit-HAL-dev package):
42+
43+
[source,bash]
44+
----
45+
sudo apt install machinekit-hal
46+
sudo apt install machinekit-hal-dev
47+
----
48+
49+
For Machinekit-HAL meta-package which will install the *rt_preempt* real-time kernel:
50+
51+
[source,bash]
52+
----
53+
sudo apt install machinekit-hal-rt-preempt
54+
----
55+
56+
Everything else in pages below (_Platforms_) which uses the `deb.machinekit.io` Debian repository address is related to the **old** distribution channel. This includes mainly the now deprecated https://github.com/machinekit/machinekit[Machinekit repository] and older Machinekit-HAL and Machinekit-CNC packages. This channel **will not get any updates in the future!** However, this version is stable and tested one.
57+
58+
You can get current *Preempt_RT* patched kernel packages from official Debian repositories. (Ubuntu unfortunately at this point does not offer this service.)
59+
660
= Platforms
761

862

0 commit comments

Comments
 (0)