Skip to content

README-ORIGINAL.md

Latest commit

 

History

History
585 lines (417 loc) · 24.6 KB

README-ORIGINAL.md

File metadata and controls

585 lines (417 loc) · 24.6 KB

🧰 Mikrus Toolbox

29 self-hosted aplikacji. Jeden serwer. Zero abonamentów.

License: MIT Apps: 29+ Works on any VPS GitHub Stars

Zamień tani polski VPS (mikr.us) w pełną infrastrukturę firmy — automatyzacja, mailing, analityka, CRM, sklep z produktami cyfrowymi — za ~20 zł/mies zamiast ~7000 zł/rok w SaaS-ach.

📖 Dokumentacja | 🐛 Zgłoś problem | 💬 Dyskusje

git clone https://github.com/jurczykpawel/mikrus-toolbox.git
cd mikrus-toolbox
./local/deploy.sh n8n        # → n8n działa na Twoim serwerze

Każda aplikacja to jeden deploy.sh — skrypt pyta o domenę, bazę danych, sprawdza zasoby serwera i instaluje zoptymalizowaną wersję pod małe VPS-y.

🚀 Dlaczego Mikrus Toolbox?

  • Jedna komenda = działająca aplikacja — deploy.sh sprawdza RAM, dysk, porty, instaluje bazę danych, konfiguruje domenę z HTTPS i weryfikuje, czy wszystko działa
  • Integracja z AI / MCP — powiedz Claude'owi "Zainstaluj n8n na serwerze" i patrz jak sam deployuje, konfiguruje DNS i sprawdza logi
  • Konfiguracje zoptymalizowane pod produkcję — memory limity, health checki, auto-restart, logi bez zapychania dysku
  • Zero platform overhead — żadnego Kubernetes, Terraform ani panelu za $20/mies. Czysty Docker Compose + Bash
  • 29 przetestowanych aplikacji — od automatyzacji (n8n) przez newsletter (Listmonk) po sklep z produktami cyfrowymi (Sellf)

🎯 Dla kogo?

Dla solopreneurów, freelancerów i małych firm, które:

  • Płacą za Zapier, Mailchimp, Airtable, Typeform i widzą, jak rachunki rosną z każdym kontaktem
  • Chcą mieć dane na własnym serwerze — nie u Google'a, nie w USA
  • Wolą zainwestować raz w konfigurację, niż płacić abonament do końca życia
  • Szukają dźwigni — automatyzacji, która pracuje 24/7 bez opłat za "execution"

Nie chcesz wpisywać komend? Sprawdź Mikrus n8n Manager — GUI, które zainstaluje n8n jednym kliknięciem.

📑 Spis treści

🛠️ 29 aplikacji w arsenale

Automatyzacja i operacje

Aplikacja Zastępuje Co robi
n8n Zapier / Make Mózg firmy. Łączy wszystko ze wszystkim — CRM, maile, płatności, API.
Dockge Portainer Panel Docker do zarządzania kontenerami przez przeglądarkę.
Uptime Kuma UptimeRobot Monitoring stron i usług z alertami na telefon.
ntfy Pushover Serwer powiadomień push. Wysyłaj alerty z n8n na telefon.
Redis - Cache. Przyspiesza n8n, WordPress i inne aplikacje.
Crawl4AI ScrapingBee AI web scraper z REST API. Markdown, LLM extraction, JS rendering.
PicoClaw OpenClaw Osobisty asystent AI (Telegram/Discord/Slack). Ultra-lekki (~10MB, 64MB RAM). 🔒 Max izolacja.
MCP Docker - Most AI-serwer. Pozwól Claude/Cursor zarządzać kontenerami.
MinIO AWS S3 Self-hosted object storage (S3-compatible).

Marketing i sprzedaż

