This project is not yet finished. Public release planned end of 2026.Contact us for details
Poradniki

Self-hosting Ionide

Co robi instalator, czego od Ciebie potrzebuje i jak aktualizować lub przekonfigurować bota.

Bot Ionide działa wyłącznie w modelu self-hosted. Nie ma wersji hostowanej przez nas. Ta strona opisuje, co robi instalator i jak zarządzać kontenerem później. Pełny przewodnik krok po kroku znajdziesz w Pierwszych krokach.

Pierwszy raz z self-hostingiem? To po prostu oznacza uruchomienie bota na maszynie, którą kontrolujesz, zamiast usługi, którą prowadzimy za Ciebie. Tani VPS (koszt i wymagania poniżej) w zupełności wystarczy — nie musi być mocny, wystarczy, że jest online zawsze, gdy chcesz, aby Ionide aktywnie zarządzał pozycjami.

Wymagania

  • Host z Linuksem i Dockerem (instalator zaoferuje instalację Dockera, jeśli go brakuje).
  • Aplikacja bota Discord i token (zobacz niżej, jeśli jeszcze go nie masz).

Jaki serwer wybrać?

Wybierz mały VPS z Linuksem. Nie musisz rozumieć Dockera, Javy, heapów pamięci ani ustawień kontenerów — instalator zajmuje się tym za Ciebie.

  • Pamięć RAM: minimum 512 MB; zalecane 1 GB. To daje wygodny zapas dla bota i Dockera.
  • Dysk: minimum 5 GB wolnego miejsca; zalecane 10 GB na aktualizacje i zwykłe pliki Dockera.
  • CPU: wystarczy jeden wirtualny rdzeń.
  • Sieć: serwer powinien być online, gdy chcesz, aby Ionide monitorował pozycje i nimi zarządzał.

Sam bot używa mało miejsca: na serwerze zostają zaszyfrowane dane giełdowe, stan aktywacji i małe dane operacyjne. Dodatkowy zapas dysku jest dla obrazów i aktualizacji Dockera, nie dla dużej lokalnej bazy historii transakcji.

W praktyce podstawowy VPS za 4–5 USD/mies. z 1 GB RAM i 10 GB dysku w zupełności wystarczy.

Darmowe opcje VPS

Zużycie zasobów Ionide jest na tyle małe, że mieści się w darmowych na stałe tierach niektórych dostawców, nie tylko w płatnych okresach próbnych:

  • Oracle Cloud "Always Free" — instancja Ampere ARM (4 OCPU / 24 GB RAM) jest darmowa na stałe, znacznie więcej niż potrzebuje Ionide. Wymaga podania karty przy rejestracji, mimo że nic nie jest pobierane w darmowym tierze, a Oracle bywa znany z odzyskiwania bezczynnych darmowych instancji w niektórych regionach przy zbyt niskim użyciu, albo z czasowego braku dostępnej pojemności w popularnych regionach.
  • Google Cloud "Always Free" — jedna instancja e2-micro (1 GB RAM) jest darmowa na stałe, ale tylko w konkretnych regionach USA (us-west1, us-central1, us-east1). Mieści się w wymaganiach Ionide bez problemu.
  • AWS Free Tier oraz darmowy okres próbny Azure — obie oferują małą instancję tylko przez 12 miesięcy, potem naliczają normalne opłaty. Dobre do testów, nie stanowią stałej darmowej opcji.

Kompromis: darmowe tiery nie mają gwarantowanego SLA dostępności, jaki płatny VPS zapewnia efektywnie dzięki reputacji i wsparciu dostawcy. Polityka odzyskiwania bezczynnych instancji Oracle w szczególności oznacza, że darmowa instancja może w praktyce zostać odebrana, jeśli wygląda na nieużywaną — realne ryzyko dla bota, który ma działać bez nadzoru miesiącami. Płatny VPS za 4–5 USD/mies. to bardziej przewidywalny wybór do ciągłego, bezobsługowego zarządzania pozycjami; darmowy tier to rozsądny sposób, by najpierw wypróbować Ionide albo uruchomić go, jeśli sam monitorujesz dostępność.

