Difference between revisions of "Ubuntu Trinity Repository Installation Instructions"

From Trinity Desktop Project Wiki
Jump to navigation Jump to search
imported>Michele Calgaro
(Added upgrade section)
(Updated supported distro list)
 
(56 intermediate revisions by 8 users not shown)
Line 2: Line 2:
 
[[Category:Installation]]
 
[[Category:Installation]]
   
On this page you can read the instructions to '''install''' or '''upgrade''' the Trinity Desktop Environment on your Ubuntu system.<br>
 
Live CD Images for Ubuntu with Trinity preinstalled are also available [https://ppa.quickbuild.pearsoncomputing.net/trinity/cdimages/ubuntu here].
 
   
  +
This page provides instructions to '''install''', '''upgrade''' or '''remove''' Trinity Desktop Environment on your Ubuntu system.
  +
__FORCETOC__
   
  +
=Available versions=
='''Ensure the Ubuntu Universe and Multiverse repositories are available for use'''=
 
   
  +
==R14.x.y series==
As root (e.g. using sudo), uncomment (remove the # marks from) the lines of your /etc/apt/sources.list file that include Universe and Multiverse<br>
 
If your system does not contain entries for Universe and Multiverse, append " universe multiverse" to your main Ubuntu repository line<br>
 
Alternatively, you may use graphical tools or other tutorials to enable the Universe and Multiverse repositories--the exact method of enabling is not important to the TDE installation process
 
   
  +
===Stable versions===
   
  +
Packages for stable versions are available for the following Ubuntu distributions (green rows indicates latest version):
='''Ensure the Ubuntu Recommended Updates repository is available for use'''=
 
   
  +
{| class="wikitable"
As root (e.g. using sudo), uncomment (remove the # marks from) the lines of your /etc/apt/sources.list file that include -updates<br>
 
  +
! Version
If your system does not contain entries for -updates, copy your main Ubuntu repository line to the end of the /etc/apt/sources.list file and append -updates to the distribution name<br>
 
  +
! Architectures
Alternatively, you may use graphical tools or other tutorials to enable the Recommended Updates repository--the exact method of enabling is not important to the TDE installation process
 
  +
! Notes
  +
|-style="background:lightgreen"
  +
| 24.10 - Oracular
  +
| amd64, ppc64el
  +
|
  +
|-style="background:lightgreen"
  +
| 24.04 - Noble
  +
| amd64, ppc64el, arm64, armhf
  +
|
  +
|-style="background:lightgreen"
  +
| 23.10 - Mantic
  +
| amd64, ppc64el
  +
|
  +
|-style="background:lightgreen"
  +
| 23.04 - Lunar
  +
| amd64, ppc64el
  +
|
  +
|-style="background:lightgreen"
  +
| 22.04 - Jammy
  +
| amd64, ppc64el, arm64, armhf
  +
|
  +
|-
  +
| 21.10 - Impish
  +
| amd64, ppc64el
  +
| up to R14.1.0
  +
|-
  +
| 21.04 - Hirsute
  +
| amd64, ppc64el
  +
| up to R14.0.13
  +
|-
  +
| 20.10 - Groovy
  +
| amd64, ppc64el
  +
| up to R14.0.12
  +
|-style="background:lightgreen"
  +
| 20.04 - Focal
  +
| amd64, ppc64el, arm64, armhf
  +
|
  +
|-
  +
| 19.10 - Eoan
  +
| amd64, i386, ppc64el
  +
| up to R14.0.10
  +
|-
  +
| 19.04 - Disco
  +
| amd64, i386, ppc64el
  +
| up to R14.0.9
  +
|-
  +
| 18.10 - Cosmic
  +
| amd64, i386, ppc64el
  +
| up to R14.0.8
  +
|-style="background:lightgreen"
  +
| 18.04 - Bionic
  +
| amd64, i386, ppc64el, armhf
  +
|
  +
|-
  +
| 17.10 - Artful
  +
| amd64, i386, ppc64el
  +
| up to R14.0.6
  +
|-
  +
| 17.04 - Zesty
  +
| amd64, i386, ppc64el
  +
| up to R14.0.5
  +
|-
  +
| 16.10 - Yakkety
  +
| amd64, i386
  +
| up to R14.0.4
  +
|-
  +
| 16.04 - Xenial
  +
| amd64, i386, ppc64el, armhf
  +
| up to R14.1.1
  +
|-
  +
| 14.04 - Trusty
  +
| amd64, i386, armhf
  +
| up to R14.0.11
  +
|-
  +
| 12.04 - Precise
  +
| amd64, i386
  +
| up to R14.0.8
  +
|-
  +
| 10.04 - Lucid
  +
| amd64, i386
  +
| up to R14.0.6
  +
|}
   
  +
===Rolling versions===
   
  +
Rolling builds are available for a broader set of versions.
='''Add these lines to your /etc/apt/sources.list file'''=
 
   
  +
* [[Preliminary_Stable_Builds|Preliminary Stable Builds]] - rolling version of current stable branch (maintenance releases)
==For Utopic (Ubuntu 14.10)==
 
  +
* [[Preliminary_Testing_Builds|Preliminary Testing Builds]] - rolling version of main development branch (major/minor releases)
'''TDE R14.0.0'''
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-r14.0.0/ubuntu utopic main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-r14.0.0/ubuntu utopic main
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-r14.0.0/ubuntu utopic main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-r14.0.0/ubuntu utopic main
 
   
  +
<div class="mw-collapsible mw-collapsed">
  +
==TDE v3.5.13.x==
  +
<div class="mw-collapsible-content">
  +
Packages for older TDE versions are available for the following Ubuntu distributions:
   
  +
{| class="wikitable"
==For Trusty (Ubuntu 14.04 LTS)==
 
  +
! Version
'''TDE R14.0.0'''
 
  +
! Architectures
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-r14.0.0/ubuntu trusty main
 
  +
! Notes
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-r14.0.0/ubuntu trusty main
 
  +
|-
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-r14.0.0/ubuntu trusty main
 
  +
| 13.04 - Raring
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-r14.0.0/ubuntu trusty main
 
  +
| amd64, i386
  +
| up to v3.5.13
  +
|-
  +
| 12.04 - Precise
  +
| amd64, i386
  +
| up to v3.5.13
  +
|-
  +
| 10.04 - Lucid
  +
| amd64, i386
  +
| up to v3.5.13
  +
|}
  +
</div></div>
   
  +
=Setup Ubuntu Universe and Multiverse repositories=
   
  +
As root (e.g. using sudo), uncomment (remove the # marks from) the lines of your <tt>/etc/apt/sources.list</tt> file that include Universe and Multiverse
==For Saucy (Ubuntu 13.10)==
 
'''TDE R14.0.0'''
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-r14.0.0/ubuntu saucy main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-r14.0.0/ubuntu saucy main
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-r14.0.0/ubuntu saucy main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-r14.0.0/ubuntu saucy main
 
   
  +
If your system does not contain entries for Universe and Multiverse, append "universe multiverse" to your main Ubuntu repository line.
   
  +
Alternatively, you may use graphical tools or other tutorials to enable the Universe and Multiverse repositories.
==For Raring (Ubuntu 13.04)==
 
'''TDE R14.0.0'''
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-r14.0.0/ubuntu raring main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-r14.0.0/ubuntu raring main
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-r14.0.0/ubuntu raring main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-r14.0.0/ubuntu raring main
 
   
  +
=Setup Ubuntu Recommended Updates repository=
'''TDE v3.5.13.2'''
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-v3.5.13/ubuntu raring main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-v3.5.13/ubuntu raring main
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-v3.5.13/ubuntu raring main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-v3.5.13/ubuntu raring main
 
   
  +
As root (e.g. using sudo), uncomment (remove the # marks from) the lines of your <tt>/etc/apt/sources.list</tt> file that include <tt>-updates</tt>.
   
  +
If your system does not contain entries for <tt>-updates</tt>, copy your main Ubuntu repository line to the end of the <tt>/etc/apt/sources.list</tt> file and append <tt>-updates</tt> to the distribution name.
==For Quantal (Ubuntu 12.10)==
 
'''TDE R14.0.0'''
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-r14.0.0/ubuntu quantal main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-r14.0.0/ubuntu quantal main
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-r14.0.0/ubuntu quantal main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-r14.0.0/ubuntu quantal main
 
   
  +
Alternatively, you may use graphical tools or other tutorials to enable the Recommended Updates repository.
'''TDE v3.5.13.2'''
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-v3.5.13/ubuntu quantal main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-v3.5.13/ubuntu quantal main
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-v3.5.13/ubuntu quantal main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-v3.5.13/ubuntu quantal main
 
   
  +
=Configure the package manager=
   
  +
Add the following lines to your <tt>/etc/apt/sources.list</tt> file.
==For Precise (Ubuntu 12.04 LTS)==
 
'''TDE R14.0.0'''
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-r14.0.0/ubuntu precise main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-r14.0.0/ubuntu precise main
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-r14.0.0/ubuntu precise main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-r14.0.0/ubuntu precise main
 
   
  +
{{WarningBox
'''TDE v3.5.13.2'''
 
  +
|text=Make sure to replace <span style="color:#ff0000">'''<your-distribution-release-name>'''</span> with your actual distribution release name (for example 'jammy' or 'noble')
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-v3.5.13/ubuntu precise main
 
  +
}}
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-v3.5.13/ubuntu precise main
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-v3.5.13/ubuntu precise main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-v3.5.13/ubuntu precise main
 
   
  +
===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
==For Oneiric (Ubuntu 11.10)==
 
  +
deb-src http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-r14.1.x <your-distribution-release-name> main deps
'''TDE R14.0.0'''
 
  +
</syntaxhighlight>
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-r14.0.0/ubuntu oneiric main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-r14.0.0/ubuntu oneiric main
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-r14.0.0/ubuntu oneiric main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-r14.0.0/ubuntu oneiric main
 
   
  +
<div class="mw-collapsible mw-collapsed">
'''TDE v3.5.13.2'''
 
  +
===TDE R14.0.x series===
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-v3.5.13/ubuntu oneiric main
 
  +
<div class="mw-collapsible-content">
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-v3.5.13/ubuntu oneiric main
 
  +
<syntaxhighlight lang="sourceslist">
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-v3.5.13/ubuntu oneiric main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-v3.5.13/ubuntu oneiric 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
   
  +
# 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
  +
</syntaxhighlight>
  +
</div></div>
   
  +
<div class="mw-collapsible mw-collapsed">
==For Natty (Ubuntu 11.04)==
 
'''TDE R14.0.0'''
+
===TDE v3.5.13.x===
  +
<div class="mw-collapsible-content">
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-r14.0.0/ubuntu natty main
 
  +
<syntaxhighlight lang="sourceslist">
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-r14.0.0/ubuntu natty main
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-r14.0.0/ubuntu natty main
+
deb http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-v3.5.13 <your-distribution-release-name> main
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-r14.0.0/ubuntu natty main
+
deb http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-builddeps-v3.5.13 <your-distribution-release-name> main
   
  +
# Optional sources
'''TDE v3.5.13.2'''
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-v3.5.13/ubuntu natty main
+
deb-src http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-v3.5.13 <your-distribution-release-name> main
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-v3.5.13/ubuntu natty main
+
deb-src http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-builddeps-v3.5.13 <your-distribution-release-name> main
  +
</syntaxhighlight>
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-v3.5.13/ubuntu natty main
 
  +
</div></div>
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-v3.5.13/ubuntu natty main
 
   
  +
=Import GPG signing key=
   
  +
The best way to install GPG key is to manually download and install package <code>trinity-keyring</code>. The advantage is that this method of installation is not dependent on the availability of the key server. Another advantage is that the key is not integrated into the global apt keyring, but is installed as a separate file:
==For Maverick (Ubuntu 10.10)==
 
'''TDE R14.0.0'''
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-r14.0.0/ubuntu maverick main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-r14.0.0/ubuntu maverick main
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-r14.0.0/ubuntu maverick main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-r14.0.0/ubuntu maverick main
 
   
  +
<syntaxhighlight lang="shell-session">
'''TDE v3.5.13.2'''
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-v3.5.13/ubuntu maverick main
+
$ wget http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-keyring.deb
  +
$ sudo dpkg -i trinity-keyring.deb
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-v3.5.13/ubuntu maverick main
 
  +
</syntaxhighlight>
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-v3.5.13/ubuntu maverick main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-v3.5.13/ubuntu maverick main
 
   
  +
=Install 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 installation==
==For Lucid (Ubuntu 10.04 LTS)==
 
'''TDE R14.0.0'''
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-r14.0.0/ubuntu lucid main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-r14.0.0/ubuntu lucid main
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-r14.0.0/ubuntu lucid main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-r14.0.0/ubuntu lucid main
 
   
  +
The following steps are suggested for installing the latest version.
'''TDE v3.5.13.2'''
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-v3.5.13/ubuntu lucid main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-v3.5.13/ubuntu lucid main
 
deb http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-v3.5.13/ubuntu lucid main
 
deb-src http://ppa.quickbuild.pearsoncomputing.net/trinity/trinity-builddeps-v3.5.13/ubuntu lucid main
 
   
  +
{{WarningBox
  +
|text=<span style="color:#0000ff">''tde-trinity''</span> package is a comprehensive meta-package. To install only a basic environment, replace <span style="color:#0000ff">''tde-trinity''</span> with <span style="color:#0000ff">''tdebase-trinity''</span> in the instructions below.
  +
}}
   
  +
<syntaxhighlight lang="shell-session">
='''Add the GPG signing key'''=
 
  +
$ sudo apt-get update
  +
$ sudo aptitude install kubuntu-default-settings-trinity kubuntu-desktop-trinity
  +
</syntaxhighlight>
   
  +
===Localization===
sudo apt-key adv --keyserver keyserver.quickbuild.pearsoncomputing.net --recv-keys F5CFC95C
 
  +
{{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>
  +
}}
   
  +
==<span id="TDEUpgrade"></span>Upgrading from an existing installation==
   
  +
The following steps are suggested for upgrading to the latest version.
='''Install Trinity'''=
 
If you are doing a fresh TDE installation, please follow the steps listed below.<br>
 
If you are upgrading from version 3.5.13.x, please follow the instruction under the [[#TDEUpgrade|upgrade]] section.<br>
 
   
  +
{{TipBox
sudo aptitude update
 
  +
|text=Before upgrading from v3.5.13.x (or even KDE3), please make sure to go through this [[Tips_And_Tricks|page]] for useful tips suggested by other TDE users.
sudo aptitude install kubuntu-default-settings-trinity kubuntu-desktop-trinity
 
  +
}}
   
  +
<syntaxhighlight lang="shell-session">
  +
$ sudo apt-get update
  +
$ sudo aptitude full-upgrade
  +
</syntaxhighlight>
   
  +
This will upgrade TDE to the newer version and should complete smoothly.
='''<span id="TDEUpgrade"></span>Upgrade from v3.5.13.x'''=
 
We suggest the following steps for upgrading to the R14.0.0 version.
 
   
  +
If you are upgrading from an existing R14.0.x installation, you are done.
sudo apt-get update
 
sudo aptitude full-upgrade
 
   
  +
<div class="mw-collapsible mw-collapsed">
This will upgrade TDE to the new version and should complete smoothly. After these two steps, some dummy packages may still be installed on your system and could be safely removed. To perform such operation, choose one of the following optional steps.<br>
 
  +
If you are upgrading from v3.5.13.x, after these two steps some dummy packages may still be installed on your system and could be safely removed.
  +
<div class="mw-collapsible-content">
   
*A. If you have previously installed some Trinity meta packages (such as kde-core-trinity, kdeadmin-trinity, ...) use:
+
'''A.''' If you had previously installed some <span style="color:#0000ff">''kde meta packages''</span>, (such as kde-core-trinity, kdeadmin-trinity, ...) use the command below, where <span style="color:#0000ff">''<tde-equivalent-metapackage>''</span> is the equivalent package in R14.0.x (tde-core-trinity, tdeadmin-trinity, ...). Repeat for all meta packages there had been installed.
sudo aptitude install <tde-equivalent-metapackage>
 
where <tde-equivalent-metapackage> is the equivalent package in R14 (tde-core-trinity, tdeadmin-trinity, ...).<br>
 
This should be repeated for all installed meta packages.
 
   
  +
<syntaxhighlight lang="shell-session">
  +
$ sudo aptitude install <tde-equivalent-metapackage>
  +
</syntaxhighlight>
   
*B. Run aptitude in interactive mode, limit the display to '~i-trinity~ddummy" and manually check/delete/upgrade unneeded packages from the ones displayed.
+
'''B.''' Run aptitude in interactive mode, limit the display to <code>~i-trinity~ddummy</code> and manually check/delete/upgrade unneeded packages from the ones displayed.
  +
</div></div>
  +
  +
=Upgrading both Ubuntu and TDE from a previous version=
  +
<div class="mw-collapsible mw-collapsed">
  +
{{WarningBox
  +
|text=Using a live CD to upgrade both Ubuntu and your Trinity installation may break your installation.<br>Instead, please follow these instructions.
  +
}}
  +
<div class="mw-collapsible-content">
  +
  +
1) Make sure you have ''update manager'' installed.
  +
  +
<syntaxhighlight lang="shell-session">
  +
$ sudo apt-get install update-manager
  +
</syntaxhighlight>
  +
  +
2) Run the update-manager through console. Open a terminal and run:
  +
  +
<syntaxhighlight lang="shell-session">
  +
$ update-manager
  +
</syntaxhighlight>
  +
  +
3) Check for updates and install all updates before proceeding. You need to have the latest packages to proceed.
  +
  +
4) Run the distribution upgrade tool. Click the upgrade button. Read the release notes, then let it download the upgrade tool. Authenticate with your password and let the upgrade run.
  +
  +
5) If you are upgrading from KDE 3 or TDE 3.5.x series, on the verification screens make sure there are no kde* packages anymore (for example, kdebase-kde3, kdelibs-kde3, kdebase-trinity, kdelibs-trinity).
  +
  +
6) You can allow the upgrade tool to check for obsolete packages. It should not remove TDE related ones.
  +
</div></div>
  +
  +
=Removing Trinity=
  +
  +
{{TipBox | caption = Note | text = Please read the following instructions completely before starting the removal process.}}
  +
  +
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
  +
  +
<div class="mw-collapsible mw-collapsed">
  +
==Uninstalling packages==
  +
<div class="mw-collapsible-content">
  +
  +
===Using aptitude===
  +
  +
If you have ''aptitude'' installed, you can simply run
  +
  +
<syntaxhighlight lang="shell-session">
  +
$ sudo aptitude purge '~i~Otrinitydesktop'
  +
</syntaxhighlight>
  +
  +
===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 <code>/var/lib/apt/lists</code> and write the result to a new file. The names of these files depend on three factors: The Ubuntu 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 Ubuntu Lunar, the names are as follows:
  +
* <code>mirror.ppa.trinitydesktop.org_trinity_deb_trinity-r14.1.x_dists_lunar_main_binary-i386_Packages</code>
  +
* <code>mirror.ppa.trinitydesktop.org_trinity_deb_trinity-builddeps-r14.1.x_dists_lunar_main_binary-i386_Packages</code>
  +
  +
First, let's create a new empty file in <code>/tmp</code>, using <code>mktemp</code>:
  +
  +
<syntaxhighlight lang="shell-session">
  +
$ mktemp /tmp/tde.XXXX
  +
/tmp/tde.fB6B
  +
</syntaxhighlight>
  +
  +
Generating a list of all Trinity packages and writing it to that file now works as follows:
  +
  +
<syntaxhighlight lang="shell-session">
  +
$ sed -n '/^Package: / s/^Package: //p' /var/lib/apt/lists/mirror.ppa.trinitydesktop.org_trinity_deb_trinity-*Packages > /tmp/tde.fB6B
  +
</syntaxhighlight>
  +
  +
Be sure to replace the output file's name with the actual name of the file <code>mktemp</code> created on your system.
  +
  +
Now that we have a list of all TDE packages, we can hand that to <code>apt-get</code> for uninstallation:
  +
  +
<syntaxhighlight lang="shell-session">
  +
$ sudo apt-get remove $(cat /tmp/tde.fB6B)
  +
</syntaxhighlight>
  +
  +
Replace <code>apt-get remove</code> with <code>apt-get purge</code> 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 <code>mktemp</code> 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 <code>apt autoremove</code> 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 <code>apt-get</code> from using Ctrl + F1..7.
  +
  +
Finally, to uninstall all remaining Trinity dependencies, you will need to run
  +
  +
<syntaxhighlight lang="shell-session">
  +
$ sudo apt-get autoremove
  +
</syntaxhighlight>
  +
  +
In case you also want to remove the configuration files that came with these packages, append <code>--purge</code> to the <code>autoremove</code> command.
  +
  +
{{WarningBox | caption = CAUTION | text = Beware that running <code>apt-get autoremove</code> 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.}}
  +
</div></div>
  +
  +
<div class="mw-collapsible mw-collapsed">
  +
==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>.
  +
</div></div>
  +
  +
<div class="mw-collapsible mw-collapsed">
  +
==Cleaning up the package cache==
  +
<div class="mw-collapsible-content">
  +
  +
If you deactivated/removed the repo from source.list, at least run
  +
  +
<syntaxhighlight lang="shell-session">
  +
$ sudo apt-get autoclean
  +
</syntaxhighlight>
  +
  +
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
  +
  +
<syntaxhighlight lang="shell-session">
  +
$ sudo apt-get clean
  +
</syntaxhighlight>
  +
</div></div>
  +
  +
<div class="mw-collapsible mw-collapsed">
  +
==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.)
  +
