Manual BookStack Installation on Windows 10

Подписаться 2,2 тыс.

Просмотров 13 тыс.

50% 1

In this video go through the process of setting up BookStack on Windows 10 using XAMPP. The set-up is only intended for testing out BookStack locally, as there could be security concerns with the style of set-up used.
► BookStack Website: www.bookstackapp.com/
► BookStack Install Docs: www.bookstackapp.com/docs/adm...
► XAMPP Website: www.apachefriends.org/
► Composer Download Page: getcomposer.org/download/
► Git Website: git-scm.com/
► BookStack Demo Instance: demo.bookstackapp.com/books/b...
► BookStack Discord: / discord
► Follow BookStack on Mastodon: fosstodon.org/@bookstack
► Follow BookStack on Twitter: / bookstack_app
► Follow me on Mastodon: fosstodon.org/@danb
0:00 Intro & advisory
1:12 Software requirements
8:25 Testing Apache & phpMyAdmin
11:37 Cloning down BookStack with Git
14:24 Composer & tweaking PHP config
18:05 Database setup and .env config
26:32 Apache configuration
31:47 Migrating the database
32:49 Webserver and APP_URL debugging
34:50 Initial access
35:46 Updating BookStack
37:30 Backing up content
38:27 Outro

Хобби

Опубликовано:

19 июл 2024

Ссылка:

Скачать:

Готовим ссылку...

Добавить в:

Мой плейлист

Посмотреть позже

Комментарии : 52

@dangbro Год назад

Thank you Dan! You have such grace in presenting information. I did the windows install at the same pace as the video. Forget the hiccup towards the end of video, I do make a lot of that, without errors nobody learns anything. :)

@Awareness_is_Love Год назад

Thank's a lot Dan!! This was so helpful. Little bit tricky, but after a few additional errors i had to solve, I finally got it to work. Great job.

@jamesdavies6423 Год назад

Very good demo/instructions , very clear and you speak well! thank you

@BookStackApp Год назад

Thanks!

@avd-avd Год назад

Thank you. I saw you changed also in the Apache config the Directory path.

@creamsoda923 6 месяцев назад

Thank you Mr.Pinkman

@TheJojoMixer 8 месяцев назад

Thank you very much!

@tpks 11 месяцев назад

The installation did not work for me with the command shell opened from XAMPP. Another try with the command shell opened from the Windows start menu with admin rights and it workes smoothly. Thank you for that video! It is very helpful for testing Bookstack and its features. :)

@paulpaschert6215 Год назад

Best Installationtutorial out there on

@raazdesai Год назад

Thank you.

@nhussain84 Год назад

love it.

@bbvbfdgbfg Год назад

Thank you so much for the detailed video. Could you help me with an error I am getting? I am trying to edit the HTTPS-hosts.conf file and I keep getting the same error that you got even after making the changes that you did.

@jservitus8275 Месяц назад

great tutorial but there is no recommendations for troubleshooting. I got all the way to the php artisan migrate command and was given a sqlstate [hy000] [1045} access denied error that I can't find a solution. I've gone back through this vid . . . FAR to many times but see no missteps. Anyone?

@MsTajc 8 месяцев назад

22:12:24 [Apache] Port 80 in use by "Unable to open process" with PID 7176!

@BookStackApp 8 месяцев назад

This indicates that either something else is already serving web content on your machine, or you didn't change the port number as I did at about 28:35

@drakekl9413 Год назад

11:11 Is it necessary to use port 8080? Or can I use another random number (like 3, 63485, 1698, ...) as well?

@BookStackApp Год назад

You can use any port you'd prefer. It'll need to be less than 65535, and anything below 1023 can often already be used by other things and sometimes needs more privileges depending on system, so between 1024 and 65535 is usually safe. There's a part in the video later on where the port number is used in apache config, so be sure to also change that.

@nickhatch6285 9 месяцев назад

Thanks for the video it worked a treat for me. Is there a way of making the localhost instance of bookstack accessible from another PC on the same network so it can be shared by two users? Thanks.

@BookStackApp 9 месяцев назад

