--- title: Jak zainstalować program PP Mag description: Poniższy artykuł opisuje standardowy proces instalacji programu PP Mag oraz aplikacji PP Kolektor. Mimo szczegółowej instrukcji zachęcamy do skorzystania z naszej pomocy podczas instalacji lub do umówienia się na weryfikację konfiguracji po jej zakończeniu. Instrukcja umożliwia uruchomienie systemu w konfiguracji… url: "https://ppmag.pl/docs/jak-zainstalowac-program-pp-mag/" updated: "2026-07-20" category: Instrukcja instalacji --- # Jak zainstalować program PP Mag Poniższy artykuł opisuje standardowy proces instalacji programu PP Mag oraz aplikacji PP Kolektor. Mimo szczegółowej instrukcji zachęcamy do skorzystania z naszej pomocy podczas instalacji lub do umówienia się na weryfikację konfiguracji po jej zakończeniu. Instrukcja umożliwia uruchomienie systemu w konfiguracji wyjściowej (testowej). System można sparametryzować zgodnie z indywidualnymi oczekiwaniami. Wyjściowe parametry pozwalają na pobranie dokumentu do PP Mag, przesłanie go na kolektor oraz jego realizację w najprostszym trybie. Skontaktuj się z nami, aby przeprowadzić wstępne ustawienia (wskazanie lokalizacji towaru w magazynie, określenie pobieranych dokumentów i sposobu ich przetwarzania). W przypadku problemów skontaktuj się mailowo na adres [office@lcsoft.pl](mailto:office@lcsoft.pl).   ## **Instrukcja instalacji PP Mag:** 1. Zainstaluj serwer Firebird w wersji 2.5.x na serwerze i uruchom go jako usługę (instrukcja i pliki do pobrania: [[Instrukcja instalacji Firebird]](https://ppmag.pl/docs/jak-zainstalowac-serwer-firebird/)).Uwaga! Firebird musi być w wersji 2.5.x! 2. Pobierz i zainstaluj na serwerze program PP Mag: [[Instalator PP Mag]](https://ppmag.pl/instrukcja-aktualizacji-pp-mag/) Instalacja serwerowa – nie uruchamiaj programów po instalacji. 3. Skonfiguruj PP Mag do pracy sieciowej: 1. Przejdź do: PP Mag -> zakładka ADMINISTRACJA -> zakładka OGÓLNE -> przycisk KONF. POŁĄCZENIA. 2. Skopiuj do notatnika ścieżkę dostępu do bazy danych. 3. Kliknij przycisk RESETUJ (SERWER). 4. W polu "Ścieżka dostępu do bazy danych" wklej skopiowaną wcześniej ścieżkę. 5. W polu "Adres serwera" wpisz IP swojego serwera. 6. Kliknij przycisk TESTUJ, aby upewnić się, że połączenie jest poprawne. Jeśli test połączenia nie powiedzie się – sprawdź zaporę systemową lub konfigurację IP. 4. Uruchom program Serwer Sfera (dla używanej wersji Subiekta). 5. W programie Serwer Sfera -> zakładka POŁĄCZENIE podaj dane dostępowe do bazy SQL Subiekta (kliknięcie przycisku TESTUJ POŁĄCZENIE powinno zwrócić komunikat "Połączenie poprawne"). 6. W programie Serwer Sfera -> zakładka SFERA podaj dane dostępowe do Sfery (w przypadku konfiguracji Subiekta nexo wskaż również katalog z binariami). 7. Po ustanowieniu połączenia zamknij program Serwer Sfera przyciskiem ZAMKNIJ PROGRAM. 8. Uruchom program PP Mag i zezwól na aktualizację bazy. 9. Otwórz: PP Mag -> zakładka ADMINISTRACJA -> zakładka KLUCZE i wpisz klucze otrzymane w wiadomości e-mail (cały blok kluczy jednocześnie). 10. Przejdź do: PP Mag -> zakładka WYDANIA/PRZYJĘCIA -> ikona koła zębatego -> [EDYTUJ ŹRÓDŁO](https://ppmag.pl/docs/jak-dodac-zrodlo-ppmag/). 11. Otwórz serwer IIS i dodaj witrynę ppkolektor (szczegóły w sekcji "Instrukcja konfiguracji API" poniżej). 12. Zainstaluj pakiet .NET CORE hosting bundle w wersji 3.1.28: [[instalator .NET Core 3.1.28]](https://download.visualstudio.microsoft.com/download/pr/6744eb9d-dcd4-4386-9d87-b03b70fc58ce/818fadf3f3d919c17ba845b2195bfd9b/dotnet-hosting-3.1.32-win.exe).Sprawdź, czy po wpisaniu w przeglądarce IP serwera pojawia się pomarańczowa strona aplikacji ppkolektor – jeśli się nie pojawi, zrestartuj serwer i sprawdź ponowanie. ## **Instrukcja instalacji PP Kolektor:** 1. Zainstaluj na kolektorze plik PPKolektor.apk (aplikacja znajduje się na dysku serwera w katalogu C:\ppkolektor\wwwroot\Pliki). 2. Uruchom aplikację na kolektorze i wybierz opcję WCZYTAJ IP – wprowadź tam adres IP swojego serwera. 3. Zaloguj się domyślnym kodem PIN: 8888. 4. Po zalogowaniu kliknij przycisk WCZYTAJ UST. i wybierz ustawienia testowe, a następnie kliknij przycisk ZMIEŃ MAGAZYN i wybierz magazyn z listy.   ## **Instrukcja konfiguracji API** 1. Sprawdź, czy na serwerze jest zainstalowany i skonfigurowany serwer IIS. W menu Start wpisz słowo "iis". Jeśli pojawi się Menedżer Internetowych Usług Informacyjnych (IIS), przejdź do kolejnego kroku. Jeśli się nie pojawi, zainstaluj i skonfiguruj IIS zgodnie z instrukcją: [[JAK WŁĄCZYĆ IIS W SYSTEMIE WINDOWS]](https://ppmag.pl/docs/jak-wlaczyc-iis-w-systemie-windows/).Aby to sprawdzić, wpisz w menu Start słowo iis. 2. Uruchom IIS (Start → Menedżer Internetowych Usług Informacyjnych (IIS)). 3. W lewym panelu rozwiń węzeł serwera, kliknij prawym przyciskiem myszy pozycję „Witryny” i wybierz opcję „Dodaj witrynę sieci Web”. 4. W polu Nazwa wpisz: ppkolektor. 5. Wskaż ścieżkę: C:\ppkolektor\. 6. Ustaw typ http na porcie 80, a w polu "Adres IP" wybierz z listy adres IP swojego serwera. 7. Zapisz zmiany. Po wykonaniu konfiguracji aplikacja jest dostępna pod adresem: http://[IP_serwera] Tak przygotowane środowisko pozwala przetestować aplikację w jej podstawowym zakresie funkcjonalnym. Zachęcamy do kontaktu z nami – omówimy możliwości aplikacji oraz skonfigurujemy dodatkowe funkcjonalności. Jeśli chcesz przeprowadzić konfigurację PP Mag samodzielnie, wszystkie poradniki znajdziesz w dziale: [[Konfiguracja PP Mag]](https://ppmag.pl/docs-category/pp-mag/). Poradniki dotyczące konfiguracji programu PP Kolektor znajdują się w dziale: [[Konfiguracja PP Kolektor]](https://ppmag.pl/docs-category/pp-kolektor/). Aby wypróbować funkcjonalności związane z generowaniem listów przewozowych z kolektora, zainstaluj i skonfiguruj moduł odpowiedzialny za tę funkcjonalność zgodnie z instrukcją: [[JAK ZAINSTALOWAĆ PROGRAM PP ETYKIETA]](https://ppmag.pl/docs/jak-zainstalowac-program-pp-etykieta-modul-do-generowania-listow-przewozowych-z-kolektora/). W celu automatyzacji pracy skonfiguruj automat do pobierania dokumentów zgodnie z instrukcją: [[Uruchomienie i konfiguracja PP AutoTask]](https://ppmag.pl/docs/uruchomienie-i-konfiguracja-ppautotask/).