</div></div>

Latest revision as of 12:04, 27 October 2024


This page provides instructions to install, upgrade or remove Trinity Desktop Environment on your Ubuntu system.


Available versions

R14.x.y series

Stable versions

Packages for stable versions are available for the following Ubuntu distributions (green rows indicates latest version):

Version Architectures Notes
24.10 - Oracular amd64, ppc64el
24.04 - Noble amd64, ppc64el, arm64, armhf
23.10 - Mantic amd64, ppc64el
23.04 - Lunar amd64, ppc64el
22.04 - Jammy amd64, ppc64el, arm64, armhf
21.10 - Impish amd64, ppc64el up to R14.1.0
21.04 - Hirsute amd64, ppc64el up to R14.0.13
20.10 - Groovy amd64, ppc64el up to R14.0.12
20.04 - Focal amd64, ppc64el, arm64, armhf
19.10 - Eoan amd64, i386, ppc64el up to R14.0.10
19.04 - Disco amd64, i386, ppc64el up to R14.0.9
18.10 - Cosmic amd64, i386, ppc64el up to R14.0.8
18.04 - Bionic amd64, i386, ppc64el, armhf
17.10 - Artful amd64, i386, ppc64el up to R14.0.6
17.04 - Zesty amd64, i386, ppc64el up to R14.0.5
16.10 - Yakkety amd64, i386 up to R14.0.4
16.04 - Xenial amd64, i386, ppc64el, armhf up to R14.1.1
14.04 - Trusty amd64, i386, armhf up to R14.0.11
12.04 - Precise amd64, i386 up to R14.0.8
10.04 - Lucid amd64, i386 up to R14.0.6

