{"id":19517860,"url":"https://github.com/emrahcom/emrah-buster-templates","last_synced_at":"2025-04-26T06:31:31.997Z","repository":{"id":42047428,"uuid":"203856583","full_name":"emrahcom/emrah-buster-templates","owner":"emrahcom","description":"The templates of the emrah-buster installer.","archived":false,"fork":false,"pushed_at":"2023-11-30T10:27:51.000Z","size":811,"stargazers_count":59,"open_issues_count":1,"forks_count":40,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-04-04T09:11:29.317Z","etag":null,"topics":["automation","bash","container","dash","debian","debian-buster","git","gitea","hls","installer","jibri","jitsi","livestreaming","lxc","nginx-rtmp","shell","video","video-conferencing"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/emrahcom.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2019-08-22T19:06:07.000Z","updated_at":"2025-02-06T12:05:12.000Z","dependencies_parsed_at":"2023-11-30T09:47:26.473Z","dependency_job_id":"99c050ee-63cd-4c0d-98c0-0e655fa707cf","html_url":"https://github.com/emrahcom/emrah-buster-templates","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emrahcom%2Femrah-buster-templates","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emrahcom%2Femrah-buster-templates/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emrahcom%2Femrah-buster-templates/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emrahcom%2Femrah-buster-templates/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/emrahcom","download_url":"https://codeload.github.com/emrahcom/emrah-buster-templates/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250944154,"owners_count":21511706,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","bash","container","dash","debian","debian-buster","git","gitea","hls","installer","jibri","jitsi","livestreaming","lxc","nginx-rtmp","shell","video","video-conferencing"],"created_at":"2024-11-11T00:06:51.767Z","updated_at":"2025-04-26T06:31:27.612Z","avatar_url":"https://github.com/emrahcom.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"Table of contents\n=================\n\n- [About](#about)\n- [Usage](#usage)\n- [Example](#example)\n- [Available templates](#available-templates)\n    - [eb-base](#eb-base)\n        - [To install eb-base](#to-install-eb-base)\n    - [eb-livestream](#eb-livestream)\n        - [Main components of eb-livestream](#main-components-of-eb-livestream)\n        - [To install eb-livestream](#to-install-eb-livestream)\n        - [After installing eb-livestream](#after-installing-eb-livestream)\n        - [Related links to eb-livestream](#related-links-to-eb-livestream)\n    - [eb-gitea](#eb-gitea)\n        - [Main components of eb-gitea](#main-components-of-eb-gitea)\n        - [To install eb-gitea](#to-install-eb-gitea)\n        - [After installing eb-gitea](#after-installing-eb-gitea)\n        - [Customizing eb-gitea](#customizing-eb-gitea)\n    - [eb-jitsi](#eb-jitsi)\n        - [Main components of eb-jitsi](#main-components-of-eb-jitsi)\n        - [Before installing eb-jitsi](#before-installing-eb-jitsi)\n        - [To install eb-jitsi](#to-install-eb-jitsi)\n        - [Customizing eb-jitsi](#customizing-eb-jitsi)\n        - [Jitsi cluster](#jitsi-cluster)\n- [Let's Encrypt support](#lets-encrypt-support)\n- [Requirements](#requirements)\n\n---\n\nAbout\n=====\n\n`emrah-buster` is an installer to create the containerized systems on Debian\nBuster (_version 10_) host. It built on top of LXC (Linux containers). This\nrepository contains the `emrah-buster` templates.\n\nUsage\n=====\n\nDownload the installer, run it with a template name as an argument and drink a\ncoffee. That's it.\n\n```bash\nwget https://raw.githubusercontent.com/emrahcom/emrah-buster-base/master/installer/eb\nwget https://raw.githubusercontent.com/emrahcom/emrah-buster-templates/master/installer/\u003cTEMPLATE_NAME\u003e.conf\nbash eb \u003cTEMPLATE_NAME\u003e\n```\n\nExample\n=======\n\nTo install a streaming media system, login a Debian Buster (_version 10_) host\nas `root` and\n\n```bash\nwget https://raw.githubusercontent.com/emrahcom/emrah-buster-base/master/installer/eb\nwget https://raw.githubusercontent.com/emrahcom/emrah-buster-templates/master/installer/eb-livestream.conf\nbash eb eb-livestream\n```\n\nAvailable templates\n===================\n\neb-base\n-------\n\nInstall only a containerized Debian Buster.\n\n### To install eb-base\n\n```bash\nwget https://raw.githubusercontent.com/emrahcom/emrah-buster-base/master/installer/eb\nwget https://raw.githubusercontent.com/emrahcom/emrah-buster-templates/master/installer/eb-base.conf\nbash eb eb-base\n```\n\n---\n\neb-livestream\n-------------\n\nInstall a ready-to-use live streaming media system. See the\n[livestream](doc/livestream.md) page for details.\n\n### Main components of eb-livestream\n\n- Nginx server with nginx-rtmp-module as a stream origin.\n  It gets the RTMP stream and convert it to HLS and DASH.\n\n- Nginx server with standart modules as a stream edge.\n  It publish the HLS and DASH stream.\n\n- Web based HLS video player.\n\n- Web based DASH video player.\n\n### To install eb-livestream\n\n```bash\nwget https://raw.githubusercontent.com/emrahcom/emrah-buster-base/master/installer/eb\nwget https://raw.githubusercontent.com/emrahcom/emrah-buster-templates/master/installer/eb-livestream.conf\nbash eb eb-livestream\n```\n\n### After installing eb-livestream\n\n- `rtmp://\u003cIP_ADDRESS\u003e/livestream/\u003cCHANNEL_NAME\u003e` to push\n   an RTMP stream.\n\n- `http://\u003cIP_ADDRESS\u003e/livestream/hls/\u003cCHANNEL_NAME\u003e/index.m3u8` to pull\n  the HLS stream.\n\n- `http://\u003cIP_ADDRESS\u003e/livestream/dash/\u003cCHANNEL_NAME\u003e/index.mpd` to pull\n  the DASH stream.\n\n- `http://\u003cIP_ADDRESS\u003e/livestream/hlsplayer/\u003cCHANNEL_NAME\u003e` for\n  the HLS video player page.\n\n- `http://\u003cIP_ADDRESS\u003e/livestream/dashplayer/\u003cCHANNEL_NAME\u003e` for\n  the DASH video player page.\n\n- `http://\u003cIP_ADDRESS\u003e:8000/livestream/status` for the RTMP status page.\n\n- `http://\u003cIP_ADDRESS\u003e:8000/livestream/cloner` for the stream cloner page.\n  Thanks to [nejdetckenobi](https://github.com/nejdetckenobi)\n\n### Related links to eb-livestream\n\n- [nginx-rtmp-module](https://github.com/arut/nginx-rtmp-module)\n\n- [video.js](https://github.com/videojs/video.js)\n\n- [dash.js](https://github.com/Dash-Industry-Forum/dash.js/)\n\n---\n\neb-gitea\n-------------\n\nInstall a ready-to-use self-hosted Git service. Only AMD64 architecture is\nsupported for this template. Please contact me if you need eb-gitea for an\nother architecture.\n\n### Main components of eb-gitea\n\n- [Gitea](https://gitea.io/)\n- [Git](https://git-scm.com/)\n- [MariaDB](https://mariadb.org/)\n- [Nginx](http://nginx.org/)\n\n### To install eb-gitea\n\n```bash\nwget https://raw.githubusercontent.com/emrahcom/emrah-buster-base/master/installer/eb\nwget https://raw.githubusercontent.com/emrahcom/emrah-buster-templates/master/installer/eb-gitea.conf\nbash eb eb-gitea\n```\n\n### After installing eb-gitea\nThere is one more step to finish the installation. It's needed to fill\nthe initial configuration form of Gitea. Only two fields will be changed:\n**SSH Server Domain** and **Gitea Base URL**.\n\nVery easy!\n\n- Access `https://\u003cIP_ADDRESS\u003e/install` to fill the Gitea config form.\n\n- **SSH Server Domain**: Write your host FQDN or IP address. Examples:   \n  *git.mydomain.com*   \n  *123.2.3.4*\n\n- **Gitea Base URL**: Write your URL. HTTP and HTTPS are OK. Examples:   \n  *https://git.mydomain.com/*    \n  *https://123.2.3.4/*\n\n- Don't change the other fields. They are all OK.\n\n- The first registered user will be the administrator.\n\n### Customizing eb-gitea\nEdit `/home/gitea/custom/conf/app.ini` file and restart the service to\ncustomize Gitea. These are the customized settings of my private server.\nSee [cheat-sheet](https://docs.gitea.io/en-us/config-cheat-sheet/) for more\ndetails.\n\n- PASSWORD_COMPLEXITY = lower,upper,digit\n- FORCE_PRIVATE = true\n- DEFAULT_PRIVATE = true\n- DISABLE_REGISTRATION = true\n- REQUIRE_SIGNIN_VIEW = true\n- DEFAULT_KEEP_EMAIL_PRIVATE = true\n- [mailer] ENABLED = true\n- [mailer] HOST = my-smtp-server.domain.com:587\n- [mailer] FROM = emrah@domain.com\n- [mailer] USER = emrah@domain.com\n- [mailer] PASSWD = my-secret\n\n---\n\neb-jitsi\n--------\n\nInstall a ready-to-use self-hosted Jitsi/Jibri service.\n\nThanks to [Ave](https://ave.zone/) and [Fatih](https://www.fatihmalakci.com/)\nfor their support.\n\n### Main components of eb-jitsi\n\n- [Jitsi](https://jitsi.org/)\n- [Jibri](https://github.com/jitsi/jibri)\n- [Nginx](http://nginx.org/)\n\n### Before installing eb-jitsi\n- Jibri needs `snd_aloop` kernel module, therefore it's not OK with the cloud\n  kernel. Install the standard Linux kernel first if this is the case.\n\n- It's needed a resolvable host address for your server and this address has to\n  point to your server. Therefore add the DNS A record first if you didn't add\n  yet. This host address will be used as `JITSI_HOST` in the installer config\n  file.\n\n### To install eb-jitsi\n\nDownload the installer\n\n```bash\nwget https://raw.githubusercontent.com/emrahcom/emrah-buster-base/master/installer/eb\nwget https://raw.githubusercontent.com/emrahcom/emrah-buster-templates/master/installer/eb-jitsi.conf\n```\n\nOpen `eb-jitsi.conf` file with an editor and change the `JITSI_HOST` value.\n\n```bash\nvim eb-jitsi.conf\n```\n\nWrite the host address of your server as `JITSI_HOST`, save it and close the file.\n\n```\nexport JITSI_HOST=jitsi.mydomain.com\n```\n\nAnd run the installer\n\n```bash\nbash eb eb-jitsi\n```\n\n### Customizing eb-jitsi\nYou may want to change the following values in\n`/etc/jitsi/meet/YOUR_HOST_ADDRESS-config.js`. This file is on the\n`eb-jitsi` container, not on the host.\n\n- startAudioMuted\n- resolution\n- startVideoMuted\n- channelLastN\n- requireDisplayName\n- defaultLanguage\n- disableAudioLevels\n\n### Jitsi cluster\nSee [Jitsi cluster document](doc/jitsi_cluster.md)\n\n---\n\nLet's Encrypt support\n=====================\n\nTo set the Let's Encrypt certificate, run the following commands on the host:\n\n```bash\nFQDN=\"your.host.fqdn\"\nset-letsencrypt-cert $FQDN\n```\n\n---\n\nRequirements\n============\n\n`emrah-buster` requires a Debian Buster (_version 10_) host with a minimal\ninstall and the Internet access during the installation. It's not a good\nidea to use your desktop machine or an already in-use production server as\na host machine. Please, use one of the followings as a host:\n\n- a cloud computer from a hosting/cloud service\n  ([DigitalOcean](https://www.digitalocean.com/?refcode=92b0165840d8)'s\n  droplet, [Amazon](https://console.aws.amazon.com) EC2 instance etc)\n\n- a virtual machine (VMware, VirtualBox etc)\n\n- a Debian Buster container (_with the nesting support_)\n  ```\n  lxc.include = /usr/share/lxc/config/nesting.conf\n  lxc.apparmor.profile = unconfined\n  lxc.apparmor.allow_nesting = 1\n  ```\n\n- a physical machine with a fresh installed\n  [Debian 10 Buster](https://www.debian.org/releases/buster/debian-installer/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femrahcom%2Femrah-buster-templates","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Femrahcom%2Femrah-buster-templates","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femrahcom%2Femrah-buster-templates/lists"}