Aplikacja Zastępuje Co robi
Sellf Gumroad / EasyCart Sklep z produktami cyfrowymi. 0 zł/mies, 0% prowizji. Lejki, kupony, Omnibus EU. Działa na Mikrus 1.0 (35 zł/rok).
Listmonk Mailchimp Newsletter na miliony maili za grosze (przez Amazon SES lub SMTP).
Typebot Typeform Chatboty i formularze. Zbieraj leady, rób ankiety, sprzedawaj w rozmowie.
Postiz Buffer / Hootsuite Planuj posty na X, LinkedIn, Instagram, Facebook, TikTok. ⚠️ Wymaga 4GB+ RAM.
Cap Loom Nagrywaj ekran i udostępniaj wideo. Tutoriale, async communication.
Umami Google Analytics Analityka bez cookies, bez RODO-paniki, z szacunkiem do prywatności.
Cookie Hub Cookiebot Centralny serwer zgód RODO dla wszystkich Twoich stron.
Social Media Generator Canva (basic) Grafiki social media z szablonów HTML. Jeden tekst → Instagram, Stories, YouTube.
Subtitle Burner Kapwing / VEED Wypalaj animowane napisy na wideo. 8 szablonów, AI transkrypcja, REST API.
FileBrowser Dropbox / Tiiny.host Prywatny dysk z UI + hosting plików i landing page'y.

Biuro i produktywność

Aplikacja Zastępuje Co robi
AFFiNE Notion / Miro Baza wiedzy z dokumentami, tablicami i bazą danych. Open-source.
WordPress WordPress.com Performance Edition: Nginx + PHP-FPM + Redis Object Cache, auto-tuning.
NocoDB Airtable Baza danych z interfejsem arkusza kalkulacyjnego. CRM, projekty, zamówienia.
Stirling-PDF Adobe Acrobat Edycja, łączenie, podpisywanie PDF-ów w przeglądarce.
Gotenberg - API do konwersji dokumentów (HTML/DOCX/ODT → PDF). Lekki: ~150MB RAM.
ConvertX CloudConvert Konwerter 800+ formatów plików w przeglądarce.
Vaultwarden 1Password Menedżer haseł dla całej firmy. Kompatybilny z Bitwarden.
LinkStack Linktree Wizytówka "Link in Bio" z panelem admina.
LittleLink Linktree Wizytówka "Link in Bio" — wersja ultra-lekka, czysty HTML.

Każda aplikacja ma swój README.md z dokumentacją, wymaganiami i opcjami konfiguracji.

🔗 Jak to działa razem

Te aplikacje to nie oddzielne wyspy. Razem tworzą system operacyjny firmy.

Przykład: automatyczna sprzedaż e-booka

Klient → Typebot (chatbot) → Sellf (płatność Stripe)
                                    ↓
                              n8n (webhook)
                             /    |    \     \
                        NocoDB  Email  Faktura  Listmonk
                        (CRM)  (ebook)  (API)  (newsletter)
                                    ↓
                              Umami (konwersja)
  1. Typebot — klient rozmawia z botem, który bada potrzeby
  2. Sellf — bot kieruje do płatności za e-booka
  3. n8n — wykrywa płatność i automatycznie: dodaje klienta do CRM (NocoDB), wysyła e-booka mailem, wystawia fakturę, zapisuje do newslettera (Listmonk)
  4. Umami — śledzi konwersję

Wszystko na Twoim serwerze. Zero opłat za "execution". Zero limitów.

⚡ Szybki start

Wymagania

  • Serwer VPS — Mikrus 3.0+ (1GB RAM, 10GB dysk, od 20 zł/mies)
  • Domena — np. z OVH (od ~12 zł/rok)
  • Terminal z dostępem SSH

🎁 1 miesiąc gratis! Kup Mikrusa przez ten link (reflink), wybierz ofertę (zalecamy 3.0+) i miesiąc gratis zostanie automatycznie doliczony do zamówienia.

1. Konfiguracja SSH

