Skip to content
The templates of the emrah-buster installer.
Shell Python JavaScript HTML CSS PHP
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
installer
installer_sub_scripts
machines
.gitignore
LICENSE
README.md

README.md

Table of contents


About

emrah-buster is an installer to create the containerized systems on Debian Buster host. It built on top of LXC (Linux containers). This repository contains the emrah-buster templates.

Usage

Download the installer, run it with a template name as an argument and drink a coffee. That's it.

wget https://raw.githubusercontent.com/emrahcom/emrah-buster-base/master/installer/eb
wget https://raw.githubusercontent.com/emrahcom/emrah-buster-templates/master/installer/<TEMPLATE_NAME>.conf
bash eb <TEMPLATE_NAME>

Example

To install a streaming media system, login a Debian Buster host as root and

wget https://raw.githubusercontent.com/emrahcom/emrah-buster-base/master/installer/eb
wget https://raw.githubusercontent.com/emrahcom/emrah-buster-templates/master/installer/eb-livestream.conf
bash eb eb-livestream

Available templates

eb-base

Install only a containerized Debian Buster.

To install eb-base

wget https://raw.githubusercontent.com/emrahcom/emrah-buster-base/master/installer/eb
wget https://raw.githubusercontent.com/emrahcom/emrah-buster-templates/master/installer/eb-base.conf
bash eb eb-base

eb-livestream

Install a ready-to-use live streaming media system.

Main components of eb-livestream

  • Nginx server with nginx-rtmp-module as a stream origin. It gets the RTMP stream and convert it to HLS and DASH.

  • Nginx server with standart modules as a stream edge. It publish the HLS and DASH stream.

  • Web based HLS video player.

  • Web based DASH video player.

To install eb-livestream

wget https://raw.githubusercontent.com/emrahcom/emrah-buster-base/master/installer/eb
wget https://raw.githubusercontent.com/emrahcom/emrah-buster-templates/master/installer/eb-livestream.conf
bash eb eb-livestream

After install eb-livestream

  • rtmp://<IP_ADDRESS>/livestream/<CHANNEL_NAME> to push an RTMP stream.

  • http://<IP_ADDRESS>/livestream/hls/<CHANNEL_NAME>/index.m3u8 to pull the HLS stream.

  • http://<IP_ADDRESS>/livestream/dash/<CHANNEL_NAME>/index.mpd to pull the DASH stream.

  • http://<IP_ADDRESS>/livestream/hlsplayer/<CHANNEL_NAME> for the HLS video player page.

  • http://<IP_ADDRESS>/livestream/dashplayer/<CHANNEL_NAME> for the DASH video player page.

  • http://<IP_ADDRESS>:8000/livestream/status for the RTMP status page.

  • http://<IP_ADDRESS>:8000/livestream/cloner for the stream cloner page. Thanks to nejdetckenobi

Related links to eb-livestream


eb-gitea

Install a ready-to-use self-hosted Git service. Only AMD64 architecture is supported for this template. Please contact me if you need eb-gitea for an other architecture.

Main components of eb-gitea

To install eb-gitea

wget https://raw.githubusercontent.com/emrahcom/emrah-buster-base/master/installer/eb
wget https://raw.githubusercontent.com/emrahcom/emrah-buster-templates/master/installer/eb-gitea.conf
bash eb eb-gitea

After install eb-gitea

There is one more step to finish the installation. It's needed to fill the initial configuration form of Gitea. Only two fields will be changed: SSH Server Domain and Gitea Base URL.

Very easy!

  • Access https://<IP_ADDRESS>/install to fill the Gitea config form.

  • SSH Server Domain: Write your host FQDN or IP address. Examples:
    git.mydomain.com
    123.2.3.4

  • Gitea Base URL: Write your URL. HTTP and HTTPS are OK. Examples:
    https://git.mydomain.com/
    https://123.2.3.4/

  • Don't change the other fields. They are all OK.

  • The first registered user will be the administrator.


Let's Encrypt support

To use Let's Encrypt certificate, connect to the related container as root and

FQDN="your.host.fqdn"

certbot certonly --webroot -w /var/www/html -d $FQDN

chmod 750 /etc/letsencrypt/{archive,live}
chown root:ssl-cert /etc/letsencrypt/{archive,live}
rm -f /etc/ssl/certs/ssl-eb.pem
rm -f /etc/ssl/private/ssl-eb.key
ln -s /etc/letsencrypt/live/$FQDN/fullchain.pem \
    /etc/ssl/certs/ssl-eb.pem
ln -s /etc/letsencrypt/live/$FQDN/privkey.pem \
    /etc/ssl/private/ssl-eb.key

systemctl restart nginx.service

Requirements

emrah-buster requires a Debian Buster host with a minimal install and the Internet access during the installation. It's not a good idea to use your desktop machine or an already in-use production server as a host machine. Please, use one of the followings as a host:

  • a cloud host from a hosting/cloud service (Digital Ocean's droplet, Amazon EC2 instance etc)

  • a virtual machine (VMware, VirtualBox etc)

  • a Debian Buster container

  • a physical machine with a fresh installed Debian Buster

You can’t perform that action at this time.