f87977b80f
Could load the theme from an external repo, so everything will need to fit in here. Can be built locally, though.
254 lines
11 KiB
HTML
254 lines
11 KiB
HTML
<!doctype html>
|
|
<html lang="en">
|
|
<head>
|
|
<!-- Required meta tags -->
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
|
|
|
|
<!-- Bootstrap CSS -->
|
|
<link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.5.0/css/bootstrap.min.css" integrity="sha384-9aIt2nRpC12Uk9gS9baDl411NQApFmC26EwAOH8WgZl5MYYxFfc+NcPb1dKGj7Sk" crossorigin="anonymous">
|
|
|
|
<!-- Custom fonts for this template -->
|
|
<link href="vendor/fontawesome-free/css/all.min.css" rel="stylesheet" type="text/css">
|
|
<link href='https://fonts.googleapis.com/css?family=Open+Sans:300italic,400italic,600italic,700italic,800italic,400,300,600,700,800' rel='stylesheet' type='text/css'>
|
|
<link href='https://fonts.googleapis.com/css?family=Merriweather:400,300,300italic,400italic,700,700italic,900,900italic' rel='stylesheet' type='text/css'>
|
|
|
|
<!-- Plugin CSS -->
|
|
<link href="vendor/magnific-popup/magnific-popup.css" rel="stylesheet">
|
|
|
|
<!-- Custom styles for this template -->
|
|
<link href="css/creative.min.css" rel="stylesheet">
|
|
|
|
<style>
|
|
header.masthead {
|
|
padding-top: 10rem;
|
|
padding-bottom: calc(10rem - 56px);
|
|
background-image: url("img/header.jpg");
|
|
background-position: center center;
|
|
background-size: cover;
|
|
}
|
|
.bg-dark{
|
|
padding:2rem 0
|
|
}
|
|
</style>
|
|
|
|
<title>LibreTime Radio Automation - Using Vagrant and Virturalbox for developing LibreTime</title>
|
|
</head>
|
|
<body id="page-top">
|
|
|
|
<!-- Navigation -->
|
|
<nav class="navbar navbar-expand-lg navbar-light fixed-top navbar-shrink" id="mainNav">
|
|
<div class="container">
|
|
<a class="navbar-brand js-scroll-trigger" href="index"> LibreTime Radio Automation </a>
|
|
<button class="navbar-toggler navbar-toggler-right" type="button" data-toggle="collapse" data-target="#navbarResponsive" aria-controls="navbarResponsive" aria-expanded="false" aria-label="Toggle navigation">
|
|
<span class="navbar-toggler-icon"></span>
|
|
</button>
|
|
<div class="collapse navbar-collapse" id="navbarResponsive">
|
|
<ul class="navbar-nav ml-auto">
|
|
|
|
<li class="nav-item">
|
|
<a class="nav-link js-scroll-trigger" href="quickstart">Install</a>
|
|
</li>
|
|
|
|
<li class="nav-item">
|
|
<a class="nav-link js-scroll-trigger" href="features">Features</a>
|
|
</li>
|
|
|
|
<li class="nav-item">
|
|
<a class="nav-link js-scroll-trigger" href="tour">Tour</a>
|
|
</li>
|
|
|
|
<li class="nav-item">
|
|
<a class="nav-link js-scroll-trigger" href="faq">FAQ</a>
|
|
</li>
|
|
|
|
<li class="nav-item">
|
|
<a class="nav-link js-scroll-trigger" href="advanced-configuration">Docs</a>
|
|
</li>
|
|
|
|
<li class="nav-item">
|
|
<a class="nav-link js-scroll-trigger" href="contribute">Help Us!</a>
|
|
</li>
|
|
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</nav>
|
|
|
|
<div class="container-lg">
|
|
<nav class="content">
|
|
<html>
|
|
<head>
|
|
<style>
|
|
section{padding:4rem 0}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
|
|
<section class="bg-primary">
|
|
<div class="container">
|
|
<div class="row">
|
|
<div class="col-lg-8 mx-auto text-center">
|
|
<h2 class="section-heading text-white"> Using Vagrant and Virturalbox for developing LibreTime </h2>
|
|
<hr class="light my-4">
|
|
<p class="text-faded mb-4">
|
|
The fastest way to get LibreTime up and running in a way to hack on its source code or to test it locally.
|
|
</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<blockquote>
|
|
<p>Prerequisites: git, <a href="https://vagrantup.com">Vagrant</a>, libvirt or VirturalBox</p>
|
|
</blockquote>
|
|
|
|
<h3 id="virtual-box">Virtual Box</h3>
|
|
|
|
<p>You will need to install <a href="https://www.virtualbox.org">VirtualBox</a> and may want to consider
|
|
installing <a href="https://github.com/dotless-de/vagrant-vbguest">vagrant-vbguest</a> to update the
|
|
guest extensions to match your host system on vagrant up.</p>
|
|
|
|
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>vagrant plugin <span class="nb">install </span>vagrant-vbguest
|
|
</code></pre></div></div>
|
|
|
|
<h3 id="libvirt">Libvirt</h3>
|
|
|
|
<p>Setting the libvirt provider up on (Ubuntu and Debian)[#Ubuntu and Debian] is straight
|
|
forward, using the distribution provided packages. While on
|
|
(Other Distributions)[#Other Distributions] it can be built from within vagrant.</p>
|
|
|
|
<p>If you try run a libvirt provided box after using a VirtualBox one, you will receive an
|
|
error:</p>
|
|
|
|
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Error while activating network:
|
|
Call to virNetworkCreate failed: internal error: Network is already in use by interface vboxnet0.
|
|
</code></pre></div></div>
|
|
|
|
<p>This is fixed by stopping virtualbox and re-creating the vagrant box:</p>
|
|
|
|
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo systemctl stop virtualbox
|
|
vagrant destroy ubuntu-xenial
|
|
vagrant up ubuntu-xenial --provider=libvirt
|
|
</code></pre></div></div>
|
|
|
|
<h4 id="debian-and-ubuntu">Debian and Ubuntu</h4>
|
|
|
|
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>apt <span class="nb">install </span>vagrant vagrant-libvirt libvirt-daemon-system vagrant-mutate libvirt-dev
|
|
<span class="nb">sudo </span>usermod <span class="nt">-a</span> <span class="nt">-G</span> libvirt <span class="nv">$USER</span>
|
|
|
|
<span class="c"># Reboot</span>
|
|
|
|
vagrant box add bento/ubuntu-16.04 <span class="nt">--provider</span><span class="o">=</span>virtualbox
|
|
vagrant mutate bento/ubuntu-16.04 libvirt
|
|
vagrant up ubuntu-xenial <span class="nt">--provider</span><span class="o">=</span>libvirt
|
|
</code></pre></div></div>
|
|
|
|
<h4 id="other-distributions">Other Distributions</h4>
|
|
|
|
<p>You will need to install <a href="https://libvirt.org/">libvirt</a> and <code class="highlighter-rouge">vagrant-mutate</code> and then run</p>
|
|
|
|
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>vagrant plugin <span class="nb">install </span>vagrant-libvirt
|
|
<span class="nb">sudo </span>usermod <span class="nt">-a</span> <span class="nt">-G</span> libvirt <span class="nv">$USER</span>
|
|
|
|
<span class="c"># Reboot</span>
|
|
|
|
vagrant plugin <span class="nb">install </span>vagrant-mutate
|
|
vagrant box fetch bento/ubuntu-16.04
|
|
vagrant mutate bento/ubuntu-16.04 libvirt
|
|
vagrant up ubuntu-xenial <span class="nt">--provider</span><span class="o">=</span>libvirt
|
|
</code></pre></div></div>
|
|
|
|
<h2 id="starting-libretime-vagrant">Starting LibreTime Vagrant</h2>
|
|
|
|
<p>To get started you clone the repo and run <code class="highlighter-rouge">vagrant up</code>. The command accepts a parameter to
|
|
change the default provider if you have multiple installed. This can be done by appending
|
|
<code class="highlighter-rouge">--provider=virtualbox</code> or <code class="highlighter-rouge">--provider=libvirt</code> as applicable.</p>
|
|
|
|
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>git clone https://github.com/libretime/libretime.git
|
|
<span class="nb">cd </span>libretime
|
|
vagrant up ubuntu-xenial
|
|
</code></pre></div></div>
|
|
|
|
<p>If everything works out, you will find LibreTime on <a href="http://localhost:8080">port 8080</a>,
|
|
icecast on <a href="http://localhost:8000">port 8000</a> and the docs on
|
|
<a href="http://localhost:8888">port 8888</a>.</p>
|
|
|
|
<p>Once you reach the web setup GUI you can click through it using the default values. To
|
|
connect to the vagrant machine you can run <code class="highlighter-rouge">vagrant ssh ubuntu-xenial</code> in the libretime
|
|
directory.</p>
|
|
|
|
<h2 id="alternative-os-installations">Alternative OS installations</h2>
|
|
|
|
<p>With the above instructions LibreTime is installed on Ubuntu Xenial Xerus. The Vagrant setup
|
|
offers the option to choose a different operation system according to you needs.</p>
|
|
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>OS</th>
|
|
<th>Command</th>
|
|
<th>Comment</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td>Debian 10</td>
|
|
<td><code class="highlighter-rouge">vagrant up debian-buster</code></td>
|
|
<td>Install on Debian Buster.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Debian 9</td>
|
|
<td><code class="highlighter-rouge">vagrant up debian-stretch</code></td>
|
|
<td>Install on current Debian Stretch. Needs manual intervention due to Liquidsoap 1.3.3.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Ubuntu 18.04</td>
|
|
<td><code class="highlighter-rouge">vagrant up ubuntu-bionic</code></td>
|
|
<td>Install on current Ubuntu Bionic Beaver.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Ubuntu 16.04</td>
|
|
<td><code class="highlighter-rouge">vagrant up ubuntu-xenial</code></td>
|
|
<td>Install on Ubuntu Xenial Xerus.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>CentOS</td>
|
|
<td><code class="highlighter-rouge">vagrant up centos</code></td>
|
|
<td>Extremely experimental install on 7.3 with native systemd support and activated SELinux. Needs manual intervention due to Liquidsoap 1.3.3.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
<h2 id="troubleshooting">Troubleshooting</h2>
|
|
|
|
<p>If anything fails during the initial provisioning step you can try running <code class="highlighter-rouge">vagrant provision</code>
|
|
to re-run the installer.</p>
|
|
|
|
<p>If you only want to re-run parts of the installer, use <code class="highlighter-rouge">--provision-with $step</code>. The
|
|
supported steps are <code class="highlighter-rouge">prepare</code>, <code class="highlighter-rouge">install</code>, <code class="highlighter-rouge">install-mkdocs</code> and <code class="highlighter-rouge">start-mkdocs</code>.</p>
|
|
|
|
|
|
</body>
|
|
</html>
|
|
|
|
</nav>
|
|
</div>
|
|
|
|
<footer>
|
|
<section class="bg-dark text-white">
|
|
<div class="text-footer">
|
|
<small>Hosted on GitHub Pages — Theme by <a href="https://github.com/ned-kelly">ned-kelly</a> and <a href="https://github.com/zklosko">Zachary Klosko</a> | </small>
|
|
<small>Code and docs licensed under GPLv2. More details <a href="http://sourcefabric.booktype.pro/airtime-25-for-broadcasters/about-this-manual/">here</a>. </small>
|
|
</div>
|
|
</section>
|
|
</footer>
|
|
|
|
<!-- Optional JavaScript -->
|
|
<!-- jQuery first, then Popper.js, then Bootstrap JS -->
|
|
<script src="https://code.jquery.com/jquery-3.5.1.slim.min.js" integrity="sha384-DfXdz2htPH0lsSSs5nCTpuj/zy4C+OGpamoFVy38MVBnE+IbbVYUew+OrCXaRkfj" crossorigin="anonymous"></script>
|
|
<script src="https://cdn.jsdelivr.net/npm/popper.js@1.16.0/dist/umd/popper.min.js" integrity="sha384-Q6E9RHvbIyZFJoft+2mJbHaEWldlvI9IOYy5n3zV9zzTtmI3UksdQRVvoxMfooAo" crossorigin="anonymous"></script>
|
|
<script src="https://stackpath.bootstrapcdn.com/bootstrap/4.5.0/js/bootstrap.min.js" integrity="sha384-OgVRvuATP1z7JjHLkuOU7Xw704+h835Lr+6QL9UvYjZE3Ipu6Tp75j7Bh/kR0JKI" crossorigin="anonymous"></script>
|
|
</body>
|
|
</html>
|