# Linux / macOS
bash <(curl -s https://raw.githubusercontent.com/jurczykpawel/mikrus-toolbox/main/local/setup-ssh.sh)

# Windows (PowerShell)
iwr -useb https://raw.githubusercontent.com/jurczykpawel/mikrus-toolbox/main/local/setup-ssh.ps1 | iex

Skrypt zapyta o dane z maila od Mikrusa (host, port, hasło) i skonfiguruje klucz SSH + alias.

2. Pobierz toolbox

git clone https://github.com/jurczykpawel/mikrus-toolbox.git
cd mikrus-toolbox

3. Zainstaluj fundamenty

./local/deploy.sh system/docker-setup.sh    # Docker + optymalizacja logów
./local/deploy.sh system/caddy-install.sh   # Reverse proxy z auto-SSL

4. Zainstaluj aplikacje

./local/deploy.sh dockge                    # Panel Docker (start od tego)
./local/deploy.sh n8n                       # Automatyzacja
./local/deploy.sh uptime-kuma               # Monitoring

deploy.sh zadba o wszystko — sprawdzi zasoby serwera, zapyta o domenę i bazę danych, zainstaluje aplikację i zweryfikuje czy działa.

5. Backup — zrób to od razu

./local/setup-backup.sh     # Szyfrowany backup do Google Drive / Dropbox

Szczegóły: docs/backup.md

🤖 Opcja AI / MCP

Mikrus Toolbox ma wbudowany serwer MCP (Model Context Protocol) — pozwala asystentom AI (Claude Desktop, Claude Code, Cursor) zarządzać Twoim serwerem przez naturalny język.

Dlaczego to zmienia grę?

Zamiast wpisywać komendy, mówisz co chcesz — AI sam dobiera aplikację, sprawdza zasoby, konfiguruje bazę danych, ustawia domenę i weryfikuje deployment.

Konfiguracja Claude Desktop

Dodaj do ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "mikrus-toolbox": {
      "command": "node",
      "args": ["/sciezka/do/mikrus-toolbox/mcp-server/dist/index.js"]
    }
  }
}

Przed pierwszym uruchomieniem:

cd mikrus-toolbox/mcp-server
npm install && npm run build

Konfiguracja Claude Code

Wystarczy otworzyć repozytorium — Claude Code automatycznie czyta AGENTS.md i zna cały toolbox:

cd mikrus-toolbox
claude

Przykładowe komendy

Co mówisz Co AI robi
"Zainstaluj n8n na serwerze" Sprawdza RAM, pyta o bazę danych, deployuje, konfiguruje domenę
"Skonfiguruj backup do Google Drive" Prowadzi przez setup rclone i cron
"Sprawdź czy wszystkie kontenery działają" Łączy się po SSH, sprawdza docker ps, raportuje problemy
"Wystaw Dockge pod domeną panel.mojafirma.pl" Konfiguruje DNS przez Cloudflare, ustawia HTTPS przez Caddy
"Postaw mi sklep z produktami cyfrowymi" Prowadzi przez konfigurację Supabase, deployuje Sellf
"Co mogę zainstalować?" Wyświetla 29+ aplikacji z opisami i wymaganiami

8 narzędzi MCP

Narzędzie Opis
setup_server Konfiguracja SSH lub test połączenia
list_apps Lista 29+ aplikacji z metadanymi (RAM, DB, porty)
deploy_app Deploy przetestowanej aplikacji z toolboxa
deploy_custom_app Deploy dowolnej aplikacji Docker (AI generuje compose)
deploy_site Deploy lokalnego projektu (strona, Node.js, Python)
setup_domain Konfiguracja darmowej subdomeny Cytrus
setup_backup Konfiguracja automatycznych backupów
server_status Status serwera: kontenery, RAM, dysk, porty

Szczegóły: mcp-server/README.md

🌐 Domeny i HTTPS

Dwie opcje:

Cytrus (łatwiej) Caddy (więcej kontroli)
Konfiguracja Panel Mikrusa Terminal
SSL Automatyczny Let's Encrypt
Jak Panel → Domeny ssh mikrus 'mikrus-expose domena.pl 5678'

Z Cloudflare (zalecane — rozwiązuje problem IPv6):

./local/setup-cloudflare.sh                  # jednorazowo
./local/dns-add.sh n8n.mojafirma.pl          # dodaj rekord DNS
ssh mikrus 'mikrus-expose n8n.mojafirma.pl 5678'  # HTTPS

Szczegóły: docs/cloudflare-domain-setup.md | docs/ssh-tunnels.md

🏎️ Benchmarki wydajności

WordPress na Mikrusie z Cloudflare edge cache osiąga 45 ms TTFB — szybciej niż hosting za $50/mies.

Nasze wyniki (WordPress, Mikrus 2.1, luty 2026)

