diff --git a/docs/installation/debian.rst b/docs/installation/debian.rst index 65b46d58..7f25775d 100644 --- a/docs/installation/debian.rst +++ b/docs/installation/debian.rst @@ -16,11 +16,11 @@ from scratch, we have a guide for installing Debian/Raspbian and Mopidy. See The packages are built for: -- Debian jessie (stable), which also works for Raspbian jessie and Ubuntu 14.04 - LTS and newer. +- Debian stretch (stable), which also works for Raspbian stretch and Ubuntu + 16.04 LTS and newer. The packages are available for multiple CPU architectures: i386, amd64, armel, -and armhf (compatible with Raspberry Pi 1 and 2). +and armhf (compatible with all Raspberry Pi models). .. note:: @@ -35,16 +35,17 @@ and armhf (compatible with Raspberry Pi 1 and 2). #. Add the APT repo to your package sources:: - sudo wget -q -O /etc/apt/sources.list.d/mopidy.list https://apt.mopidy.com/jessie.list + sudo wget -q -O /etc/apt/sources.list.d/mopidy.list https://apt.mopidy.com/stretch.list #. Install Mopidy and all dependencies:: sudo apt-get update sudo apt-get install mopidy -#. Finally, you need to set a couple of :doc:`config values `, and then - you're ready to :doc:`run Mopidy ` or run Mopidy as a - :ref:`service `. +#. Finally, you need to set a couple of :doc:`config values `, and + then you're ready to :doc:`run Mopidy `. Alternatively you may + want to have Mopidy run as a :ref:`system service `, automatically + starting at boot. When a new release of Mopidy is out, and you can't wait for you system to figure it out for itself, run the following to upgrade right away:: diff --git a/docs/installation/raspberrypi.rst b/docs/installation/raspberrypi.rst index df6f0cbd..685eb0d0 100644 --- a/docs/installation/raspberrypi.rst +++ b/docs/installation/raspberrypi.rst @@ -5,23 +5,23 @@ Raspberry Pi ************ Mopidy runs on all versions of `Raspberry Pi `_. -However, note that Raspberry Pi 2 B's CPU is approximately six times as -powerful as Raspberry Pi 1 and Raspberry Pi Zero, so Mopidy will be more joyful -to use on a Raspberry Pi 2. +However, note that the Raspberry Pi 2 and 3 are significantly more powerful than +the Raspberry Pi 1 and Raspberry Pi Zero; Mopidy will run noticably faster on +the later models. .. image:: raspberrypi2.jpg :width: 640 :height: 363 -How to for Raspbian Jessie -========================== +How to for Raspbian +=================== -#. Download the latest Jessie or Jessie Lite disk image from +#. Download the latest Raspbian Desktop or Lite disk image from http://www.raspberrypi.org/downloads/raspbian/. - If you're only using your Pi for Mopidy, go with Jessie Lite as you won't - need the full graphical desktop included in the Jessie image. + Unless you need a full graphical desktop the Lite image is preferable since + it's much smaller. #. Flash the Raspbian image you downloaded to your SD card. @@ -32,12 +32,11 @@ How to for Raspbian Jessie You'll need to enable SSH if you are not connecting a monitor and a keyboard. As of the November 2016 release, Raspbian has the SSH server disabled by default. SSH can be enabled by placing a file named 'ssh', without any - extension, onto the boot partition of the SD card. + extension, onto the boot partition of the SD card. See `here + `_ for + more details. -#. If you connect a monitor and a keyboard, you'll see that the Pi boots right - into the ``raspi-config`` tool. - - If you boot with only a network cable connected, you'll have to find the IP +#. If you boot with only a network cable connected, you'll have to find the IP address of the Pi yourself, e.g. by looking in the client list on your router/DHCP server. When you have found the Pi's IP address, you can SSH to the IP address and login with the user ``pi`` and password ``raspberry``. @@ -47,32 +46,37 @@ How to for Raspbian Jessie #. Use the ``raspi-config`` tool to setup the basics of your Pi. You might want to do one or more of the following: - - Expand the file system to fill the SD card. - Change the password of the ``pi`` user. - - Change the time zone. + - Change the language, time zone, etc. Under "Advanced Options": - Set a hostname. - Enable SSH if not already enabled. - - If your will use HDMI for display and 3.5mm jack for audio, force the - audio output to the 3.5mm jack. By default it will use HDMI for audio - output if an HDMI cable is connected and the 3.5mm jack if not. + - Force a specific audio output. + By default, when using a HDMI display the + audio will also be output over HDMI, otherwise the 3.5mm jack will be used. + - Adjust the memory split. + If you're not using a display (i.e. Raspbian + Lite), you should set the minimum value here in order to make best use of + the available RAM. - Once done, select "Finish" and restart your Pi. + Once done, select "Finish". Depending on what you changed you may be asked if + you want to restart your Pi, select "Yes" and then log back in again + afterwards. If you want to change any settings later, you can simply rerun ``sudo raspi-config``. -#. Once you've rebooted and has logged in as the ``pi`` user, you can enter - ``sudo -i`` to become ``root``. -#. Install Mopidy and its dependencies as described in :ref:`debian-install`. +#. Install Mopidy and any Mopidy extensions you want, as described in + :ref:`debian-install`. -#. Finally, you need to set a couple of :doc:`config values `, and - then you're ready to :doc:`run Mopidy `. Alternatively you may - want to have Mopidy run as a :ref:`system service `, automatically - starting at boot. +.. note:: + + If you used the Raspbian *Desktop* image you may also need to add the + ``mopidy`` user to the ``video`` group. Run ``sudo adduser mopidy video`` + to do this. Testing sound output @@ -84,10 +88,5 @@ You can test sound output independent of Mopidy by running:: If you hear a voice saying "Front Center", then your sound is working. -If you want to change your audio output setting, simply rerun ``sudo -raspi-config``. Alternatively, you can change the audio output setting -directly by running: - -- Auto (HDMI if connected, else 3.5mm jack): ``sudo amixer cset numid=3 0`` -- Use 3.5mm jack: ``sudo amixer cset numid=3 1`` -- Use HDMI: ``sudo amixer cset numid=3 2`` +If you want to change your audio output setting, simply rerun ``sudo +raspi-config``.