Nextcloud na Raspberry Pi – własna chmura krok po kroku

Nextcloud na Raspberry Pi to tani, cichy i energooszczędny sposób na własną chmurę – z dostępem do plików z komputerów i smartfonów, synchronizacją kalendarza, kontaktów i wielu innych danych. Poniżej znajdziesz kompletny, gotowy do publikacji poradnik „krok po kroku” w języku polskim.

1. Co to jest Nextcloud i dlaczego na Raspberry Pi?

Nextcloud to otwarto‑źródłowy system do budowy prywatnej chmury – alternatywa dla Dropboxa, Google Drive czy OneDrive, którą instalujesz na własnym serwerze. Masz pełną kontrolę nad swoimi danymi i prywatnością.

Raspberry Pi (np. model 4 lub 5) świetnie się do tego nadaje, bo:

jest tanie i energooszczędne,
jest ciche (brak lub minimalny hałas),
ma bogaty ekosystem akcesoriów (obudowy, dyski, chłodzenie).

W poradniku znajdziesz dwa warianty instalacji: najprostszy (NextCloudPi) – wszystko w jednym, idealne dla początkujących; oraz bardziej elastyczny (Raspberry Pi OS + Docker + Nextcloud) – lepszy do rozbudowy w przyszłości.

2. Sprzęt i wymagania wstępne

2.1. Minimalny zestaw

Do uruchomienia prywatnej chmury na Raspberry Pi przygotuj poniższe elementy:

Raspberry Pi 4 lub 5 – da się i na starszych, ale wydajność będzie niższa;
karta microSD min. 16 GB – lepiej 32 GB lub więcej; im szybsza, tym lepiej;
zasilacz dedykowany do Twojego modelu Raspberry Pi;
kabel sieciowy Ethernet – zalecany; ewentualnie Wi‑Fi;
dysk zewnętrzny USB (HDD/SSD) – jeśli chcesz więcej miejsca niż karta SD;
komputer do przygotowania karty microSD (Windows, macOS lub Linux).

2.2. Sieć i dostęp

Potrzebujesz routera domowego (połączenie kablowe lub Wi‑Fi) oraz dostępu do jego panelu, by sprawdzić adres IP Raspberry Pi i ewentualnie ustawić przekierowanie portów.

3. Wariant 1 – najprostszy – NextCloudPi jako gotowy obraz

NextCloudPi to specjalny obraz zawierający system operacyjny dla Raspberry Pi + skonfigurowany Nextcloud + panel administracyjny. To najszybsza droga do własnej chmury.

3.1. Pobranie obrazu NextCloudPi

Na komputerze otwórz stronę projektu NextCloudPi (np. OwnYourBits).
W menu wybierz NextCloudPi i przejdź do sekcji pobierania.
Z listy obrazów wybierz NextCloudPi_RPi – wersję przeznaczoną dla Raspberry Pi i pobierz ją na komputer.
Po pobraniu otrzymasz plik .bz2 (skompresowany obraz).

Aby rozpakować pobrany obraz, kliknij prawym przyciskiem myszy plik .bz2 i wybierz Wyodrębnij – powinien pojawić się plik .img. Jeśli najpierw powstanie plik .tar, wyodrębnij go ponownie, aż uzyskasz plik .img.

3.2. Nagranie obrazu na kartę microSD (balenaEtcher)

Wykonaj poniższe kroki, aby nagrać obraz na kartę microSD:

Wyjmij kartę microSD z Raspberry Pi (jeśli była włożona) i podłącz ją do komputera (czytnik kart / adapter USB).
Pobierz i zainstaluj balenaEtcher (narzędzie do nagrywania obrazów na karty SD i pendrive’y).
Uruchom Etchera, a następnie:

kliknij Select image / Wybierz obraz i wskaż plik NextCloudPi.img,
kliknij Select target / Wybierz dysk i wybierz kartę microSD (upewnij się, że to właściwe urządzenie!),
kliknij Flash! – Etcher nagra obraz na kartę microSD.

Po zakończeniu Etcher poinformuje o sukcesie; zamknij program.
Odłącz kartę microSD od komputera i włóż ją do Raspberry Pi.

3.3. Pierwsze uruchomienie Raspberry Pi z NextCloudPi

