@moartube/moartube-node

MoarTube-Node

A repository containing the MoarTube Node software, a cross-platform terminal-based Node.js Express application, managed by the MoarTube Client. Share your node's videos with MoarTube or do your own thing and run your node privately. MoarTube makes video and live streaming so easy you'll be amazed beyond belief.

How to Get Started

Welcome to the MoarTube Node setup guide! This document will guide you through the different setup methods to get your MoarTube Node up and running. Don't worry; MoarTube is so easy to set up and use, you'll be done in minutes. When ready, head over to MoarTube Client if you haven't yet.

Table of Contents

• Features
• Prerequisites
  • Docker
  • npm
  • git
  • script (Ubuntu Linux)
• Installation Methods
  • Docker
  • npm
  • git
  • script (Ubuntu Linux)
• Next Steps
  • Default Login Credentials
  • Cloudflare
  • Get MoarTube Client
• Guides
  • Ubuntu Linux Autostart Guide

Features

• Cross platform support for Windows/macOS/Linux
• Video on demand (VoD) and HLS live streaming
• Admin panel for managing videos and live streams
• HLS (H.264, AAC), MP4 (H.264, AAC), WEBM (VP9, Opus), OGV (VP8, Opus) container formats
• Transcode static MP4/WEBM video to HLS/MP4/WEBM/OGV
• Transcode RTMP stream (such as from OBS) to HLS live stream
• Video output resolutions: 2160p, 1440p, 1080p, 720p, 480p, 360p, 240p
• No server-side encoding; client-side only
• HTTPS/WSS capabilities
• GPU acceleration for Nvidia and AMD (Windows only)
• Different video player modes: streamer, theater, fullscreen
• Dark mode option and browser appearance configuration recognition
• Anonymous video comments section and live stream chat
• Reports section for comments and videos
• Comment monitoring overview with moderation functionality
• Run your node in the cloud or on your home WiFi
• Can run on a Raspberry Pi Zero 2 W
• Publicize your node's content on MoarTube or run your node privately
• Dual box compatible; broadcast an RTMP stream with software such as OBS from a primary system over a network (WAN or LAN) to a secondary system running the MoarTube Client, separating stream broadcasting from stream processing. This is achieved without any special plugins, such as NDI.
• Cloudflare Turnstile; next-generation bot detection and human verification without the annoyance of captcha.
• Cloudflare one-click integration; easily integrate your node into the Cloudflare Network, allowing for global media delivery capabilities of your videos and live streams that rivals major platforms, all from a single node. Features automated caching strategy configuration and automated cache management, and of course the best security from the world's leading CDN.

Prerequisites

Observe the corresponding prerequisite for your installation method.

Docker

If you're using Docker, make sure that it is installed on your machine.

npm

If you're using npm to install the software, make sure that Node.js and npm are installed on your machine.

git

You can clone the repo, but make sure that Node.js and npm are installed on your machine.

script (Ubuntu Linux)

A script to automate your entire setup. Installs Node.js using Snap, clones the git repo using git, installs dependencies using npm, and sets the node to autostart on system boot using systemctl

Installation Methods

Choose any of the following installation methods.

DockerHub

MoarTube Node is available on DockerHub and can be easily set up using Docker Desktop or via the command line for a more manual approach.

Using Docker Desktop

You can manage MoarTube Node using Docker Desktop by searching for moartube/moartube-node on DockerHub within the Docker Desktop interface.

Manual Docker Setup

To set up MoarTube Node manually using Docker, execute the following command in your terminal. This command pulls the latest MoarTube Node image, creates a container named moartube-node-1, assigns it port 8181, and configures it to auto-restart unless manually stopped.

docker run -d --restart unless-stopped -p 8181:80 --name moartube-node-1 moartube/moartube-node:latest

note: the Docker container uses /data for its volume container path.

npm

You can install MoarTube Node globally:

npm i @moartube/moartube-node -g

And run from the command-line globally:

moartube-node

You can install MoarTube Node locally:

npm i @moartube/moartube-node

And run from the command-line locally:

node node_modules/@moartube/moartube-node/moartube-node.js

git

git clone https://github.com/MoarTube/MoarTube-Node

Open a terminal in the cloned directory and run:

npm install

node moartube-node.js

script (Ubuntu Linux)

bash <(wget -O - https://www.moartube.com/bash/install/node)

Next Steps

Default Login Credentials

The default login credentials for your node are below. Be sure to change these upon logging in.

username: admin
password: admin

Cloudflare

At this point, you should probably look into creating a free Cloudflare account so that you can give your node CDN capabilities. With over 300 data centers worlwide, Cloudflare will distribute most of your node's videos and live streams.

Get MoarTube Client

If you haven't already, it's time to get the MoarTube Client.

Guides

Ubuntu Linux Autostart Guide

This guide will configure your node to autostart on system boot.

Stop the Moartube Node software if it is running

Run the command:

sudo nano /etc/systemd/system/moartube-node.service

Below is an example of a moartube-node systemd service unit file

Make any necessary changes and paste it into the nano text editor

[Unit]
Description=MoarTube Node
After=network.target

[Service]
Type=simple
User=root
ExecStart=/snap/bin/node /home/Moartube-Node/moartube-node.js
Restart=always

[Install]
WantedBy=multi-user.target

Reload all services.

sudo systemctl daemon-reload

Make the moartube-node service autostart on system boot.

sudo systemctl enable moartube-node

Start the moartube-node service.

sudo systemctl start moartube-node

View the status of the moartube-node service

sudo systemctl status moartube-node

some commands of interest

Stop the moartube-node service.

sudo systemctl stop moartube-node

Restart the moartube-node service.

sudo systemctl restart moartube-node