Tworzenie tokenu bota Discord

  1. Przejdź do Discord Developer Portal i utwórz New Application.
  2. Otwórz zakładkę Bot, kliknij Reset Token i skopiuj token. Wkleisz go do instalatora.

Uruchomienie instalatora

curl -fsSL https://install.ionide.net | bash -s -- --lang pl

install-confirm::Skonfigurowano dla języka Polski — ustawia domyślny język Twojego samodzielnie hostowanego bota (można zmienić później w konfiguracji bota).

Instalator:

  1. Sprawdza obecność Dockera i oferuje jego instalację przez oficjalny skrypt instalacyjny Dockera, jeśli go brakuje.
  2. Pyta raz o token bota Discord.
  3. Generuje SECRETS_ENCRYPTION_KEY i zapisuje obie wartości do lokalnego pliku .env. Ten klucz szyfruje Twoje sekrety API giełd w spoczynku. Zrób jego kopię zapasową — jego utrata oznacza utratę dostępu do wszystkich danych giełdowych zapisanych przez /secrets action:set.
  4. Uruchamia bota i wznawia go po restarcie serwera. Lokalne dane bota zostają zachowane między aktualizacjami.
  5. Czeka, aż bot wejdzie online, i wypisuje link zaproszenia do Discorda zbudowany z tokenu bota.
  6. Wyświetla bieżący publiczny adres IPv4, jeśli opcjonalne jednorazowe sprawdzenie się powiedzie. Dodaj go do allowlisty klucza API giełdy tylko, gdy wiesz, że adres jest stały; nie jest on zapisywany ani wysyłany do Ionide. Zobacz Bezpieczeństwo i dane.

Zaproś bota za pomocą wypisanego linku, a następnie kontynuuj od połączenia konta.

Aktualizacja

Ionide aktualizuje się domyślnie sam. Co godzinę sprawdza nową wersję, a następnie instaluje ją, gdy jest bezpiecznie: żadna pozycja nie jest blisko likwidacji i rozliczenie finansowania nie jest tuż przed terminem. Przy zwykłych aktualizacjach nie musisz łączyć się z serwerem przez SSH.

Jeśli nowa wersja nie uruchomi się poprawnie, Ionide automatycznie wraca do poprzedniej wersji i powiadamia właścicieli bota. Uruchom /update-check na Discordzie, gdy chcesz sprawdzić aktualizację i zatwierdzić ją od razu zamiast czekać na następną bezpieczną aktualizację automatyczną.

Uruchom ponownie instalator tylko, aby naprawić instalację lub odświeżyć jej pliki konfiguracji. Zachowa token bota i klucz szyfrowania:

curl -fsSL https://install.ionide.net | bash -s -- --lang pl

install-confirm::Skonfigurowano dla języka Polski — ustawia domyślny język Twojego samodzielnie hostowanego bota (można zmienić później w konfiguracji bota).

Aby zmienić token bota Discord albo wygenerować nowy klucz szyfrowania, przekaż --reconfigure:

curl -fsSL https://install.ionide.net | bash -s -- --reconfigure

Gdzie co się znajduje

  • .env: token bota Discord i klucz szyfrowania.
  • /app/data (wolumen Dockera): lokalna baza danych bota, w tym zaszyfrowane dane giełdowe i stan aktywacji. Zrób kopię zapasową razem z kluczem szyfrowania, jeśli zmieniasz hosta.

Rozwiązywanie problemów

  • Kontener nie wstaje / instalator zawiesza się w oczekiwaniu na niego: sprawdź docker logs ionide-discord-bot pod kątem błędów. Brakujący lub nieprawidłowy token bota to najczęstsza przyczyna.
  • Komendy nie odpowiadają w Discordzie: bot blokuje każdą komendę poza /setup, dopóki licencja nie zostanie aktywowana. Najpierw uruchom /setup.
  • Nadal utknąłeś? Zapytaj na Discordzie.