Home.md

+CDS software packages
+=====================
+
+This page describes how to use the CDS Debian software archives.  Debian is the primary supported operating system the Advanced LIGO Real Time System (RTS).
+
+Currently the targeted Debian version is [Debian 9 "stretch"](https://www.debian.org/releases/stretch/), but we plan on supporting [Debian 10 "buster"](https://www.debian.org/releases/buster/) soon.  The following assumes that you already have the appropriate Debian system installed.
+
+CDS workstation software is also currently supported on Scientific Linux 7.  Please see the [Scientific Linux 7 CDS workstation install](https://cdswiki.ligo-la.caltech.edu/foswiki/bin/view/CDS/StandaloneOffsiteWorkstationInstallationSL7) page for information about installations on that platform.
+
+Please report packaging issues either to the relevant [CDS project](https://git.ligo.org/groups/cds/-/issues) or to the [CDS packaging project](https://git.ligo.org/groups/cds-packaging/-/issues) for support third-party software.
+
+Adding LSCSoft archives
+-----------------------
+
+Some packages from LSCSoft are required for various CDS packages.  See [Instructions for enabling LSCSoft debian archive](https://wiki.ligo.org/Computing/DASWG/DebianJessie).
+
+The basic procedure is to add the LSCSoft archive for your distribution (say "stretch") in "/etc/apt/sources.list.d/lscsoft.list":
+```
+deb http://software.ligo.org/lscsoft/debian/ stretch contrib
+```
+and then update and pull in the lscsoft keyring package:
+```shell
+$ sudo apt-get update --allow-insecure-repositories
+$ sudo apt-get -y --force-yes install lscsoft-archive-keyring
+```
+
+Adding CDS archives
+-------------------
+
+CDSSoft provides "cdssoft-release-<release>" packages that handle setting up the sources, adding keys, pinning, etc.:
+
+* [cdssoft-release-stretch](http://apt.ligo-wa.caltech.edu/debian/pool/stretch-unstable/cdssoft-release-stretch/cdssoft-release-stretch_1.3.2_all.deb)
+
+In order to install first download manually with e.g. wget, then install the package manually with dpkg:
+
+```shell
+$ wget -c http://apt.ligo-wa.caltech.edu/debian/pool/stretch-unstable/cdssoft-release-stretch/cdssoft-release-stretch_1.3.2_all.deb
+$ sudo dpkg -i cdssoft-release-stretch_1.3.2_all.deb
+$ sudo apt update
+```
+
+At this point you should be able to start installing packages:
+```shell
+$ sudo apt install cds-workstation
+```
+
+CDS "restricted" archives
+-------------------------
+
+Software that LIGO is not legally allowed to redistribute (such as the Dolphin IX drivers) are available in a restricted archive.  The best way to enable this archive is to create a separate sources list for restricted archive:
+```shell
+# /etc/apt/sources.list.d/cdssoft-restricted.list 
+deb [signed-by=/usr/share/keyrings/cdssoft-unstable-archive-keyring.gpg] https://$USER:$PASSWORD@apt.ligo-wa.caltech.edu/debian stretch-restricted main
+```
+The value of $USER and $PASSWORD can be found in the ["CDS licensed repositories"](https://secrets.ligo.org/secrets/163/) secret in the LIGO Shared Secrets page.
\ No newline at end of file