Home
Softono

Emrah Buster Templates

Open source Shell
GitHub
61
Stars
40
Forks
1
Issues
11
Watchers
2 years
Last Commit
PaaS & Self-hosting DevOps & Infrastructure

 About Emrah Buster Templates

The templates of the emrah-buster installer.

Platforms

Web Self-hosted Docker Linux

Languages

Shell

Links

Source Code

Need Help Installing Emrah Buster Templates?

We provide expert installation service for this software. Our team will install, configure, and secure Emrah Buster Templates on your server. plans start at just $30.

Hire an Expert
Published by
emrahcom
Visit View Profile

Emrah Buster Templates

View on GitHub

Table of contents

About

emrah-buster is an installer to create the containerized systems on Debian Buster (version 10) 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 (version 10) 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. See the livestream page for details.

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 installing 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 installing 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.

Customizing eb-gitea

Edit /home/gitea/custom/conf/app.ini file and restart the service to customize Gitea. These are the customized settings of my private server. See cheat-sheet for more details.

  • PASSWORD_COMPLEXITY = lower,upper,digit
  • FORCE_PRIVATE = true
  • DEFAULT_PRIVATE = true
  • DISABLE_REGISTRATION = true
  • REQUIRE_SIGNIN_VIEW = true
  • DEFAULT_KEEP_EMAIL_PRIVATE = true
  • [mailer] ENABLED = true
  • [mailer] HOST = my-smtp-server.domain.com:587
  • [mailer] FROM = [email protected]
  • [mailer] USER = [email protected]
  • [mailer] PASSWD = my-secret

eb-jitsi

Install a ready-to-use self-hosted Jitsi/Jibri service.

Thanks to Ave and Fatih for their support.

Main components of eb-jitsi

Before installing eb-jitsi

  • Jibri needs snd_aloop kernel module, therefore it's not OK with the cloud kernel. Install the standard Linux kernel first if this is the case.

  • It's needed a resolvable host address for your server and this address has to point to your server. Therefore add the DNS A record first if you didn't add yet. This host address will be used as JITSI_HOST in the installer config file.

To install eb-jitsi

Download the installer

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

Open eb-jitsi.conf file with an editor and change the JITSI_HOST value.

vim eb-jitsi.conf

Write the host address of your server as JITSI_HOST, save it and close the file.

export JITSI_HOST=jitsi.mydomain.com

And run the installer

bash eb eb-jitsi

Customizing eb-jitsi

You may want to change the following values in /etc/jitsi/meet/YOUR_HOST_ADDRESS-config.js. This file is on the eb-jitsi container, not on the host.

  • startAudioMuted
  • resolution
  • startVideoMuted
  • channelLastN
  • requireDisplayName
  • defaultLanguage
  • disableAudioLevels

Jitsi cluster

See Jitsi cluster document

Let's Encrypt support

To set the Let's Encrypt certificate, run the following commands on the host:

FQDN="your.host.fqdn"
set-letsencrypt-cert $FQDN

Requirements

emrah-buster requires a Debian Buster (version 10) 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 computer from a hosting/cloud service (DigitalOcean's droplet, Amazon EC2 instance etc)

  • a virtual machine (VMware, VirtualBox etc)

  • a Debian Buster container (with the nesting support)

    lxc.include = /usr/share/lxc/config/nesting.conf
lxc.apparmor.profile = unconfined
lxc.apparmor.allow_nesting = 1

  • a physical machine with a fresh installed Debian 10 Buster