Happy this was helpful! Yeah, that's possible, but you'll need to standardise on a hostname/IP that will point to the correct location from both systems/users (so your system's local network IP address). This would need to be updated in the apache virtualhost config (ServerName option) and BookStack APP_URL .env option. Also, the other system would need access/visibility to the webserver over the network (so no firewalls blocking anything.)

@nickhatch6285 9 месяцев назад

@@BookStackApp Thanks for getting back to me, all working a treat now from multiple clients.

@dr.pepperthenecrohealer8730 Год назад

How to you Copy the .env.example file to .env and fill with your own database and mail details. That is the part were I get stuck at and I wasn't able to generate a key

@BookStackApp Год назад

I show the exact process at 18:05 in the video.

@mrtz7786 Год назад

Hello there, any tips on setting up https for bookstack? We have a windows pki in our domain, but bookstack is my first webserver thing… so I cannot get it to work. Thanks!

@BookStackApp Год назад

I have no idea about Windows PKI, but otherwise all HTTPS configuration would be done in the virtual host file for apache as per normal apache config/processes (Many guides out there, I'd recommend the mozilla TLS configurator to help with this). Only thing that need to be done for BookStack itself is updating the `APP_URL` in the `.env` and run the "Update System URL" command if you have existing content: www.bookstackapp.com/docs/admin/commands/#update-system-url

@maezy8518 Год назад

Help me sir I cannot rename .env 18:32, it shows pop up warning message “you must type a filename.”

@jaygreentree4394 Год назад

29:00 you can actually run vhosts on port 80 if you have a domain

@BookStackApp Год назад

Apache is already running on port 80 & 443 by default. I use an alternative port here specifically to avoid any interference with any of the default apache vhosts (Like phpMyAdmin or the default xampp splash page).

@jaygreentree4394 Год назад

@@BookStackApp As long as you have the trailing slash / for /phpmyadmin/ it will load even with mod_rewrite enabled because phpmyadmin is symlinked to an outside directory

@drakekl9413 Год назад

Is there also a way to publish books on the internet after creating them? Because I only find installation tutorials for this local BookStack. What exactly do I need to install to publish BookStack books on the internet (https) after creating them instead of creating them only locally with no way of publishing them?

@BookStackApp Год назад

There is no concept of "Publishing" in BookStack. You could create a publicly accessible instance, but you could not easily "publish" between a private and public instance. Making an instance public to the internet is a matter of general networking. You could make a local windows install such as this publicly accessible on the internet, but it can be quite complicated (Depending on how your ISP provide things) and can have security implications. Typically it's easiest to set up an instance on webserver that's set-up for web access, like a VPS. My video here shows an example process of this: ru-vid.com/video/%D0%B2%D0%B8%D0%B4%D0%B5%D0%BE-wq78komr9rs.html

@justshortsreal 10 месяцев назад

I had an "This site can’t provide a secure connection" error and it was because my .env file was "APP_URL=https" when it needs to be "APP_URL=http:"

@Robin-gc2vi 3 месяца назад

love you!

@vishnuyadavk 3 месяца назад

Anyone stuck in 17:10, just install 7zip and run the command again it will work

@MrKosmos088 5 месяцев назад

thanks it works excellent, but i dont know how to share the access in my internal network to give access to my coworkers, is any configuration in env file?

@BookStackApp 5 месяцев назад

There's no easy option within the BookStack config. This is a general networking/webserver level thing to manage. Within the apache config you'd need to user a "ServerName" that's your local network IP. (and restart apache). Then update the "APP_URL" value in the ".env" file file also be using your local IP instead of "localhost". Then you'd also need to make sure that port used (8080 in this video) is open on your Windows firewall. Then others should be able to connect on ":8080"

@MrKosmos088 5 месяцев назад

@@BookStackApp thanks!!!!

@micro7567 2 года назад

💕🌷

@drakekl9413 Год назад

5:12 Why exactly is this the standard? For cross-platform projects, it is the recommended setting on Unix, not on Windows. And the installation video shows us a Windows installation of Git.

@BookStackApp Год назад

I didn't meant to say that is "the standard", I just meant it as that it would keep line ending the same/standard as per the source. As I said, probably no issue using the other options but I had not checked on any implications of converting line endings across the code-base so I chose the option I did just to be safe to not add another variable.

@lukasmorn3812 Год назад

i feel like such a noob. I constantly get error: mysqli extension is missing, i have no idea i thats bad, and looking up online forums does not help. This was supposed to be an easy: i want to build my own home wiki, and now i just feel awful :/

@BookStackApp Год назад

Don't be too hard on yourself. This isn't really made to be easy for installing like this on Windows, it can be a lot to understand, learn & go through if unfamiliar with web servers and stuff. I'm only confident with this stuff since I've been doing it for over 10 years now. I took me a lot of time to understand this stuff in the early days too. Not sure where you're seeing that error. You could make sure the `mysqli` and `pdo_mysql` extensions are not commented in the `php.ini` file (Which I go to at about 15:13 in this video).

@istechdoc Год назад

Got an error message "An unknown error occurred" when I log in for the first time. Help? Windows 11.

@BookStackApp Год назад

Worth checking your error log, or enabling debug view: www.bookstackapp.com/docs/admin/debugging/#error-log-file

@istechdoc Год назад

@@BookStackApp [previous exception] [object] (Illuminate\\View\\ViewException(code: 0): SQLSTATE[HY000] [1044] Access denied for user 'bookstack'@'localhost' to database 'bookstack' (SQL: select * from `users` where `system_name` = public limit 1) (View: C:\\xampp\\htdocs\\bookstack\ esources\\views\\layouts\\base.blade.php) at C:\\xampp\\htdocs\\bookstack\\vendor\\laravel\\framework\\src\\Illuminate\\Database\\Connection.php:760) [stacktrace]

@Lorenz0408 11 месяцев назад

why dont i see css

@BookStackApp 11 месяцев назад

Most often due to an incorrect "APP_URL" value in your ".env" relative to how you're accessing in browser.

@crystalcortexx Год назад

This is insane. Why isn't there just an exe download like Notion???

@BookStackApp Год назад

Because this is built completely differently as a server-side-focused application. It might be possible to wrap the requirements to an exe but it's not really worth the initial and continued time & maintenance investment to make that work, especially when usage in local windows environments is really more of an edge case for platform usage. You could also say: This is insane. Why can't I use all of Notion's features for free & entirely within my control?

@carnap355 Год назад

why can't there just be an exe installer...

@BookStackApp Год назад

Because it's not built to be a local desktop/windows application, and I don't want to dedicate a lot of time to specifically target that platform, I'd rather keep the project fairly platform abstract.