Rolling versions

Rolling builds are available for a broader set of versions.

TDE v3.5.13.x

Packages for older TDE versions are available for the following Ubuntu distributions:

Version Architectures Notes
13.04 - Raring amd64, i386 up to v3.5.13
12.04 - Precise amd64, i386 up to v3.5.13
10.04 - Lucid amd64, i386 up to v3.5.13

Setup Ubuntu Universe and Multiverse repositories

As root (e.g. using sudo), uncomment (remove the # marks from) the lines of your /etc/apt/sources.list file that include Universe and Multiverse

If your system does not contain entries for Universe and Multiverse, append "universe multiverse" to your main Ubuntu repository line.

Alternatively, you may use graphical tools or other tutorials to enable the Universe and Multiverse repositories.

Setup Ubuntu Recommended Updates repository

As root (e.g. using sudo), uncomment (remove the # marks from) the lines of your /etc/apt/sources.list file that include -updates.

If your system does not contain entries for -updates, copy your main Ubuntu repository line to the end of the /etc/apt/sources.list file and append -updates to the distribution name.

Alternatively, you may use graphical tools or other tutorials to enable the Recommended Updates repository.

Configure 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 'jammy' or 'noble')

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

TDE v3.5.13.x

deb http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-v3.5.13 <your-distribution-release-name> main
deb http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-builddeps-v3.5.13 <your-distribution-release-name> main

# Optional sources
deb-src http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-v3.5.13 <your-distribution-release-name> main
deb-src http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-builddeps-v3.5.13 <your-distribution-release-name> main

Import GPG signing key

The best way to install GPG key is to manually download and install package trinity-keyring. The advantage is that this method of installation is not dependent on the availability of the key server. Another advantage is that the key is not integrated into the global apt keyring, but is installed as a separate file:

$ wget http://mirror.ppa.trinitydesktop.org/trinity/deb/trinity-keyring.deb
$ sudo dpkg -i trinity-keyring.deb

Install 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.

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 aptitude install kubuntu-default-settings-trinity kubuntu-desktop-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.

Messagebox info.png
Tip
Before upgrading from v3.5.13.x (or even KDE3), please make sure to go through this page for useful tips suggested by other TDE users.
$ sudo apt-get update
$ sudo aptitude full-upgrade

This will upgrade TDE to the newer version and should complete smoothly.

If you are upgrading from an existing R14.0.x installation, you are done.

If you are upgrading from v3.5.13.x, after these two steps some dummy packages may still be installed on your system and could be safely removed.

A. If you had previously installed some kde meta packages, (such as kde-core-trinity, kdeadmin-trinity, ...) use the command below, where <tde-equivalent-metapackage> is the equivalent package in R14.0.x (tde-core-trinity, tdeadmin-trinity, ...). Repeat for all meta packages there had been installed.

$ sudo aptitude install <tde-equivalent-metapackage>

B. Run aptitude in interactive mode, limit the display to ~i-trinity~ddummy and manually check/delete/upgrade unneeded packages from the ones displayed.

Upgrading both Ubuntu and TDE from a previous version

Messagebox warning.png
Warning!
Using a live CD to upgrade both Ubuntu and your Trinity installation may break your installation.
Instead, please follow these instructions.

1) Make sure you have update manager installed.

$ sudo apt-get install update-manager

2) Run the update-manager through console. Open a terminal and run:

$ update-manager

3) Check for updates and install all updates before proceeding. You need to have the latest packages to proceed.

4) Run the distribution upgrade tool. Click the upgrade button. Read the release notes, then let it download the upgrade tool. Authenticate with your password and let the upgrade run.

5) If you are upgrading from KDE 3 or TDE 3.5.x series, on the verification screens make sure there are no kde* packages anymore (for example, kdebase-kde3, kdelibs-kde3, kdebase-trinity, kdelibs-trinity).

6) You can allow the upgrade tool to check for obsolete packages. It should not remove TDE related ones.

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

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:

  1. Generating a list of all packages available from the Trinity repository
  2. Using that list to uninstall all installed packages originating from that repository
  3. 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 Ubuntu 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 Ubuntu Lunar, the names are as follows:

  • mirror.ppa.trinitydesktop.org_trinity_deb_trinity-r14.1.x_dists_lunar_main_binary-i386_Packages
  • mirror.ppa.trinitydesktop.org_trinity_deb_trinity-builddeps-r14.1.x_dists_lunar_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.

Messagebox warning.png
CAUTION
Beware that running 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.)