Trzy konfiguracje tego samego WordPressa na tym samym serwerze:

Konfiguracja Avg TTFB P95 TTFB req/s Koszt/rok
Cytrus (darmowa subdomena *.byst.re) 191 ms 573 ms 22 req/s 75 zł
Cloudflare (własna domena) 141 ms 319 ms 22 req/s 75 zł + domena
Cloudflare + edge cache 45 ms 64 ms 45 req/s 75 zł + domena

Stack: Nginx + PHP-FPM + FastCGI Cache + Redis Object Cache + SQLite + Cloudflare edge cache. Jedna komenda deploy.sh wordpress + setup-cloudflare-optimize.sh --app=wordpress.

Porównanie z popularnymi hostingami

Typ hostingu Avg TTFB Cena/rok Przykłady
Shared hosting 400–800 ms $36–360 GoDaddy, Bluehost, SiteGround
Managed WordPress 335–470 ms $156–420 Kinsta, WP Engine, Flywheel
VPS (self-managed) 80–300 ms $49–144 DigitalOcean, Hetzner, Linode
Mikrus + Toolbox 45 ms ~$19 (75 zł) Ten projekt

Dane branżowe na podstawie publicznych benchmarków (Jetveo, ReviewSignal, WP Starter). TTFB mierzony z perspektywy klienta HTTP (curl), 15 req/path, concurrency 5. Cloudflare edge cache serwuje HTML z najbliższego PoP (~20 ms RTT), eliminując czas odpowiedzi serwera dla stron w cache.

Dlaczego tak szybko?

  1. FastCGI Cache — Nginx serwuje HTML z pamięci, PHP nie musi generować strony
  2. Redis Object Cache — WordPress nie odpytuje bazy przy każdym requeście
  3. Cloudflare edge cache — HTML serwowany z CDN (300+ lokalizacji), TTFB = RTT do najbliższego PoP
  4. SQLite — zero overhead sieciowego, baza w jednym pliku na dysku
  5. Auto-tuning — deploy.sh dobiera parametry PHP/Nginx do dostępnego RAM-u

Cała konfiguracja to dwie komendy:

./local/deploy.sh wordpress           # deploy + auto-tuning
./local/setup-cloudflare-optimize.sh wp.mojadomena.pl --app=wordpress  # edge cache

💰 Kalkulator oszczędności

Koszt Mikrusa

Plan RAM Dysk Cena/rok
Mikrus 2.1 1GB 10GB 75 zł
Mikrus 3.0 2GB 25GB 130 zł
Mikrus 3.5 4GB 40GB 197 zł
Mikrus 4.1 (2x CPU + 2x IOPS) 8GB 80GB 395 zł
Mikrus 4.2 (2x CPU + 2x IOPS) 16GB 160GB 790 zł

Usługi dodatkowe

Usługa RAM Dysk Cena/rok
MySQL / MariaDB 512MB 10GB 25 zł
MySQL / MariaDB 1024MB 20GB 47 zł
PostgreSQL 512MB 10GB 29 zł
PostgreSQL 1024MB 50GB 119 zł
MongoDB 512MB 5GB 25 zł
Uptime Kuma 256MB 10GB 15 zł
Umami 512MB 1GB 15 zł
Domena .pl - - ~50 zł

Self-hosted vs. SaaS

Narzędzie Zastępuje Cena SaaS/mies Na Mikrusie
n8n Zapier Pro $29-99 0 zł
Listmonk Mailchimp (5k kontaktów) $50+ 0 zł
Typebot Typeform Pro $50+ 0 zł
NocoDB Airtable Pro $20+ 0 zł
Sellf Gumroad (10% prowizji) $$$ 0 zł
Uptime Kuma UptimeRobot Pro $7+ 0 zł
Vaultwarden 1Password Teams $8/user 0 zł
Postiz Buffer Pro $15+ 0 zł
WordPress WordPress.com Business $25+ 0 zł
Stirling-PDF Adobe Acrobat Pro $15+ 0 zł
Cap Loom Business $15+ 0 zł
FileBrowser Tiiny.host Pro $6+ 0 zł
ConvertX CloudConvert $9+ 0 zł
Umami Plausible $9+ 0 zł
Crawl4AI ScrapingBee $49+ 0 zł
Suma SaaS ~$300+/mies

