Difference between revisions of "Devuan Trinity Repository Installation Instructions"
m (→Adding the TDE repository: Use Devuan release names in examples) |
|||
Line 1: | Line 1: | ||
[[Category:Documentation]] |
[[Category:Documentation]] |
||
[[Category:Installation]] |
[[Category:Installation]] |
||
+ | |||
This page provides instructions on how to '''install''', '''upgrade''' or '''remove''' Trinity Desktop Environment on Devuan systems. |
This page provides instructions on how to '''install''', '''upgrade''' or '''remove''' Trinity Desktop Environment on Devuan systems. |
||
__FORCETOC__ |
__FORCETOC__ |
||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
− | Official TDE packages are available for the following versions of Devuan: |
||
+ | ===Stable versions=== |
||
⚫ | |||
+ | |||
+ | Packages for stable versions are available for the following Debian distributions (green rows indicates latest version): |
||
+ | |||
⚫ | |||
! Version |
! Version |
||
! Architectures |
! Architectures |
||
! Notes |
! Notes |
||
+ | |-style="background:lightgreen" |
||
⚫ | |||
| 4.x - chimaera |
| 4.x - chimaera |
||
| amd64, i386, ppc64el, arm64, armhf |
| amd64, i386, ppc64el, arm64, armhf |
||
| |
| |
||
+ | |-style="background:lightgreen" |
||
⚫ | |||
| 3.x - beowulf |
| 3.x - beowulf |
||
− | | amd64, i386, ppc64el, arm64, armhf |
+ | | amd64, i386, ppc64el, arm64, armhf |
| |
| |
||
|- |
|- |
||
⚫ | |||
+ | | armel |
||
+ | | up to R14.0.13 |
||
+ | |-style="background:lightgreen" |
||
| 2.x - ascii |
| 2.x - ascii |
||
− | | amd64, i386, ppc64el, arm64, armhf |
+ | | amd64, i386, ppc64el, arm64, armhf |
+ | | |
||
⚫ | |||
| |
| |
||
+ | | armel |
||
+ | | up to R14.0.13 |
||
|- |
|- |
||
| 1.x - jessie |
| 1.x - jessie |
||
| amd64, i386, ppc64el, arm64, armhf, armel |
| amd64, i386, ppc64el, arm64, armhf, armel |
||
− | | up to R14.0.11 |
+ | | up to R14.0.11 |
|} |
|} |
||
+ | ===Rolling versions=== |
||
− | + | Rolling builds are available for a broader set of versions, including <span style="color:#0000ff">daedalus</span> and <span style="color:#0000ff">ceres</span>. |
|
* [[Preliminary_Stable_Builds|Preliminary Stable Builds]] - rolling-release version of the current stable branch (maintenance releases) |
* [[Preliminary_Stable_Builds|Preliminary Stable Builds]] - rolling-release version of the current stable branch (maintenance releases) |
||
* [[Preliminary_Testing_Builds|Preliminary Testing Builds]] - rolling-release version of the main development branch (major/minor releases) |
* [[Preliminary_Testing_Builds|Preliminary Testing Builds]] - rolling-release version of the main development branch (major/minor releases) |
||
− | |||
− | These packages are built and maintained by Slávek Banko. |
||
==v3.5.13.2== |
==v3.5.13.2== |
||
Line 44: | Line 55: | ||
=Configuring the package manager= |
=Configuring the package manager= |
||
− | |||
⚫ | |||
− | |||
⚫ | The best way to import TDE's package signing key is to manually download and install the package <code>trinity-keyring</code>. The advantage is that this method of installation is not dependent on the availability of a key server. Another advantage is that the key is not integrated into the global apt keyring, but is installed as a separate file: |
||
− | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
− | |||
− | ==Adding the TDE repository== |
||
Add the following lines to your <tt>/etc/apt/sources.list</tt> file. |
Add the following lines to your <tt>/etc/apt/sources.list</tt> file. |
||
Line 61: | Line 61: | ||
|text=Make sure to replace <span style="color:#ff0000">'''<your-distribution-release-name>'''</span> with your actual distribution release name (for example 'beowulf' or 'chimaera') |
|text=Make sure to replace <span style="color:#ff0000">'''<your-distribution-release-name>'''</span> with your actual distribution release name (for example 'beowulf' or 'chimaera') |
||
}} |
}} |
||
− | {{TipBox |
||
− | |caption=Note |
||
− | |text=<tt>deb-src</tt> lines following are optional. |
||
− | }} |
||
+ | ===TDE R14.1.x series=== |
||
+ | <syntaxhighlight lang="sourceslist"> |
||
⚫ | |||
+ | |||
+ | # Optional sources |
||
+ | deb-src http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-r14.1.x <your-distribution-release-name> main deps |
||
⚫ | |||
+ | |||
+ | <div class="mw-collapsible mw-collapsed"> |
||
===TDE R14.0.x series=== |
===TDE R14.0.x series=== |
||
+ | <div class="mw-collapsible-content"> |
||
<syntaxhighlight lang="sourceslist"> |
<syntaxhighlight lang="sourceslist"> |
||
− | deb http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-r14.0.x |
+ | deb http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-r14.0.x <your-distribution-release-name> main |
− | deb http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-builddeps-r14.0.x |
+ | deb http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-builddeps-r14.0.x <your-distribution-release-name> main |
+ | |||
⚫ | |||
+ | # Optional sources |
||
+ | deb-src http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-r14.0.x <your-distribution-release-name> main |
||
deb-src http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-builddeps-r14.0.x <your-distribution-release-name> main |
deb-src http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-builddeps-r14.0.x <your-distribution-release-name> main |
||
+ | </syntaxhighlight> |
||
+ | </div></div> |
||
+ | |||
⚫ | |||
+ | |||
⚫ | The best way to import TDE's package signing key is to manually download and install the package <code>trinity-keyring</code>. The advantage is that this method of installation is not dependent on the availability of a key server. Another advantage is that the key is not integrated into the global apt keyring, but is installed as a separate file: |
||
+ | |||
⚫ | |||
⚫ | |||
⚫ | |||
</syntaxhighlight> |
</syntaxhighlight> |
||
=Installing Trinity= |
=Installing Trinity= |
||
+ | * If you are doing a '''fresh TDE installation''', please follow the steps listed below.<br> |
||
+ | * If you are '''upgrading''' from an existing version, please follow the instruction under the [[#TDEUpgrade|upgrading]] section.<br> |
||
− | ==Fresh |
+ | ==Fresh installation== |
− | The following steps are suggested for installing the latest |
+ | The following steps are suggested for installing the latest version. If you |
{{WarningBox |
{{WarningBox |
||
Line 89: | Line 109: | ||
</syntaxhighlight> |
</syntaxhighlight> |
||
+ | ===Localization=== |
||
{{TipBox |
{{TipBox |
||
|text=After installing the environment, it is also a good idea to install the localization packages so that you can switch the environment to your native language. For example, for Czech you would run: <syntaxhighlight lang="shell-session">$ sudo apt-get install tde-i18n-cs-trinity</syntaxhighlight> |
|text=After installing the environment, it is also a good idea to install the localization packages so that you can switch the environment to your native language. For example, for Czech you would run: <syntaxhighlight lang="shell-session">$ sudo apt-get install tde-i18n-cs-trinity</syntaxhighlight> |
||
}} |
}} |
||
⚫ | |||
⚫ | |||
⚫ | |||
+ | |||
⚫ | |||
<syntaxhighlight lang="shell-session"> |
<syntaxhighlight lang="shell-session"> |
||
Line 115: | Line 137: | ||
# Removing left-over files from your home directory |
# Removing left-over files from your home directory |
||
+ | <div class="mw-collapsible mw-collapsed"> |
||
==Uninstalling packages== |
==Uninstalling packages== |
||
+ | <div class="mw-collapsible-content"> |
||
===Using aptitude=== |
===Using aptitude=== |
||
Line 132: | Line 156: | ||
# Uninstalling all packages that were installed as dependencies of Trinity |
# Uninstalling all packages that were installed as dependencies of Trinity |
||
− | To generate a list of all packages available from the Trinity repository, you will need to filter out just the package names from two files in <code>/var/lib/apt/lists</code> and write the result to a new file. The names of these files depend on three factors: The Devuan release in use, the processor type the system is running on, and whether you're using the |
+ | To generate a list of all packages available from the Trinity repository, you will need to filter out just the package names from two files in <code>/var/lib/apt/lists</code> and write the result to a new file. The names of these files depend on three factors: The Devuan release in use, the processor type the system is running on, and whether you're using the stable series or rolling-release packages. So, for example, when running the R14.1.x series on the i386 variant of Devuan 4.x/chimaera, the names are as follows: |
− | * <code>mirror.ppa.trinitydesktop.org_trinity_deb_trinity-r14. |
+ | * <code>mirror.ppa.trinitydesktop.org_trinity_deb_trinity-r14.1.x_dists_chimaera_main_binary-i386_Packages</code> |
− | * <code>mirror.ppa.trinitydesktop.org_trinity_deb_trinity-builddeps-r14. |
+ | * <code>mirror.ppa.trinitydesktop.org_trinity_deb_trinity-builddeps-r14.1.x_dists_chimaera_main_binary-i386_Packages</code> |
First, let's create a new empty file in <code>/tmp</code>, using <code>mktemp</code>: |
First, let's create a new empty file in <code>/tmp</code>, using <code>mktemp</code>: |
||
Line 176: | Line 200: | ||
If you're not sure how to handle the situation, ask in the Trinity IRC channel or on the mailing list.}} |
If you're not sure how to handle the situation, ask in the Trinity IRC channel or on the mailing list.}} |
||
+ | </div></div> |
||
+ | <div class="mw-collapsible mw-collapsed"> |
||
==Removing the Trinity repository from package sources== |
==Removing the Trinity repository from package sources== |
||
+ | <div class="mw-collapsible-content"> |
||
Open <code>/etc/apt/sources.list</code> and either remove the Trinity repository lines or comment them by adding a hash symbol (<code>#</code>) at the beginning of each line. Then save the file and run <code>sudo apt-get update</code>. |
Open <code>/etc/apt/sources.list</code> and either remove the Trinity repository lines or comment them by adding a hash symbol (<code>#</code>) at the beginning of each line. Then save the file and run <code>sudo apt-get update</code>. |
||
+ | </div></div> |
||
+ | <div class="mw-collapsible mw-collapsed"> |
||
==Cleaning up the package cache== |
==Cleaning up the package cache== |
||
+ | <div class="mw-collapsible-content"> |
||
If you deactivated/removed the repo from source.list, at least run |
If you deactivated/removed the repo from source.list, at least run |
||
Line 196: | Line 226: | ||
$ sudo apt-get clean |
$ sudo apt-get clean |
||
</syntaxhighlight> |
</syntaxhighlight> |
||
+ | </div></div> |
||
+ | <div class="mw-collapsible mw-collapsed"> |
||
==Removing left-over files from your home directory== |
==Removing left-over files from your home directory== |
||
+ | <div class="mw-collapsible-content"> |
||
Remove TDE files in <tt>$HOME</tt>. Usually these are the <tt>.tderc</tt> file and the <tt>.trinity</tt> and <tt>.qt</tt> directories. (The latter is still mistakenly used by some applications.) |
Remove TDE files in <tt>$HOME</tt>. Usually these are the <tt>.tderc</tt> file and the <tt>.trinity</tt> and <tt>.qt</tt> directories. (The latter is still mistakenly used by some applications.) |
||
+ | </div></div> |
Revision as of 10:39, 30 April 2023
This page provides instructions on how to install, upgrade or remove Trinity Desktop Environment on Devuan systems.
Available versions
TDE R14.x.y series
Stable versions
Packages for stable versions are available for the following Debian distributions (green rows indicates latest version):
Version | Architectures | Notes |
---|---|---|
4.x - chimaera | amd64, i386, ppc64el, arm64, armhf | |
3.x - beowulf | amd64, i386, ppc64el, arm64, armhf | |
armel | up to R14.0.13 | |
2.x - ascii | amd64, i386, ppc64el, arm64, armhf | |
armel | up to R14.0.13 | |
1.x - jessie | amd64, i386, ppc64el, arm64, armhf, armel | up to R14.0.11 |
Rolling versions
Rolling builds are available for a broader set of versions, including daedalus and ceres.
- Preliminary Stable Builds - rolling-release version of the current stable branch (maintenance releases)
- Preliminary Testing Builds - rolling-release version of the main development branch (major/minor releases)
v3.5.13.2
There is no support for this TDE version in Devuan.
Configuring the package manager
Add the following lines to your /etc/apt/sources.list file.
TDE R14.1.x series
deb http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-r14.1.x <your-distribution-release-name> main deps
# Optional sources
deb-src http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-r14.1.x <your-distribution-release-name> main deps
TDE R14.0.x series
deb http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-r14.0.x <your-distribution-release-name> main
deb http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-builddeps-r14.0.x <your-distribution-release-name> main
# Optional sources
deb-src http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-r14.0.x <your-distribution-release-name> main
deb-src http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-builddeps-r14.0.x <your-distribution-release-name> main
Importing the package signing key
The best way to import TDE's package signing key is to manually download and install the package trinity-keyring
. The advantage is that this method of installation is not dependent on the availability of a key server. Another advantage is that the key is not integrated into the global apt keyring, but is installed as a separate file:
$ wget https://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-keyring.deb
$ sudo dpkg -i trinity-keyring.deb
Installing Trinity
- If you are doing a fresh TDE installation, please follow the steps listed below.
- If you are upgrading from an existing version, please follow the instruction under the upgrading section.
Fresh installation
The following steps are suggested for installing the latest version. If you
$ sudo apt-get update
$ sudo apt-get install tde-trinity
Localization
$ sudo apt-get install tde-i18n-cs-trinity
Upgrading from an existing installation
The following steps are suggested for upgrading to the latest version.
$ sudo apt-get update
$ sudo aptitude full-upgrade
This will upgrade TDE to the newer version and should complete smoothly.
Removing Trinity
Removing the Trinity Desktop Environment involves the following four steps:
- Uninstalling packages
- Removing the Trinity repository from the list of available package sources
- Cleaning up the package cache
- Removing left-over files from your home directory
Uninstalling packages
Using aptitude
If you have aptitude installed, you can simply run
$ sudo aptitude purge '~i~Otrinitydesktop'
Using apt-get
Using the standard apt-get utility to uninstall TDE and its dependencies involves the following three steps:
- Generating a list of all packages available from the Trinity repository
- Using that list to uninstall all installed packages originating from that repository
- Uninstalling all packages that were installed as dependencies of Trinity
To generate a list of all packages available from the Trinity repository, you will need to filter out just the package names from two files in /var/lib/apt/lists
and write the result to a new file. The names of these files depend on three factors: The Devuan release in use, the processor type the system is running on, and whether you're using the stable series or rolling-release packages. So, for example, when running the R14.1.x series on the i386 variant of Devuan 4.x/chimaera, the names are as follows:
mirror.ppa.trinitydesktop.org_trinity_deb_trinity-r14.1.x_dists_chimaera_main_binary-i386_Packages
mirror.ppa.trinitydesktop.org_trinity_deb_trinity-builddeps-r14.1.x_dists_chimaera_main_binary-i386_Packages
First, let's create a new empty file in /tmp
, using mktemp
:
$ mktemp /tmp/tde.XXXX
/tmp/tde.fB6B
Generating a list of all Trinity packages and writing it to that file now works as follows:
$ sed -n '/^Package: / s/^Package: //p' /var/lib/apt/lists/mirror.ppa.trinitydesktop.org_trinity_deb_trinity-*Packages > /tmp/tde.fB6B
Be sure to replace the output file's name with the actual name of the file mktemp
created on your system.
Now that we have a list of all TDE packages, we can hand that to apt-get
for uninstallation:
$ sudo apt-get remove $(cat /tmp/tde.fB6B)
Replace apt-get remove
with apt-get purge
to also remove the configuration files that came with those packages. And, as above, be sure to replace the output file's name with the actual name of the file mktemp
created on your system.
Apt will figure out which of the packages in the list are actually installed and present them for uninstallation. It will also already notify the user of a bunch of packages that "were automatically installed and are not longer required" and suggest using apt autoremove
to uninstall them. We will take care of that in the next step. So, for now, just confirm the uninstallation of the TDE packages.
If Apt asks whether to stop the tdm deamon, say yes. We're removing TDE, after all. This will land you on the TTY that TDM was running on before. Need to switch back to the one you ran apt-get
from using Ctrl + F1..7.
Finally, to uninstall all remaining Trinity dependencies, you will need to run
$ sudo apt-get autoremove
In case you also want to remove the configuration files that came with these packages, append --purge
to the autoremove
command.
apt-get autoremove
without care can leave certain software on your system or the system as a whole in an unusable state. The command simply uninstalls all packages that were installed as dependencies of packages that are no longer installed, which might lead to the uninstallation of packages that you wanted to keep.
Be sure to read the list of packages that Apt will want to uninstall, carefully. If you want to continue to use any of the packages in that list, abort the operation, mark that package as manually installed, and then run the command again.
If you're not sure how to handle the situation, ask in the Trinity IRC channel or on the mailing list.Removing the Trinity repository from package sources
Open /etc/apt/sources.list
and either remove the Trinity repository lines or comment them by adding a hash symbol (#
) at the beginning of each line. Then save the file and run sudo apt-get update
.
Cleaning up the package cache
If you deactivated/removed the repo from source.list, at least run
$ sudo apt-get autoclean
This will remove all Trinity packages from the local cache.
To get rid of other packages as well, you'll have to clean out the whole package cache using
$ sudo apt-get clean
Removing left-over files from your home directory
Remove TDE files in $HOME. Usually these are the .tderc file and the .trinity and .qt directories. (The latter is still mistakenly used by some applications.)