Podłącz niezbędne elementy i włącz urządzenie:

Podłącz do Raspberry Pi:

kartę microSD z nagranym NextCloudPi,
kabel Ethernet do routera (zalecane),
zasilanie.

Raspberry Pi uruchomi się i w ciągu kilku minut dokończy pierwszą konfigurację.

3.4. Znalezienie adresu IP Raspberry Pi w sieci lokalnej

Zaloguj się do panelu routera (zwykle 192.168.0.1 lub 192.168.1.1 – sprawdź w dokumentacji) i w sekcji lista urządzeń/DHCP odczytaj przypisany adres IP Raspberry Pi, np. 192.168.1.23. Możesz też skorzystać z aplikacji typu skaner sieci na telefonie, ale panel routera jest najpewniejszy.

3.5. Wejście do panelu Nextcloud (pierwsza konfiguracja)

Wykonaj te czynności, aby zalogować się do Nextcloud i utworzyć konto administratora:

Na komputerze w tej samej sieci otwórz przeglądarkę.
Wpisz w pasku adresu IP Raspberry Pi, np.:

http://192.168.1.23,
http://192.168.1.23/,
http://192.168.1.23/nextcloud.

Powinna pojawić się strona startowa Nextcloud/NextCloudPi – utwórz konto administratora (login i hasło), a następnie zaloguj się do panelu Nextcloud jako administrator.
Po zalogowaniu zapoznaj się z informacjami na stronie startowej – Nextcloud wyświetli podstawowe wskazówki i aplikacje startowe.

3.6. Podstawowa konfiguracja Nextcloud

Po pierwszym zalogowaniu warto wykonać szybkie ustawienia startowe:

ustawić język na polski w ustawieniach konta,
przejść do Ustawienia → Administracja → Ogólne i sprawdzić status serwera (czy są jakieś ostrzeżenia),
zmienić domyślne hasło do konta systemowego NextCloudPi (jeśli panel NCP jest dostępny),
dodać nowych użytkowników, jeśli z chmury ma korzystać więcej osób.

4. Wariant 2 – Raspberry Pi OS + Docker + Nextcloud (bardziej elastycznie)

Jeśli wolisz mieć większą kontrolę, łatwe aktualizacje i możliwość uruchamiania innych usług obok Nextclouda, wybierz instalację Raspberry Pi OS, a następnie Dockera i Nextclouda w kontenerach. To świetna baza do rozbudowy domowego serwera.

4.1. Instalacja Raspberry Pi OS

Pobierz z oficjalnej strony obraz Raspberry Pi OS Lite lub z pulpitem – do zastosowań serwerowych Lite zazwyczaj wystarcza.
Nagraj obraz na kartę microSD za pomocą Raspberry Pi Imager lub balenaEtcher (proces podobny jak w przypadku NextCloudPi).
Włóż kartę do Raspberry Pi i uruchom urządzenie.
Przejdź przez wstępną konfigurację systemu (język, strefa czasowa, klawiatura, Wi‑Fi lub Ethernet) i upewnij się, że Raspberry Pi ma dostęp do Internetu.

4.2. Instalacja Dockera na Raspberry Pi OS

Zaloguj się do Raspberry Pi (bezpośrednio lub przez SSH) i zainstaluj Dockera zgodnie z oficjalną instrukcją – zwykle sprowadza się to do dodania repozytorium i instalacji pakietów przez apt.

Po instalacji warto dodać swojego użytkownika (np. pi) do grupy docker, aby nie używać sudo przy każdej komendzie. Wykonaj polecenie:

sudo usermod -aG docker pi

4.3. Przygotowanie katalogów i plików konfiguracyjnych

Utwórz katalog na pliki konfiguracyjne Nextcloud i przejdź do niego:

mkdir -p /root/nextcloud cd /root/nextcloud

W tym katalogu utwórz plik docker-compose.yml z definicją usług Nextcloud, bazy danych (np. MariaDB/PostgreSQL) i reverse proxy (opcjonalnie), zgodnie z wybraną konfiguracją.

Jeśli używasz plików .env i db.env, zaktualizuj zmienną NEXTCLOUD_EXTDATA, jeżeli planujesz przechowywać dane Nextcloud na zewnętrznym dysku.

4.4. Uruchomienie Nextcloud w Dockerze