Przykład: solopreneur sprzedający kursy

SaaS-y: Zapier + Mailchimp + Typeform + UptimeRobot + hosting = ~$142/mies (~7000 zł/rok)

Mikrus Toolbox: Mikrus 3.0 (130 zł) + domena (50 zł) + PostgreSQL (29 zł) = 209 zł/rok

Oszczędność: ~6800 zł/rok (97%)

📊 Wymagania serwera

Stack Plan RAM
Sellf (sklep cyfrowy, standalone) Mikrus 1.0 ~130 MB
Podstawa (Caddy + Dockge) Mikrus 2.1 ~100MB
+ n8n Mikrus 2.1 ~500MB
+ Listmonk + Uptime Kuma Mikrus 2.1 ~800MB
+ Typebot + Sellf Mikrus 3.0 ~1.5GB
Pełny stack (10+ narzędzi) Mikrus 3.0 ~1.8GB
Coolify (PaaS, 280+ apek) Mikrus 4.1 ~500-800MB (platforma)

Stirling-PDF i Crawl4AI wymagają Mikrus 3.0+ (2GB RAM). Lekka alternatywa: Gotenberg (~150MB).

☁️ Coolify — prywatny Heroku/Vercel (Mikrus 4.1+)

Masz Mikrus 4.1 (8GB RAM, 80GB dysk, 2x CPU)? Zainstaluj Coolify — open-source PaaS z 280+ aplikacjami do deploy jednym kliknięciem.
280+ apek WordPress, n8n, Nextcloud, Grafana, Gitea, Supabase, Ollama...
Auto SSL Let's Encrypt dla każdej apki
Git push deploy Push do GitHub/GitLab = automatyczny deploy
Webowy panel Zarządzaj wszystkim przez przeglądarkę 
./local/deploy.sh coolify --ssh=mikrus

Coolify przejmuje porty 80/443 (Traefik). Nie mieszaj z innymi apkami z toolboxa. Szczegóły: apps/coolify/README.md

🔍 Diagnostyka

# Czy kontener działa?
ssh mikrus 'docker ps | grep nazwa-uslugi'

# Logi (ostatnie 50 linii)
ssh mikrus 'cd /opt/stacks/nazwa-uslugi && docker compose logs --tail 50'

# Czy port odpowiada? (200/302 = OK)
ssh mikrus 'curl -s -o /dev/null -w "%{http_code}" http://localhost:PORT'

# Zużycie zasobów
ssh mikrus 'docker stats --no-stream'

Dostęp bez domeny: docs/ssh-tunnels.md

❓ FAQ

