PlugNPiN

★ 71

GNU General Public License v3.0Open Source — No Paywall2 ContainersComposeNo external DB1 active committer (12mo)

About

PlugNPiN is a Docker-based automation tool for users who run self-hosted services behind Pi-hole or AdGuard Home and Nginx Proxy Manager. It watches Docker containers for specific labels, then...

Live Demo Source Code Docs Website

Community Ratings

No ratings yet

New this week

Read recap →

Weekly Recap — Oct 23, 2026 – Oct 30, 2026Oct 30, 2026

Features

automatic Docker container detection
local DNS/CNAME record creation
DNS rewrites creation
Nginx Proxy Manager host creation
real-time event listening
periodic synchronization
multi-host monitoring
Docker socket proxy support

Details

Last Updated: Oct 27, 2026
Created: Aug 15, 2025
Install Methods: docker-compose
Requirements: DockerPi-hole or AdGuard HomeNginx Proxy ManagerDocker socket proxy (recommended)
Authentication: local
Runtime / Stack: Docker
Privacy & Independence: No Cloud RequiredOffline Capable
Deployment: Deployment: Compose via README2 Containers — light hosting footprintRuns as 2 containers

Run PlugNPiN yourself

Pick how much you want to manage.

HetznerBest match
Full control
A small server, then Docker Compose.
About 20 minutes with Docker
Get a Hetzner server(opens in a new tab)
DigitalOcean
Full control
A small server, then Docker Compose.
About 20 minutes with Docker
Get a DigitalOcean server(opens in a new tab)
OVHcloud
Full control
A small server, then Docker Compose.
About 20 minutes with Docker
Get a OVHcloud server(opens in a new tab)

Is this your project? Sponsor a listing

Run PlugNPiN with Docker Compose

Compose example from the PlugNPiN README.

2 services · 1 unclassified (socket-proxy)

no resource limits declared

needs persistent storage (1 volume)

scanned Nov 3, 2026

services:
  socket-proxy:
    image: lscr.io/linuxserver/socket-proxy:latest
    container_name: socket-proxy
    environment:
      # Allow access to the container list
      - CONTAINERS=1
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    read_only: true
    tmpfs:
      - /run

  plugnpin:
    image: ghcr.io/deepspace2/plugnpin:latest
    container_name: plugnpin
    depends_on:
      - socket-proxy
    environment:
      - DOCKER_HOST=tcp://socket-proxy:2375
      - NGINX_PROXY_MANAGER_HOST=...
      - NGINX_PROXY_MANAGER_USERNAME=...
      - NGINX_PROXY_MANAGER_PASSWORD=...
      - PIHOLE_HOST=...
      - PIHOLE_PASSWORD=...
    restart: unless-stopped

This file may be out of date. Check the PlugNPiN documentation for current setup steps.

Related Software

Nginx Proxy Manager

34.6k

A Docker-based Nginx reverse proxy manager with a web admin interface for forwarding hosts and managing SSL certificates.

Web ServersPermissive LicenseProxy Servers+3

SWAG (Secure Web Application Gateway)

3.8k

SWAG is a LinuxServer.io container that provides an Nginx reverse proxy with PHP support, automated SSL certificate generation/renewal, and fail2ban-based intrusion prevention.

Web ServersProxy ServersSelf Hosting Solutions+4

socks5-proxy-server

145

A Docker-based SOCKS5 proxy server with user management and a Telegram bot for administration.

Proxy ServersNetwork UtilitiesSelf Hosting Solutions+1

godoxy

4.2k

A lightweight reverse proxy with a WebUI for managing routes, containers, and Proxmox resources.

Web ServersPermissive LicenseProxy Servers+2

wagmios

WAGMIOS is a self-hosted Docker management platform that lets scoped API keys and AI agents install apps, manage containers, and control a homelab through a REST API.

Self Hosting SolutionsAutomation ToolsAI Agents

2 Containers

AdGuard Home

38.1k

AdGuard Home is a network-wide DNS server that blocks ads, trackers, phishing, and malware across all devices on a home network.

DNS ServersCopyleft LicenseNetwork Utilities+2

Open Core

Mother-of-All-Self-Hosting

1.2k

Ansible playbook which helps you host services as Docker containers on your own server.

Self Hosting Solutions

Cloud Seeder

199

A one-click server appliance wizard for self-hosting containerized applications.

Self Hosting SolutionsAutomation ToolsPlatform as a Service

Source AvailableCloud Required

Uptime Kuma

93.2k

Uptime Kuma is an easy-to-use self-hosted monitoring tool for checking service and server uptime.

Status PagesNetwork UtilitiesAutomation Tools+3

Single ContainerFully FOSS

go-doxy

4.2k

A lightweight reverse proxy with a WebUI for managing container routes, access control, and automation.

Web ServersPermissive LicenseProxy Servers+3

blocky

7.1k

Blocky is a DNS proxy and ad-blocker for local networks, built in Go.

DNS ServersPermissive LicenseProxy Servers+2

Fully FOSS

HomeButler

314

HomeButler is a small homelab operations toolkit that helps inspect, monitor, and manage servers, containers, backups, and self-hosted apps from the terminal, web dashboard, or AI tools.

Automation ToolsRemote AccessSelf Hosting Solutions