Difference between revisions of "Devuan Trinity Repository Installation Instructions"

From Trinity Desktop Project Wiki
Jump to navigation Jump to search
m (Adjusted heading level)
(Updated supported distro list)
 
(6 intermediate revisions by 4 users not shown)
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__
=Available versions and architectures=
 
   
 
=Available versions=
==R14.0.x series==
 
   
 
==TDE R14.x.y series==
Official TDE packages are available for the following versions of Devuan:
 
   
  +
===Stable versions===
{| class="wikitable mw-collapsible"
 
  +
  +
Packages for stable versions are available for the following Devuan distributions (green rows indicates latest version):
  +
 
{| class="wikitable"
 
! Version
 
! Version
 
! Architectures
 
! Architectures
 
! Notes
 
! Notes
  +
|-style="background:lightgreen"
|-
 
  +
| 5.x - daedalus
  +
| amd64, i386, ppc64el, arm64, armhf
  +
|
  +
|-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, armel
+
| amd64, i386, ppc64el, arm64, armhf
 
|
 
|
 
|-
  +
|
  +
| armel
  +
| up to R14.0.13
 
|-
 
|-
 
| 2.x - ascii
 
| 2.x - ascii
| amd64, i386, ppc64el, arm64, armhf, armel
+
| amd64, i386, ppc64el, arm64, armhf
  +
| up to R14.1.1
 
|-
 
|
 
|
  +
| 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 only
+
| up to R14.0.11
 
|}
 
|}
   
  +
===Rolling versions===
   
Additionally, unofficial but well-trusted rolling-release packages are available for Devuan ''ascii'' and all later versions, i.e., including 5.x (''daedalus'') and ''ceres'':
+
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 59:
   
 
=Configuring the package manager=
 
=Configuring the package manager=
 
==Importing the package signing key==
 
 
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 lang="shell-session">
 
$ wget https://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-keyring.deb
 
$ sudo dpkg -i trinity-keyring.deb
 
</syntaxhighlight>
 
 
==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.
   
 
{{WarningBox
 
{{WarningBox
|text=Make sure to replace <span style="color:#ff0000">'''<your-distribution-release-name>'''</span> with your actual distribution release name (for example 'bullseye' or 'buster')
+
|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">
 
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
 
</syntaxhighlight>
  +
  +
<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 <your-distribution-release-name> main
+
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
+
deb 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-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>
  +
 
==Importing the package signing key==
  +
 
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 lang="shell-session">
 
$ wget https://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-keyring.deb
 
$ sudo dpkg -i trinity-keyring.deb
 
</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 R14.0.x installation==
+
==Fresh installation==
   
The following steps are suggested for installing the latest R14.0.x version. If you want to upgrade from an older R14.0.x version, please follow the instructions in the [[#TDEUpgrade|next section]].
+
The following steps are suggested for installing the latest version. If you
   
 
{{WarningBox
 
{{WarningBox
Line 89: Line 113:
 
</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>
 
}}
 
}}
   
=<span id="TDEUpgrade"></span>Upgrading from an existing R14.0.x installation=
 
   
 
=<span id="TDEUpgrade"></span>Upgrading from an existing installation=
The following steps are suggested for upgrading to the latest R14.0.x version.
 
  +
 
The following steps are suggested for upgrading to the latest version.
   
 
<syntaxhighlight lang="shell-session">
 
<syntaxhighlight lang="shell-session">
Line 115: Line 141:
 
# 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 160:
 
# 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 R14.0.x series of TDE or the unofficial rolling-release packages. So, for example, when running the R14.0.x series on the i386 variant of Devuan 4.x/chimaera, the names are as follows:
+
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.0.x_dists_chimaera_main_binary-i386_Packages</code>
+
* <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.0.x_dists_chimaera_main_binary-i386_Packages</code>
+
* <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 204:
   
 
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 230:
 
$ 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>

Latest revision as of 12:03, 27 October 2024


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 Devuan distributions (green rows indicates latest version):

Version Architectures Notes
5.x - daedalus amd64, i386, ppc64el, arm64, armhf
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 up to R14.1.1
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.

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.

Messagebox warning.png
Warning!
Make sure to replace <your-distribution-release-name> with your actual distribution release name (for example 'beowulf' or 'chimaera')

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

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

Messagebox warning.png
Warning!
tde-trinity package is a comprehensive meta-package. To install only a basic environment, replace tde-trinity with tdebase-trinity in the instructions below.
$ sudo apt-get update
$ sudo apt-get install tde-trinity

Localization

Messagebox info.png
Tip
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:
$ 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

Messagebox info.png
Note
Please read the following instructions completely before starting the removal process.

Removing the Trinity Desktop Environment involves the following four steps:

  1. Uninstalling packages
  2. Removing the Trinity repository from the list of available package sources
  3. Cleaning up the package cache
  4. Removing left-over files from your home directory

Uninstalling packages

Removing the Trinity repository from package sources

Cleaning up the package cache

Removing left-over files from your home directory