GhostProvider

is an open-source platform that simplifies self-
hosting by automating deployment, service
management, discovery, and clean removal.

One-Click Deploy

Paste a GitHub URL — get a host score —
deploy as a systemd service.
Private, local, no third parties.

Requirements
• Python 3.10+
• systemd (user-level)
• git
• Linux (tested on Arch, Ubuntu, Fedora)

Tech Stack
• Python 3.10+ / Textual (TUI framework)
• SystemD (user-level service management)
• Requests (GitHub API interaction)

Why systemd?
GhostProvider uses systemd user-level
services because they provide:
• No root required —
every user can manage their own services
• Auto-start on login —
services survive reboots without manual config
• Clean removal — systemctl –user disable +
delete unit file; GhostProvider also cleans the
cloned repo, secrets file, and lingering ports
• Sandboxing — built-in security directives
(NoNewPrivileges, ProtectHome, ProtectSystem).

This is the standard on Arch, Ubuntu, Fedora,
Debian, and most modern Linux distributions.

System Scan

Scans your machine for prerequisites, detects
all listening ports, fingerprints known services
(VERT, SearXNG, Memos…) and maps your
network — gateway, DNS.

Why System Scan?
Before deploying a new service, GhostProvider
checks what's already running on your machine:
• Prerequisites —
do you have Python, systemd, git installed?
• Listening ports —
which ports are already in use?
• Known services — is SearXNG, Memos,
or another app already running?

This avoids port conflicts and helps
GhostProvider choose the right deployment
strategy. All data stays on your machine —
nothing is sent anywhere.

Control panel

Full dashboard for all deployed services.
Start, stop, restart, or remove — one click
cleans the service, unit file, cloned repo,
secrets file, and lingering ports.
GhostProvider cleans up the resources
it manages; applications may still leave
their own state (databases, caches, external sockets) elsewhere.