Warning

Aerofly is not production ready, it is in alpha stages.

Aerofly

A selfhosted live streaming website.

Setup

Configurations

Aerofly is built to be used with Docker, create a compose file:

# compose.yml
services:
  aerofly:
    image: oci.registry.sudovanilla.org/aerofly:amd64 # or arm64
    ports:
      - 4570:4321 # Frontend
    volumes:
      - ./config.json:/aerofly/config.json
      - ./content.md:/aerofly/src/pages/content.md
  aerofly-rtmp:
    image: oci.registry.sudovanilla.org/aerofly-rtmp:amd64 # or arm64
    ports:
      - 1935:1935 # RTMP
      - 4560:8080 # M3U8
    environment:
      - ALLOWED_IP=xxx.xxx.xxx.xxx

For the ALLOWED_IP option, please set the IP address you'll be streaming directly from. It'll likely be your home IP address.

Create two files, being both config.json and content.md:

{
    "Stream": "https://rtmp.example.org",
    "Key": "random_key",
    "Title": "Live Stream Title",
    "Poster": "https://cdn.example.org/poster.png",
    "Banners": {
        "Online": "https://cdn.example.org/poster.png",
        "Offline": "https://cdn.example.org/offline.png"
    },
    "Creator": "Bubbles",
    "Copyright": "Bubbles",
    "Avatar": "https://cdn.example.org/avatar.png",
    "Favicon": "https://cdn.example.org/avatar_or_favicon.png",
    "ThemeColor": "#1E97FE",
    "Whitelabel":   true,
    "Warnings": {
        "show": false,
        "rating": "PG-13",
        "epilepsy": false,
        "violence": false,
        "sexual": false
    },
    "Links": [
        {
            "Text": "My Website",
            "Link": "https://example.org/"
        }
    ]
}

The content.md is your live stream description, it's a Markdown file. You can leave it blank if you want to.

Startup the containers:

docker compose up -d

OBS Studio

For OBS Studio to stream to your RTMP server, the settings need to be setup as follow in the Stream settings.

• Service: Custom
• Server: https://rtmp.example.org/live or http://192.168.1.xxx/live
• Stream Key: YOUR_STREAM_KEY

---

License

MIT License NON-AI

Copyright 2025 MinPluto

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

In addition, the following restrictions apply:

1. The Software and any modifications made to it may not be used for the purpose of training or improving machine learning algorithms,
including but not limited to artificial intelligence, natural language processing, or data mining. This condition applies to any derivatives,
modifications, or updates based on the Software code. Any usage of the Software in an AI-training dataset is considered a breach of this License.

2. The Software may not be included in any dataset used for training or improving machine learning algorithms,
including but not limited to artificial intelligence, natural language processing, or data mining.

3. Any person or organization found to be in violation of these restrictions will be subject to legal action and may be held liable
for any damages resulting from such use.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE
OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

---