manual/include/ubuntu-linux.html

<p>
  <dfn>Ubuntu Linux</dfn> is the most popular variety of Linux in use on
  desktop and laptop systems. It has the backing of a for-profit corporation
  (Canonical Inc.), a defined philosophy and a huge and worldwide user base. As
  a result, it is a common platform for people who want to use Ardour and other
  tools for music creation and pro-audio work.
</p>

<h2>High Level Recommendations for Ubuntu Users</h2>

<p>
  Currently, installing pro audio applications on vanilla Ubuntu requires some
  configuration, in order for the user to gain realtime privilege (read below).
  Ubuntu Studio, which is an official flavor of Ubuntu, and thus shares the
  repositories with Ubuntu, has this already configured. Other distributions,
  such as KXStudio, and Dreamstudio are largely based on Ubuntu, and like
  Ubuntu Studio, has these settings pre-configured, while also containing
  customized versions of Ubuntu packages, which often are more up to date.
</p>

<h2>Installing Ardour</h2>

<p>
  There may be unintended differences, and even bugs in Ubuntu native packages,
  as a result of a different building method. For this reason, Ardour
  developers highly recommend installing the official ready-to-run version of
  the program that can be downloaded from <a
  href="https://community.ardour.org/download">ardour.org</a>, as Ubuntu native
  packages are not supported in the official Ardour forums or other support
  channels.
</p>

<p>
  Follow these steps to install the latest version of Ardour:
</p>

<ol>
  <li>Download the latest release from <a
  href="https://community.ardour.org/download">ardour.org</a>.</li>
  <li><kbd class="mouse">Right</kbd>-click the downloaded file and choose
  properties.</li>
  <li>Click the Permissions tab and check the option "Allow this file to run as
  a program".</li>
  <li>Close the dialog and double-click the file.</li>
  <li>Follow the prompts.</li>
</ol>

<h2>Problems with JACK configuration</h2>

<h3>What is the problem?</h3>

<p>
  To function as intended, JACK needs to run with access to two operating
  system facilities called <dfn>realtime scheduling</dfn> and <dfn>memory locking</dfn>. This means that the user who starts JACK <em>must</em> be
  allowed access to these facilities. By default, Ubuntu does create a user
  group that has this permission but&mdash;it does not put new users into this
  group by default. Read more about why <a
  href="https://wiki.ubuntu.com/Audio/TheAudioGroup">here</a>. Consequently,
  the user will not have permission to run JACK in the way they should.
</p>

<h3>Symptoms</h3>

<p>
  A message like <samp>Cannot lock down memory</samp> in the output from JACK
  as it starts up. This output may be hidden in the Messages window of QJackCtl
  (aka JACK Control), so one should check there.
</p>

<h3>How to fix</h3>

<p>
  Make sure the file /etc/security/limits.d/audio.conf exists. If it is named
  /etc/security/limits.d/audio.conf.disabled, rename it to the former. Run the
  command:
</p>

<kbd class="cmd lin">sudo usermod -a -G audio <em>YOUR-LOGIN-NAME</em></kbd>

<p>
  Then log out and log in again. On Ubuntu Studio the user is a member of audio
  group by default, but not on other official flavors.
</p>

<h2>Reporting Issues</h2>

<p>
  Given the difficulties in supporting Ubuntu and the limited time and
  resources of the Ardour team, the <dfn>Ubuntu Studio Project</dfn> has
  requested that issues and bug reports related to Ubuntu, Ubuntu Studio and
  other derivatives be directed to them.
</p>

<h3>Contact Information for Ubuntu Studio</h3>

<p>
  <a href="http://ubuntustudio.org">The Ubuntu Studio Homepage</a>
</p>

<p>
  <a href="http://ubuntuforums.org/forumdisplay.php?f=335">The Ubuntu Studio
  Forums.</a>
</p>

<p>
  <a href="https://help.ubuntu.com/community/UbuntuStudio/MailLists">Information
  on the Ubuntu Studio Mailing Lists.</a>
</p>

<p>
  <a href="https://help.ubuntu.com/community/UbuntuStudio/IRC">Information on
  the Ubuntu Studio IRC channel.</a> #ubuntustudio on irc.freenode.net
</p>