Będąc w katalogu z docker-compose.yml, uruchom kontenery:

docker compose up -d

Kontenery z Nextcloudem i bazą danych zostaną pobrane i uruchomione.
Po starcie wejdź w przeglądarce na adres Raspberry Pi (z odpowiednim portem lub ścieżką – zależy od Twojej konfiguracji docker-compose.yml) i przeprowadź pierwszą konfigurację Nextcloud – utwórz konto administratora i podaj dane do bazy (jeśli nie zostały ustawione automatycznie).

5. Konfiguracja przestrzeni dyskowej (dyski zewnętrzne, folder danych)

Aby dane użytkowników nie trafiały na kartę microSD, zastosuj zewnętrzny dysk i wskaż go jako przestrzeń dla Nextcloud:

podłącz zewnętrzny dysk USB,
zamontuj go w systemie,
wskazuj go jako lokalizację danych Nextcloud.

Poniżej przykład dla środowiska zbliżonego do Raspberry Pi + Nextcloud (na bazie CasaOS – zasada pozostaje taka sama):

Utwórz w katalogu instalacji Nextcloud foldery na dane:

cd /DATA/AppData/nextcloud/var/www/html/ mkdir diskA mkdir diskB

Zidentyfikuj UUID podłączonych dysków (np. lsblk lub blkid) i dopisz do /etc/fstab linie montujące je do utworzonych katalogów:

# To zostało dodane ręcznie /srv/dev-disk-by-uuid-XXXX /DATA/AppData/nextcloud/var/www/html/diskA none bind 0 0 /srv/dev-disk-by-uuid-YYYY /DATA/AppData/nextcloud/var/www/html/diskB none bind 0 0

Zapisz plik i zrestartuj Raspberry Pi, aby system automatycznie montował dyski przy starcie.
Przenieś dane Nextcloud do nowej lokalizacji (jeśli zmieniasz domyślny folder data):

sudo -s cd /data cp -r * ../diskA

Ustaw odpowiednie uprawnienia dla użytkownika serwera WWW (najczęściej www-data):

chown -R www-data:www-data diskA

Zaktualizuj plik konfiguracji Nextcloud config.php, aby wskazywał nowy katalog danych (zamiast domyślnego data). Plik znajduje się zazwyczaj w /DATA/AppData/nextcloud/var/www/html/config/config.php (CasaOS) lub w /var/www/html/nextcloud/config/config.php dla klasycznej instalacji.

6. Dostęp do chmury z sieci lokalnej i z Internetu

6.1. Dostęp w sieci lokalnej

W LAN chmura będzie dostępna pod adresem http://IP_Raspberry_Pi/nextcloud (gdy Nextcloud działa w podkatalogu) lub pod http://IP_Raspberry_Pi/ (jeśli jest serwerem głównym). Adres IP znajdziesz w panelu routera lub poleceniem hostname -I na Raspberry Pi.

6.2. Dostęp z Internetu (opcjonalnie)

Aby połączyć się ze swoją chmurą spoza domu, przygotuj:

Publiczne IP – od operatora lub tunel VPN/reverse proxy (np. Cloudflare Tunnel);
przekierowanie portów w routerze (np. 80 i 443) na IP Raspberry Pi;
certyfikat HTTPS (np. Let’s Encrypt) – dla bezpiecznego połączenia.

W zaawansowanych scenariuszach sprawdzi się konfiguracja z reverse proxy, SSL i Cloudflare Zero Trust.

7. Klienci synchronizacji i aplikacje mobilne

Aby wygodnie korzystać z własnej chmury na wielu urządzeniach, wykonaj poniższe czynności:

zainstaluj klienta Nextcloud na komputerze (Windows, macOS, Linux), aby mieć synchronizowany folder z plikami;
zainstaluj aplikację Nextcloud na Androidzie lub iOS (Google Play, App Store);
wprowadź adres serwera w aplikacji/kliencie (np. https://twoja-domena.pl lub http://IP_Raspberry_Pi/nextcloud);
podaj login i hasło utworzone w panelu Nextcloud i rozpocznij synchronizację.

Nextcloud obsługuje również synchronizację kalendarza (CalDAV), kontaktów (CardDAV), notatek, zadań i wielu innych danych.