owntone-server/docs/installation.md

# How to get and install OwnTone

You can compile and run OwnTone on pretty much any Linux- or BSD-platform. The
instructions are [here](building.md).

Apt repositories, images and precompiled binaries are available for some
platforms. These can save you some work and make it easier to stay up to date:

|Platform              | How to get
|----------------------|---------------------------------------------------------
|RPi w/Raspberry Pi OS | Add OwnTone repository to apt sources<br>(See: [Raspberry Pi Forums](http://www.raspberrypi.org/phpBB3/viewtopic.php?t=49928))
|Debian/Ubuntu amd64   | Download the .deb package as artifact from the [Github workflow](https://github.com/owntone/owntone-apt/actions)<br>(requires that you are logged in)
|OpenWrt               | Run `opkg install libwebsockets-full owntone`
|Docker / Podman       | See [official image](https://github.com/owntone/owntone-container)<br>See [alternate image](https://github.com/linuxserver/docker-daapd)
|FreeBSD               | Run `pkg install owntone` (See: [FreeBSD ports](https://cgit.freebsd.org/ports/tree/audio/owntone))

OwnTone is not in the official Debian repositories due to lack of Debian
maintainer and Debian policy difficulties concerning the web UI, see
[this issue](https://github.com/owntone/owntone-server/issues/552).
[docs] Simplify install instructions Many users probably just want the simple apt approach for RPi, or alternatively some other precomiled solution, so let installation.md focus on them and put the build instructions in a separate building.md. 2022-12-20 11:14:12 -05:00			`# How to get and install OwnTone`

			`You can compile and run OwnTone on pretty much any Linux- or BSD-platform. The`
[docs] Fix markdown 2022-12-20 11:40:57 -05:00			`instructions are [here](building.md).`
[docs] Simplify install instructions Many users probably just want the simple apt approach for RPi, or alternatively some other precomiled solution, so let installation.md focus on them and put the build instructions in a separate building.md. 2022-12-20 11:14:12 -05:00
			`Apt repositories, images and precompiled binaries are available for some`
			`platforms. These can save you some work and make it easier to stay up to date:`

[docs] Add Docker / Podman package 2024-02-28 10:47:22 -05:00			`\|Platform \| How to get`
			`\|----------------------\|---------------------------------------------------------`
			`\|RPi w/Raspberry Pi OS \| Add OwnTone repository to apt sources<br>(See: [Raspberry Pi Forums](http://www.raspberrypi.org/phpBB3/viewtopic.php?t=49928))`
			`\|Debian/Ubuntu amd64 \| Download the .deb package as artifact from the [Github workflow](https://github.com/owntone/owntone-apt/actions)<br>(requires that you are logged in)`
			\|OpenWrt \| Run `opkg install libwebsockets-full owntone`
			`\|Docker / Podman \| See [official image](https://github.com/owntone/owntone-container)<br>See [alternate image](https://github.com/linuxserver/docker-daapd)`
			\|FreeBSD \| Run `pkg install owntone` (See: [FreeBSD ports](https://cgit.freebsd.org/ports/tree/audio/owntone))
[docs] Simplify install instructions Many users probably just want the simple apt approach for RPi, or alternatively some other precomiled solution, so let installation.md focus on them and put the build instructions in a separate building.md. 2022-12-20 11:14:12 -05:00
			`OwnTone is not in the official Debian repositories due to lack of Debian`
			`maintainer and Debian policy difficulties concerning the web UI, see`
			`[this issue](https://github.com/owntone/owntone-server/issues/552).`