diff --git a/docs/install/linux.pl.md b/docs/install/linux.pl.md
new file mode 100644
index 00000000..674028f2
--- /dev/null
+++ b/docs/install/linux.pl.md
@@ -0,0 +1,62 @@
+# Zainstaluj na Linux
+
+Aby używać Vapor, będziesz potrzebować Swifta w wersji 5.6 lub wyższej. Możesz go zainstalować używając jednego z plików instalacyjnych na [Swift.org](https://swift.org/download/).
+
+## Wspierane dystrybucje i wersje
+
+Vapor wspiera te same wersje dystrybucji Linuxa jak wersja 5.6 lub nowsza Swifta.
+
+!!! note
+    Wspierane wersje wypisane poniżej mogą być przeterminowane w momencie gdy to czytasz. Możesz zobaczyć które systemy operacyjne czy dystrybucje są wpierane na stronie [Swift Releases](https://swift.org/download/#releases).
+
+|Dystrybucja|Wersja|Wersja Swift|
+|-|-|-|
+|Ubuntu|20.04|>= 5.6|
+|Fedora|>= 30|>= 5.6|
+|CentOS|8|>= 5.6|
+|Amazon Linux|2|>= 5.6|
+
+Dystrybucje Linuxa które nie są oficjalnie wspierane mogą również użyć Swifta po przez kompilacje kodu źródłowego, lecz Vapor nie daje gwarancji stabilności. Dowiedz się więcej o kompilacji Swifta z oficjalnego repozytorium [Swift repo](https://github.com/apple/swift#getting-started).
+
+## Instalacja Swifta
+
+Wejdź na Swift.org i użyj instrukcji pod adresem [Using Downloads](https://swift.org/download/#using-downloads) aby zainstalować Swifta na Linux.
+
+### Fedora
+
+Użytkownicy Fedory mogę po prostu użyć następującej komendy aby zainstalować Swifta:
+
+```sh
+sudo dnf install swift-lang
+```
+
+Jeśli używasz Fedora 30, będziesz musiał dodać EPEL 8, aby używać Swifta 5.6 lub nowszego.
+
+## Docker
+
+Możesz również użyć oficjalnego obrazu Docker Swifta, który ma już preinstalowany kompilator. Dowiedz się więcej na [Swift's Docker Hub](https://hub.docker.com/_/swift).
+
+## Zainstaluj Toolbox
+
+Teraz gdy masz już zainstalowanego Swifta, zainstalujmy [Vapor Toolbox](https://github.com/vapor/toolbox). Jest to narzędzie CLI (z ang. Command Line Interface), które nie jest potrzebne by używać Vapora, natomiast jest wyposażone w przydatne usprawnienia takie jak kreator nowego projektu.
+
+Na Linux, musisz zbudować toolbox z źródła. Odwiedź [wydania](https://github.com/vapor/toolbox/releases) toolboxu na Github aby znaleźć najnowsza wersję.
+
+```sh
+git clone https://github.com/vapor/toolbox.git
+cd toolbox
+git checkout <desired version>
+make install
+```
+
+Sprawdź dwa razy czy instalacja przeszła poprawnie po przez wyświetlenie pomocy.
+
+```sh
+vapor --help
+```
+
+Powinna być widoczna lista dostępnych komend.
+
+## Następnie
+
+Kiedy już udało Ci się zainstalować Swifta, stwórz swoja pierwszą aplikacje w sekcji [Pierwsze kroki &rarr; Witaj, świecie](../getting-started/hello-world.md).
diff --git a/docs/install/macos.pl.md b/docs/install/macos.pl.md
new file mode 100644
index 00000000..79ecfcb7
--- /dev/null
+++ b/docs/install/macos.pl.md
@@ -0,0 +1,48 @@
+# Zainstaluj na macOS
+
+Aby używać Vapor na macOS, potrzebujesz Swift w wersji 5.6 lub wyższej. Swift oraz wszystkie jego zależności są częścią instalacji Xcode.
+
+## Zainstaluj Xcode
+
+Zainstaluj [Xcode](https://itunes.apple.com/us/app/xcode/id497799835?mt=12) z Mac App Store.
+
+![Xcode w Mac App Store](../images/xcode-mac-app-store.png)
+
+Po tym jak Xcode będzie już pobrany, musi go otworzyć aby skończyć instalacje. To może chwilę zająć.
+
+Dwa razy sprawdź aby upewnić się że instalacja była sukcesem otwierając Terminal i wyświetlając wersję Swifta.
+
+```sh
+swift --version
+```
+
+Powinna wyświetlić się wersja Swifta.
+
+```sh
+swift-driver version: 1.75.2 Apple Swift version 5.8 (swiftlang-5.8.0.124.2 clang-1403.0.22.11.100)
+Target: arm64-apple-macosx13.0
+```
+
+Vapor 4 wymaga wersji Swifta 5.6 lub wyższej.
+
+## Zainstaluj Toolbox
+
+Teraz gdy masz już zainstalowanego Swifta, zainstalujmy [Vapor Toolbox](https://github.com/vapor/toolbox). Jest to narzędzie CLI (z ang. Command Line Interface), które nie jest potrzebne by używać Vapora, natomiast jest wyposażone w przydatne usprawnienia takie jak kreator nowego projektu.
+
+Toolbox jest wydawany przy pomocy Homebrew. Jeśli jeszcze nie masz Homebrew, to zajrzyj na [brew.sh](https://brew.sh) po instrukcje jak zainstalować.
+
+```sh
+brew install vapor
+```
+
+Sprawdź dwa razy czy instalacja przeszła poprawnie po przez wyświetlenie pomocy.
+
+```sh
+vapor --help
+```
+
+Powinna być widoczna lista dostępnych komend.
+
+## Następnie
+
+Kiedy już udało Ci się zainstalować Swifta, stwórz swoja pierwszą aplikacje w sekcji [Pierwsze kroki &rarr; Witaj, świecie](../getting-started/hello-world.md).