Czy to jest bezpieczne? Tak. Usługi w kontenerach Docker, dostęp z zewnątrz tylko przez HTTPS (Caddy z certyfikatami Let's Encrypt), szyfrowane backupy off-site.

Ile RAMu potrzebuję? Mikrus 2.1 (1GB) uciągnie n8n + 2-3 mniejsze usługi. Do pełnego zestawu: Mikrus 3.0 (2GB). Coolify: Mikrus 4.1 (8GB).

Co z bazą danych? Trzy opcje: darmowa baza Mikrusa (współdzielona, 200MB), dedykowana baza Mikrusa (10GB za 29 zł/rok), lub bundled baza wbudowana w kontener (np. WordPress z SQLite, Redis w kontenerze). deploy.sh poprowadzi Cię przez wybór.

Mogę to postawić na innym VPS? Tak. Skrypty działają na dowolnym VPS z Dockerem. Mikrus jest zalecany bo jest tani i polski, ale deploy.sh działa z każdym serwerem po SSH. Jeśli masz Hetznera, DigitalOcean lub innego dostawcę — sprawdź StackPilot, angielskojęzyczną wersję tego toolboxa zoptymalizowaną pod dowolny VPS.

Jak zaktualizować aplikację? Uruchom deploy.sh ponownie — skrypt wykryje istniejącą instalację i zaktualizuje obraz Docker. Dane w volumes zostaną zachowane.

🗺️ Roadmap

Zrobione

  • 29 przetestowanych aplikacji — od n8n po Sellf
  • Serwer MCP — zarządzanie serwerem przez AI (Claude Desktop, Claude Code, Cursor)
  • Integracja z Cloudflare — automatyczna konfiguracja DNS
  • Bundled bazy danych — Redis i SQLite wbudowane w kontenery
  • System backupów — cron na serwerze + rclone do chmury (Google Drive, Dropbox, S3)
  • Deploy lokalnych projektów — deploy_site dla stron statycznych, Node.js, Python
  • WordPress Performance Edition — Nginx + PHP-FPM + Redis Object Cache z auto-tuningiem
  • Deploy dowolnej aplikacji Docker — deploy_custom_app generuje compose z AI

W trakcie

  • Hosting stron statycznych i PHP — add-static-hosting.sh i add-php-hosting.sh
  • Synchronizacja między projektami — wyrównanie funkcji z StackPilot

W planach

  • GUI dashboard — webowy panel do zarządzania aplikacjami bez terminala
  • Więcej aplikacji — Nextcloud, Grafana, Plausible, Gitea
  • One-click stacks — gotowe zestawy (np. "solopreneur stack" = n8n + Listmonk + Sellf + Uptime Kuma)
  • Automatyczne aktualizacje — Watchtower / Diun z powiadomieniami
  • Monitoring zasobów — alerty gdy RAM/dysk się kończą

Masz pomysł? Otwórz Issue lub dyskusję.

🤝 Contributing

Każdy wkład jest mile widziany — od poprawki literówki po nową aplikację!

  • 🐛 Znalazłeś buga? — Otwórz Issue z logami i opisem
  • 💡 Masz pomysł na aplikację? — Otwórz Issue z opisem use case'u
  • 🔧 Chcesz dodać kod? — Fork → branch → PR. Przetestuj na prawdziwym serwerze
  • 📝 Dokumentacja — poprawki, tłumaczenia, lepsze opisy

Szczegóły: CONTRIBUTING.md

💬 Wsparcie / Społeczność

Jeśli Mikrus Toolbox jest dla Ciebie przydatny, zostaw ⭐ na GitHubie — to pomaga innym go znaleźć.

📁 Struktura repozytorium

local/           → Skrypty użytkownika (deploy, backup, setup, dns)
apps/<app>/      → Instalatory: install.sh + README.md + update.sh
lib/             → Biblioteki (cli-parser, db-setup, domain-setup, health-check)
system/          → Skrypty systemowe (docker, caddy, backup, power-tools)
mcp-server/      → Serwer MCP (TypeScript, Model Context Protocol)
docs/            → Dokumentacja (Cloudflare, backup, SSH tunele, CLI reference)
tests/           → Testy automatyczne

🛠️ Tech Stack

Technologia Rola
Bash Skrypty instalacyjne, deploy, backup, diagnostyka
Docker / Docker Compose Konteneryzacja aplikacji
Caddy Reverse proxy z automatycznym HTTPS (Let's Encrypt)
TypeScript Serwer MCP (Model Context Protocol)
SSH / rsync Zdalne zarządzanie serwerem i synchronizacja plików
Cloudflare API Automatyczna konfiguracja DNS
rclone Szyfrowane backupy do chmury (Google Drive, Dropbox, S3)

⭐ Star History

Star History Chart

🙏 Podziękowania

  • Mikrus — tani polski VPS, który zainspirował ten projekt
  • Caddy — reverse proxy z automatycznym HTTPS
  • Docker — konteneryzacja, która to wszystko umożliwia
  • Model Context Protocol — standard integracji AI z narzędziami
  • Wszystkim twórcom open-source aplikacji, które ten toolbox instaluje

👤 Autor

Paweł (@jurczykpawel) — Lazy Engineer

Buduję narzędzia dla solopreneurów, którzy wolą automatyzować niż klikać. Mikrus Toolbox to zestaw, którego sam używam do prowadzenia biznesu.

📄 Licencja

MIT — zobacz LICENSE

Self-hosted infrastructure toolkit for solopreneurs. Deploy 29 open-source apps (n8n, WordPress, Listmonk, Typebot, NocoDB, Vaultwarden and more) on a cheap VPS with one command. Replace $300+/month in SaaS subscriptions with a $5/month server.