{"id":344,"date":"2025-07-25T20:19:24","date_gmt":"2025-07-25T18:19:24","guid":{"rendered":"https:\/\/netcloud24.com\/pl\/blog\/?p=344"},"modified":"2025-07-25T20:19:24","modified_gmt":"2025-07-25T18:19:24","slug":"jak-zainstalowac-bookstack-na-debianie-12-bookworm","status":"publish","type":"post","link":"https:\/\/netcloud24.com\/pl\/blog\/jak-zainstalowac-bookstack-na-debianie-12-bookworm\/","title":{"rendered":"Jak Zainstalowa\u0107 BookStack na Debianie 12 (Bookworm)"},"content":{"rendered":"<header>\n<h1><\/h1>\n<\/header>\n<p><strong>BookStack<\/strong> to proste i otwarte oprogramowanie do tworzenia i organizowania dokumentacji, notatek i wiedzy. Jest to \u015bwietne rozwi\u0105zanie dla zespo\u0142\u00f3w, firm lub nawet do u\u017cytku osobistego. BookStack jest zbudowany w oparciu o framework Laravel i u\u017cywa PHP, Nginx\/Apache oraz MySQL\/MariaDB. Ten przewodnik przeprowadzi Ci\u0119 przez proces instalacji BookStack na serwerze z systemem operacyjnym Debian 12 (Bookworm).<\/p>\n<div class=\"note\"><strong>Uwaga:<\/strong> Ten przewodnik zak\u0142ada, \u017ce masz podstawow\u0105 wiedz\u0119 na temat zarz\u0105dzania serwerami Linux i polece\u0144 terminala. Wszelkie polecenia nale\u017cy wykonywa\u0107 z uprawnieniami roota lub za pomoc\u0105 `sudo`.<\/div>\n<h2>Spis Tre\u015bci<\/h2>\n<ol>\n<li><a href=\"#prerequisites\">Wymagania Wst\u0119pne<\/a><\/li>\n<li><a href=\"#system-update\">Aktualizacja Systemu<\/a><\/li>\n<li><a href=\"#install-webserver-php\">Instalacja Serwera WWW (Nginx) i PHP<\/a><\/li>\n<li><a href=\"#install-database\">Instalacja Bazy Danych (MariaDB)<\/a><\/li>\n<li><a href=\"#install-composer\">Instalacja Composera<\/a><\/li>\n<li><a href=\"#install-bookstack\">Instalacja BookStack<\/a><\/li>\n<li><a href=\"#configure-nginx\">Konfiguracja Nginx<\/a><\/li>\n<li><a href=\"#configure-firewall\">Konfiguracja Zapory Sieciowej (UFW)<\/a><\/li>\n<li><a href=\"#access-bookstack\">Dost\u0119p do BookStack<\/a><\/li>\n<li><a href=\"#linux-vps-promo\">Promocja: Postaw BookStack na naszym VPS Linux!<\/a><\/li>\n<li><a href=\"#conclusion\">Podsumowanie<\/a><\/li>\n<\/ol>\n<p>&#8212;<\/p>\n<h2 id=\"prerequisites\">1. Wymagania Wst\u0119pne<\/h2>\n<ul>\n<li>Serwer z zainstalowanym czystym systemem **Debian 12 (Bookworm)**.<\/li>\n<li>Dost\u0119p root lub u\u017cytkownik z uprawnieniami `sudo`.<\/li>\n<li>Minimum 2 GB RAM (zalecane 4 GB lub wi\u0119cej).<\/li>\n<li>Minimum 10 GB wolnej przestrzeni dyskowej.<\/li>\n<li>Dost\u0119p do internetu.<\/li>\n<li>Nazwa domeny (np. `twojadomena.com`) lub adres IP serwera.<\/li>\n<\/ul>\n<p>&#8212;<\/p>\n<h2 id=\"system-update\">2. Aktualizacja Systemu<\/h2>\n<p>Zawsze zacznij od aktualizacji list pakiet\u00f3w i uaktualnienia istniej\u0105cych pakiet\u00f3w do najnowszych wersji. To zapewnia, \u017ce masz najnowsze poprawki bezpiecze\u0144stwa i zale\u017cno\u015bci.<\/p>\n<pre><code>sudo apt update &amp;&amp; sudo apt upgrade -y\r\nsudo apt dist-upgrade -y\r\nsudo apt autoremove -y<\/code><\/pre>\n<p>&#8212;<\/p>\n<h2 id=\"install-webserver-php\">3. Instalacja Serwera WWW (Nginx) i PHP<\/h2>\n<p>BookStack wymaga serwera WWW (Nginx lub Apache) oraz PHP w wersji 8.1 lub nowszej. Debian 12 domy\u015blnie dostarcza PHP 8.2, co jest idealne.<\/p>\n<pre><code>sudo apt install nginx php8.2 php8.2-fpm php8.2-mysql php8.2-gd php8.2-curl php8.2-mbstring php8.2-xml php8.2-zip php8.2-cli unzip git -y<\/code><\/pre>\n<p>Po instalacji upewnij si\u0119, \u017ce Nginx i PHP-FPM s\u0105 uruchomione i w\u0142\u0105czone do startu systemu:<\/p>\n<pre><code>sudo systemctl start nginx\r\nsudo systemctl enable nginx\r\nsudo systemctl start php8.2-fpm\r\nsudo systemctl enable php8.2-fpm<\/code><\/pre>\n<p>&#8212;<\/p>\n<h2 id=\"install-database\">4. Instalacja Bazy Danych (MariaDB)<\/h2>\n<p>BookStack wymaga bazy danych MySQL lub MariaDB. W tym przewodniku u\u017cyjemy MariaDB.<\/p>\n<pre><code>sudo apt install mariadb-server mariadb-client -y<\/code><\/pre>\n<p>Zabezpiecz instalacj\u0119 MariaDB i ustaw has\u0142o dla u\u017cytkownika `root` bazy danych:<\/p>\n<pre><code>sudo mysql_secure_installation<\/code><\/pre>\n<p>Post\u0119puj zgodnie z instrukcjami: ustaw has\u0142o dla roota MariaDB, usu\u0144 anonimowych u\u017cytkownik\u00f3w, zablokuj zdalny dost\u0119p roota i usu\u0144 testow\u0105 baz\u0119 danych.<\/p>\n<p>Zaloguj si\u0119 do MariaDB i utw\u00f3rz baz\u0119 danych oraz u\u017cytkownika dla BookStack:<\/p>\n<pre><code>sudo mysql -u root -p<\/code><\/pre>\n<p>Wprowad\u017a swoje has\u0142o roota MariaDB. Nast\u0119pnie wykonaj polecenia SQL:<\/p>\n<pre><code>CREATE DATABASE bookstack;\r\nCREATE USER 'bookstackuser'@'localhost' IDENTIFIED BY 'Twoje_Mega_Silne_Haslo_DB!';\r\nGRANT ALL PRIVILEGES ON bookstack.* TO 'bookstackuser'@'localhost';\r\nFLUSH PRIVILEGES;\r\nEXIT;<\/code><\/pre>\n<p>Zast\u0105p `Twoje_Mega_Silne_Haslo_DB!` bezpiecznym i unikalnym has\u0142em.<\/p>\n<p>&#8212;<\/p>\n<h2 id=\"install-composer\">5. Instalacja Composera<\/h2>\n<p>Composer to mened\u017cer zale\u017cno\u015bci dla PHP, niezb\u0119dny do instalacji BookStack.<\/p>\n<pre><code>cd ~\r\ncurl -sS https:\/\/getcomposer.org\/installer | php\r\nsudo mv composer.phar \/usr\/local\/bin\/composer<\/code><\/pre>\n<p>Zweryfikuj instalacj\u0119:<\/p>\n<pre><code>composer --version<\/code><\/pre>\n<p>&#8212;<\/p>\n<h2 id=\"install-bookstack\">6. Instalacja BookStack<\/h2>\n<p>Stw\u00f3rz katalog dla BookStack, pobierz pliki z GitHub i skonfiguruj zale\u017cno\u015bci.<\/p>\n<h3>Tworzenie Katalogu i Klonowanie Repozytorium<\/h3>\n<pre><code>sudo mkdir -p \/var\/www\/bookstack\r\nsudo chown -R www-data:www-data \/var\/www\/bookstack # Zapewnij odpowiednie uprawnienia\r\nsudo git clone https:\/\/github.com\/BookStackApp\/BookStack.git \/var\/www\/bookstack<\/code><\/pre>\n<h3>Konfiguracja Uprawnie\u0144<\/h3>\n<pre><code>sudo chown -R www-data:www-data \/var\/www\/bookstack\r\nsudo chmod -R 755 \/var\/www\/bookstack\r\nsudo chmod -R 775 \/var\/www\/bookstack\/storage \/var\/www\/bookstack\/bootstrap\/cache \/var\/www\/bookstack\/public\/uploads<\/code><\/pre>\n<h3>Instalacja Zale\u017cno\u015bci Composera<\/h3>\n<pre><code>cd \/var\/www\/bookstack\r\nsudo composer install --no-dev<\/code><\/pre>\n<h3>Konfiguracja Pliku \u015arodowiskowego (.env)<\/h3>\n<p>Utw\u00f3rz plik `.env` i uzupe\u0142nij dane bazy danych oraz URL aplikacji.<\/p>\n<pre><code>sudo cp .env.example .env\r\nsudo nano .env<\/code><\/pre>\n<p>Edytuj nast\u0119puj\u0105ce linie, u\u017cywaj\u0105c danych bazy danych, kt\u00f3re utworzy\u0142e\u015b:<\/p>\n<pre><code>APP_URL=http:\/\/twojadomena.com # Lub https:\/\/twojadomena.com je\u015bli u\u017cywasz SSL\r\nDB_CONNECTION=mysql\r\nDB_HOST=127.0.0.1\r\nDB_PORT=3306\r\nDB_DATABASE=bookstack\r\nDB_USERNAME=bookstackuser\r\nDB_PASSWORD=Twoje_Mega_Silne_Haslo_DB!<\/code><\/pre>\n<p>Zapisz i zamknij plik.<\/p>\n<h3>Generowanie Klucza Aplikacji Laravel<\/h3>\n<pre><code>sudo php artisan key:generate<\/code><\/pre>\n<h3>Uruchamianie Migracji Bazy Danych<\/h3>\n<pre><code>sudo php artisan migrate<\/code><\/pre>\n<div class=\"note\"><strong>Uwaga:<\/strong> Po migracji bazy danych mo\u017cesz zobaczy\u0107 pytanie, czy chcesz uruchomi\u0107 komend\u0119 tworzenia domy\u015blnego u\u017cytkownika (`php artisan db:seed`). Mo\u017cesz to zrobi\u0107 lub utworzy\u0107 u\u017cytkownika r\u0119cznie przez interfejs po instalacji.<\/div>\n<p>&#8212;<\/p>\n<h2 id=\"configure-nginx\">7. Konfiguracja Nginx<\/h2>\n<p>Stw\u00f3rz plik konfiguracyjny Nginx dla BookStack.<\/p>\n<pre><code>sudo nano \/etc\/nginx\/sites-available\/bookstack.conf<\/code><\/pre>\n<p>Wklej nast\u0119puj\u0105c\u0105 konfiguracj\u0119 (zast\u0105p `twojadomena.com` swoj\u0105 domen\u0105 lub adresem IP serwera):<\/p>\n<pre><code>server {\r\n    listen 80;\r\n    server_name twojadomena.com; # Zmie\u0144 na swoj\u0105 domen\u0119 lub adres IP\r\n    root \/var\/www\/bookstack\/public;\r\n\r\n    index index.php index.html index.htm;\r\n\r\n    charset utf-8;\r\n\r\n    location \/ {\r\n        try_files $uri $uri\/ \/index.php?$query_string;\r\n    }\r\n\r\n    location = \/favicon.ico { access_log off; log_not_found off; }\r\n    location = \/robots.txt  { access_log off; log_not_found off; }\r\n\r\n    error_page 404 \/index.php;\r\n\r\n    location ~ \\.php$ {\r\n        fastcgi_pass unix:\/var\/run\/php\/php8.2-fpm.sock;\r\n        fastcgi_index index.php;\r\n        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;\r\n        include fastcgi_params;\r\n    }\r\n\r\n    location ~ \/\\.(?!well-known).* {\r\n        deny all;\r\n    }\r\n}<\/code><\/pre>\n<p>Zapisz i zamknij plik.<\/p>\n<h3>Aktywacja Konfiguracji i Ponowne Uruchomienie Nginx<\/h3>\n<pre><code>sudo ln -s \/etc\/nginx\/sites-available\/bookstack.conf \/etc\/nginx\/sites-enabled\/\r\nsudo nginx -t # Test konfiguracji\r\nsudo systemctl restart nginx\r\nsudo systemctl reload nginx<\/code><\/pre>\n<p>Usu\u0144 domy\u015bln\u0105 konfiguracj\u0119 Nginx, aby unikn\u0105\u0107 konflikt\u00f3w:<\/p>\n<pre><code>sudo rm \/etc\/nginx\/sites-enabled\/default<\/code><\/pre>\n<p>&#8212;<\/p>\n<h2 id=\"configure-firewall\">8. Konfiguracja Zapory Sieciowej (UFW)<\/h2>\n<p>Upewnij si\u0119, \u017ce porty HTTP (80) i HTTPS (443, je\u015bli skonfigurujesz SSL) s\u0105 otwarte.<\/p>\n<pre><code>sudo apt install ufw -y # Je\u015bli nie zainstalowano\r\nsudo ufw default deny incoming\r\nsudo ufw default allow outgoing\r\nsudo ufw allow 22\/tcp comment 'Allow SSH'\r\nsudo ufw allow 80\/tcp comment 'Allow HTTP'\r\nsudo ufw allow 443\/tcp comment 'Allow HTTPS (if applicable)'\r\nsudo ufw enable # Potwierd\u017a y<\/code><\/pre>\n<p>Sprawd\u017a status UFW:<\/p>\n<pre><code>sudo ufw status verbose<\/code><\/pre>\n<p>&#8212;<\/p>\n<h2 id=\"access-bookstack\">9. Dost\u0119p do BookStack<\/h2>\n<p>Po wykonaniu wszystkich krok\u00f3w, powiniene\u015b m\u00f3c uzyska\u0107 dost\u0119p do swojej instalacji BookStack, wpisuj\u0105c adres swojej domeny (lub adres IP serwera) w przegl\u0105darce:<\/p>\n<p><code>http:\/\/twojadomena.com<\/code><\/p>\n<p>Przy pierwszym dost\u0119pie zostaniesz poproszony o utworzenie konta administratora. U\u017cyj domy\u015blnych danych logowania, je\u015bli nie stworzy\u0142e\u015b u\u017cytkownika podczas migracji:<\/p>\n<ul>\n<li>**Email:** `admin@admin.com`<\/li>\n<li>**Has\u0142o:** `password`<\/li>\n<\/ul>\n<p><strong>Pami\u0119taj, aby natychmiast zmieni\u0107 te domy\u015blne dane logowania!<\/strong><\/p>\n<p>&#8212;<\/p>\n<h2 id=\"linux-vps-promo\">10. Promocja: Postaw BookStack na naszym VPS Linux!<\/h2>\n<div class=\"promo-box\">\n<h3>Szukasz niezawodnego hostingu dla swojego BookStack?<\/h3>\n<p>Instalacja BookStack na Debianie 12 jest prosta, ale stabilno\u015b\u0107 i wydajno\u015b\u0107 zale\u017c\u0105 od jako\u015bci Twojego serwera. W Netcloud24 oferujemy **wysokiej klasy serwery VPS Linux**, idealne do hostowania aplikacji takich jak BookStack.<\/p>\n<p>Nasze VPSy Linux to:<\/p>\n<ul>\n<li><strong>Wysoka wydajno\u015b\u0107:<\/strong> Szybkie procesory i dyski SSD NVMe zapewniaj\u0105 p\u0142ynne dzia\u0142anie.<\/li>\n<li><strong>Stabilno\u015b\u0107:<\/strong> Niezawodna infrastruktura, kt\u00f3ra gwarantuje dost\u0119pno\u015b\u0107 Twojej dokumentacji.<\/li>\n<li><strong>Skalowalno\u015b\u0107:<\/strong> \u0141atwe zwi\u0119kszanie zasob\u00f3w w miar\u0119 wzrostu Twoich potrzeb.<\/li>\n<li><strong>Wsparcie techniczne:<\/strong> Nasi eksperci s\u0105 gotowi pom\u00f3c Ci w ka\u017cdej chwili.<\/li>\n<\/ul>\n<p>Zainwestuj w profesjonalne \u015brodowisko dla swojego BookStack i ciesz si\u0119 bezproblemowym zarz\u0105dzaniem wiedz\u0105.<\/p>\n<p><a href=\"https:\/\/netcloud24.com\/serwery\/vps-linux\/\" target=\"_blank\" rel=\"noopener\">Sprawd\u017a nasz\u0105 ofert\u0119 VPS Linux ju\u017c dzi\u015b!<\/a><\/p>\n<p>Odwied\u017a r\u00f3wnie\u017c nasz\u0105 stron\u0119 g\u0142\u00f3wn\u0105, aby dowiedzie\u0107 si\u0119 wi\u0119cej o wszystkich naszych us\u0142ugach hostingowych: <a href=\"https:\/\/netcloud24.com\/\" target=\"_blank\" rel=\"noopener\">Netcloud24.com<\/a><\/p>\n<\/div>\n<p>&#8212;<\/p>\n<h2 id=\"conclusion\">Podsumowanie<\/h2>\n<p>Gratulacje! Pomy\u015blnie zainstalowa\u0142e\u015b BookStack na swoim serwerze z Debianem 12. Teraz mo\u017cesz rozpocz\u0105\u0107 tworzenie i organizowanie swojej dokumentacji w intuicyjnym i pot\u0119\u017cnym \u015brodowisku.<\/p>\n<p>Pami\u0119taj o regularnych aktualizacjach BookStack, PHP i systemu operacyjnego, aby zapewni\u0107 bezpiecze\u0144stwo i dost\u0119p do najnowszych funkcji. Rozwa\u017c r\u00f3wnie\u017c konfiguracj\u0119 certyfikatu SSL (np. za pomoc\u0105 Let&#8217;s Encrypt), aby zabezpieczy\u0107 komunikacj\u0119 z Twoim BookStackiem.<\/p>\n<footer>\u00a9 2025 Wszystkie prawa zastrze\u017cone.<\/p>\n<p>Powered by <a href=\"https:\/\/netcloud24.com\/\" target=\"_blank\" rel=\"noopener\">Netcloud24.com<\/a><\/p>\n<\/footer>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>BookStack to proste i otwarte oprogramowanie do tworzenia i organizowania dokumentacji, notatek i wiedzy. Jest to \u015bwietne rozwi\u0105zanie dla zespo\u0142\u00f3w, firm lub nawet do u\u017cytku\u2026<\/p>\n","protected":false},"author":1,"featured_media":342,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-344","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-linux"],"_links":{"self":[{"href":"https:\/\/netcloud24.com\/pl\/blog\/wp-json\/wp\/v2\/posts\/344","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/netcloud24.com\/pl\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/netcloud24.com\/pl\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/netcloud24.com\/pl\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/netcloud24.com\/pl\/blog\/wp-json\/wp\/v2\/comments?post=344"}],"version-history":[{"count":1,"href":"https:\/\/netcloud24.com\/pl\/blog\/wp-json\/wp\/v2\/posts\/344\/revisions"}],"predecessor-version":[{"id":345,"href":"https:\/\/netcloud24.com\/pl\/blog\/wp-json\/wp\/v2\/posts\/344\/revisions\/345"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/netcloud24.com\/pl\/blog\/wp-json\/wp\/v2\/media\/342"}],"wp:attachment":[{"href":"https:\/\/netcloud24.com\/pl\/blog\/wp-json\/wp\/v2\/media?parent=344"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/netcloud24.com\/pl\/blog\/wp-json\/wp\/v2\/categories?post=344"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/netcloud24.com\/pl\/blog\/wp-json\/wp\/v2\/tags?post=344"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}