/deployarr

Deployarr automates Homelab setup using Docker and Docker Compose. Below you will find more information its features and what it can/cannot do.

Primary LanguageShellMIT LicenseMIT

Deployarr automates Homelab setup using Docker and Docker Compose. Below you will find more information its features and what it can/cannot do.

Deployarr 5

What Apps are Supported by Deployarr?

Deployarr can automatically setup Socket Proxy, Traefik (fetch LE SSL certificates), Authelia, Portainer, Plex, Jellyfin, Starr Apps, Gluetun, Dozzle, Uptime-Kuma, Homepage, CrowdSec, and other apps.

Full List of Apps

Supported Apps - 101 (and increasing)

Apps Supported by Deployarr

As Deployarr simplifies setup of several homelab apps, and not just Traefik, it was recently renamed from Auto-Traefik to Deployarr. You may still find references to Auto-Traefik until the rebrand is complete.

Features

  • 100+ Total Apps
  • Docker Environment Setup (FREE) - as in my guides
  • System Checks (FREE)
  • Domain Checks to prepare for Traefik (FREE)
  • Full control over all apps and files
  • Descriptive error messages for troubleshooting
  • Socket-Proxy to protect Docker Socket from compromised apps
  • Deployarr Dashboard - Auto-populating Homelab Dashboard
  • Bash Aliases for Linux, Docker, and Docker Compose
  • Local-only Setup without reverse proxy or port forwarding
  • Traefik Reverse Proxy App Exposure Modes: Internal Only, External Only, or Both
  • Multi-server Setup
  • Domain passthrough for multi-domain multi-Traefik setups
  • Google OAuth and Authelia for Authentication layer
  • CrowdSec and various bouncers for Security
  • Stack Manager: Update Apps, Enable Apps, Disable Apps, Delete Apps, Up/Down Stack, Recreate/Start/Stop containers, etc.
  • Backups, Restore, and Migration of whole setup
  • Expert Mode for advanced users
  • PLANNED: Several more apps including Authentik, Cloudflared, etc.

Downloading and Running Deployarr

wget https://raw.githubusercontent.com/anandslab/deployarr/main/deployarr_v5.2.app
chmod +x deployarr_v5.2.app
./deployarr_v5.2.app

Use the -arm.app version of the file for Raspberry Pi.

Migrate from v4 to v5

How to Migrate from v4.6.1 to v5?

Deployarr Stats - Jan to Nov 2024

Jan to Nov, 2024

References

More information on Deployarr and how to use it:

Official Website: https://www.smarthomebeginner.com/deployarr/

Video Guides:

Support

Please do not open issues on GitHub. There is a dedicated Auto-Traefik/Deployarr support channel on our Discord server for Supporters.

Cost / Licenses Types

Any one can download the use the free features in Deployarr without registration.

Optionally, if you decide to sponsor my work, then there are 3 different options; Basic, Plus, and Pro, which will open up additional features. In addition, all annual memberships on my website include Deployarr access.

More Details: Detailed Version Comparison

FAQ

What is the purpose of Deployarr?

The reason I created Deployarr was to enable people to automatically replicate the setup from my guides (and my own setup follows this). It is not a blackbox solution that one has no control over. My vision is for people to use it to setup their homelab for quick setup, testing, and customization. And if things break, learn from it, and quickly re-setup everything. Although Deployarr has some management tools it is not intended to be a homelab manager.

What OSes are supported?

Deployarr is primarily developed and tested on Ubuntu. But it should work on other Debian environments with little to no tweaking.

What hardware are supported?

At this point, Deployarr only works on Linux in Barebones, VM, and LXC environments. I do plan to include Synology devices in future. I am just waiting for Synology to update their Docker Package, which is several years old.

Why not Free?

Deployarr is meant to be a perk for followers and supporters of SmartHomeBeginner.com. But keep in mind that everything that the script does can be learned using the guides on SmartHomeBeginner.com or my Docker-Traefik GitHub Repo.

Parts of the script are free to use without registration (see License Types).

Any support received via the purchase of the script goes towards publishing more videos guides on my Youtube Channel. At this point, I spend 15x more on editing costs compared to Youtube Ad income. This also does not include 1000s of hours spent on writing guides, making videos, maintaining the community, and developing the script.

In addition, Deployarr also allows me to contribute to he open-source projects we all love.

Why not Open-Source?

Paid supporters receive full access to the script's functionalities. Implementing this requires license checks with some sensitive information. Unfortunately, this requires compiling the source.

What are the limitations of Deployarr?

With a bit of knowledge, the basic framework created by Deployarr can be adapted to any situation. With that said, here are some limitations and known issues.

  • DNS Challenge Provider: Cloudflare (only supported provider at this point). You may have you domain registered with any registrar, but you will have to use Cloudflare for DNS (its free).
  • Port Forwarding is required (80/443).
  • Some apps (Guacamole, Speedtest-Tracker) that depend on databases may fail upon reinstallation from scratch. This will be fixed at some point. Clean installation should work.

Screenshots

Splash Screen

Splash Screen

Main Menu

Main Menu

Prerequisites

Prerequisites

Local Setup

Local Setup

Hybrid Setup

Hybrid Setup

System Checks

System Checks

System Prep Menu

System Prep Menu

Rclone Remote Mounts

Rclone Remote Mounts

Setting Folders

Setting Folders

Docker Menu

Docker Menu

Reverse Proxy Menu

Reverse Proxy Menu

Descriptive Error Messages

Descriptive Error Messages

Security Menu

Security Menu

Manage Authentication

Manage Authentication

Apps List

Apps List

App Install

App Install

App Uninstall

App Uninstall

Deployarr Dashboard

Deployarr Dashboard

Tools Menu

Tools Menu

Stack Manager

Stack Manager

Containers Status

Containers Status

Services Status

Services Status

Backups Menu

Backups Menu

Restore Backups

Restore Backups

Deployarr Settings

Deployarr Settings

License Types

License Types

Setup Options

Setup Options

Getting Support

Getting Support