git serve can't restart when file changes #1379

SimonTart · 2016-06-10T03:13:32Z

I built gitbook serve success, but when I change file the gitbook serve restart fail.
Here is the error message.

Starting server ...
Serving book on http://localhost:4000
Restart after change in file SUMMARY.md

Stopping server
events.js:141
      throw er; // Unhandled 'error' event
      ^

Error: EPERM: operation not permitted, lstat 'G:\gitbook-touchevent\_book'
    at Error (native)

node version:4.4.2
gitook version: 2.2.0

The text was updated successfully, but these errors were encountered:

thoemmi · 2016-06-15T08:19:55Z

I'm experiencing the same issue, though the error message is slightly different:

Error: EPERM: operation not permitted, mkdir 'D:\testbook_book'

Node: 4.4.5
Gitbook: 2.2.0

ExByt3s · 2016-07-30T09:24:08Z

I have the same problem

 gitbook serve
Live reload server started on port: 35729
Press CTRL+C to quit ...

info: 7 plugins are installed
info: loading plugin "livereload"... OK
info: loading plugin "highlight"... OK
info: loading plugin "search"... OK
info: loading plugin "lunr"... OK
info: loading plugin "sharing"... OK
info: loading plugin "fontsettings"... OK
info: loading plugin "theme-default"... OK
info: found 1 pages
info: found 0 asset files
info: >> generation finished with success in 1.0s !

Starting server ...
Serving book on http://localhost:4000
Restart after change in file SUMMARY.md

Stopping server

Error: EPERM: operation not permitted, mkdir 'C:\Users\cleopatra\Desktop\abum_code\_book'

Microsoft Windows [Versión 10.0.10586]

node -v
v4.4.7

gitbook -V
CLI version: 2.3.0
GitBook version: 3.2.0

eminoda · 2016-08-10T06:04:00Z

md file changed, operation not permitted

marshhj · 2016-08-20T15:42:03Z

I meet tooooooo!!

CoDEmanX · 2016-09-14T10:33:17Z

Having this problem too.

NodeJS v6.2.0
CLI version: 2.2.0
GitBook version: 3.2.0

Starting server ...
Serving book on http://localhost:4000
Restart after change in file SUMMARY.md

Stopping server

Error: EPERM: operation not permitted, mkdir 'C:...\gitbook3\Manual_book'

leohxj · 2016-09-18T03:06:50Z

Same problem:

Stopping server
events.js:141
      throw er; // Unhandled 'error' event
      ^

Error: EPERM: operation not permitted, lstat 'F:\leo-workspace\share\gitbook\gitbook-demo\_book'
    at Error (native)

F:\leo-workspace\share\gitbook\gitbook-demo>gitbook -V
CLI version: 2.3.0
GitBook version: 3.2.0

F:\leo-workspace\share\gitbook\gitbook-demo>node --version
v4.2.0

F:\leo-workspace\share\gitbook\gitbook-demo>npm --version
3.10.6

craigbutcher · 2016-09-23T10:36:16Z

Same issue here.

Windows 7 N
NodeJS v6.5.0
CLI version: 2.3.0
GitBook version: 3.2.0

Starting server ...
Serving book on http://localhost:4000
Restart after change in file environments\list-of-environments.md

Error: EPERM: operation not permitted, open 'C:\Users\craig\playground\gitbook\_book\456\README.md'

I'm not sure why it is trying to access the README.md even the file is available?

CliffHan · 2016-10-20T01:09:02Z

same issue, EPERM on mkdir operation, windows 10

budiadiono · 2016-10-24T10:19:40Z

I have same issue with Windows 10. While waiting for this issue get resolved, I've created gulp task using browser-sync and gulp-run to replace gitbook serve in my project:

// gulpfile.js

var browserSync = require('browser-sync');
var gulp = require('gulp')
var run = require('gulp-run')

gulp.task('browser-sync', function() {
    browserSync({
        server: {
            baseDir: "./docs/_book"
        }
    });
});

gulp.task('build-doc', function () {
    run('npm run docs:build').exec('', function() {
        run('echo docs:build DONE!').exec().pipe(browserSync.reload({stream:true}));
    });

})

gulp.task('watch', function() {
    gulp.watch('./docs/**/*.md', ['build-doc']);
})

gulp.task('default', ['build-doc', 'browser-sync', 'watch']);

// package.json

"scripts": {
  "docs:build": "cd docs && gitbook build",
  ...

Maybe this could help someone life. Or any better idea?

UPDATE
This one: https://gist.github.com/budiadiono/dd409e2168c801c9e7429766ee0101c3 is much better.

mlidbom · 2016-10-27T12:50:05Z

Same problem as #1309?

mlidbom · 2016-10-27T13:04:00Z

I have a branch on a public repository where I see this problem every time any file is updated: https://github.com/mlidbom/AsciiDocScratch/tree/gitbook-serve-bug-repro

Hope this might help with tracking down the problem.

budiadiono · 2016-10-30T03:00:20Z

In Windows 10, the problem gone when I run gitbook serve from git bash maybe this is Windows issue with bash command instead?

I'm using these versions:

Gitbook CLI version: 2.3.0
GitBook version: 3.2.2
Node v6.9.1

CliffHan · 2016-10-31T02:08:51Z

To budiadiono:
I just tried git bash, and the problem still exists with the same response.
"Error: EPERM: operation not permitted, mkdir '....._book'"

Gitbook CLI version: 2.3.0
GitBook version: 3.2.2
Node v4.4.7

budiadiono · 2016-10-31T02:38:30Z

Hi @CliffHan, what is the emulator version of gitbash did you use? My machine installed with git version 2.5.1.windows.1 along with gitbash that using mintty emulator version 2.0.3 (x86_64-pc-msys). Maybe to workaround you want to use msys2 instead?

CliffHan · 2016-10-31T06:35:48Z

Hi @budiadiono , my git version is 2.9.2 for windows.
bash version:
GNU bash, version 4.3.46(2)-release-(x86_64-pc-msys)
msys2? Maybe I'd like to give a try.

CliffHan · 2016-11-04T07:35:31Z

Last Friday it worked normally, and today it failed again.
I DO think it's some kind of permission issue, with some gitbook/nodejs service or service they used.

cortexcompiler · 2016-11-08T18:19:19Z

I see this issue on Windows also. I have seen some threads related to grunt that say you can avoid the problem by running the CMD window as administrator. I am not a big fan of that solution but it may work for some.

ghost · 2016-12-15T12:38:11Z

+1 fails quite often, Windows 7

githoniel · 2017-02-20T08:47:51Z

+1 fails quite often, Windows 10

iulo · 2017-03-13T02:16:27Z

any update?

jptissot · 2017-03-15T15:04:47Z

Same for me, I see this error everytime I save a file.

I'm using

Windows 10 Latest update
VSCode 1.10.2 integrated Powershell
node v7.7.2.
GitBook 3.2.2

teaho2015 · 2017-03-18T22:50:35Z

Same problem.

Windows version: 8.1
node version: v6.9.4
Gitbook version: 3.2.2

marekgregor · 2017-03-21T11:17:03Z

I suppose issue relates to weird inability to change read-only flag on folder in Windows
I haven't fixed the cause of this problem, but I have one very dumb workaround to the consequence - just create and run this .bat file in the console window - it will automatically call gitlab serve command after it will crash:

@Echo off
:Start
call gitbook serve
goto Start

mistory · 2017-04-25T17:03:15Z

same, windows 7
CLI version: 2.3.0
GitBook version: 3.0.2
node version: 4.4.4

ladieman217 · 2017-04-28T01:43:01Z

any solutions? this really bother me a lot. I have to go back to my Ubuntu again...

wz5891 · 2017-05-24T06:21:10Z

the old version 2.6.7 can live relaod on win10

gitbook fetch 2.6.7
gitbook -v 2.6.7
gitbook serve --gitbook=2.6.7

ska2342 · 2017-08-03T13:55:34Z

I'd like to add another mee too. This is keeping us from starting with Gitbook at all, because the majority of our authors is on Windows and the local server crashes on every single change.

creatop-john · 2017-08-07T06:27:44Z

Here's a solution

gitbook serve
delete _book folder once
now each time you change the md file, the server will stop and start over again and again

wangluzhou · 2017-08-18T03:37:45Z

@creatop-john Thanks, it solved my problem!

jptissot · 2017-08-25T13:23:13Z

For us, the issue turned out to be a blank .md file, after inserting dummy data in it, gitbook serve worked properly.

ouweiya · 2017-09-25T15:07:00Z

@creatop-john Thank you for running successfully, but the refresh is too slow to affect the writing experience.

GitbookIO#1379

tonnyone · 2017-12-20T15:02:43Z

@creatop-john Thank you for running successfully

SkyRockMoon · 2018-02-13T21:00:59Z

I am still seeing problems with this:

Windows 7 SP1 64-bit
Node v8.9.4
npm 5.6.0

Starting from scratch this is what I did:
npm install gitbook-cli -g
gitbook init ./gitbooktest
gitbook serve

When I saved a change to README.md it breaks. See below.


> C:\Code\docs\gitbooktest>gitbook serve
> Live reload server started on port: 35729
> Press CTRL+C to quit ...
> 
> info: 7 plugins are installed
> info: loading plugin "livereload"... OK
> info: loading plugin "highlight"... OK
> info: loading plugin "search"... OK
> info: loading plugin "lunr"... OK
> info: loading plugin "sharing"... OK
> info: loading plugin "fontsettings"... OK
> info: loading plugin "theme-default"... OK
> info: found 1 pages
> info: found 0 asset files
> info: >> generation finished with success in 0.6s !
> 
> Starting server ...
> Serving book on http://localhost:4000
> Restart after change in file README.md
> 
> Stopping server
> events.js:183
>       throw er; // Unhandled 'error' event
>       ^
> 
> Error: EPERM: operation not permitted, lstat 'C:\Code\docs\gitbooktest\_book'
> 
> C:\Code\docs\gitbooktest>node -v
> v8.9.4
> 
> C:\Code\docs\gitbooktest>npm -v
> 5.6.0

DexterHaslem · 2018-02-13T21:17:45Z

I'll dogpile in as well, just curious what the status of this is.
Are there plans to bump dependencies like some of the forks have? is it just waiting for someone to PR?

frantzyy · 2018-02-19T21:02:08Z

I had the same issue but noticed that my SUMMARY.md didn't include all the links to pages I was trying to access. Once I added them I was able update files and have the "gitbook serve" restart successfully. Might not be the same issue you all are seeing just wanted to point that out.

localdevm · 2018-04-19T13:51:56Z

Same here . While @creatop-john 's solution worked at first, when using chapters I am unable to delete the /book even though I have full admin privileges.

wslx520 · 2018-07-07T06:15:47Z

Two years past, the bug is still here, what have happened?!

unzoa · 2018-07-10T09:02:44Z

really

wikilike7 · 2018-07-26T07:19:32Z

Same error, Anyone have new solution?

mulder21c · 2018-08-08T09:46:14Z

I have same issue also.

I tried the steps below, and I could see that they would be reloaded without problems.

run gitbook serve

$ gitbook serve

on another terminal

$ rm ./_book -r -f

modify & save some files

then, reload & livereload work well.

Restart after change in file README.md

Stopping server
info: 7 plugins are installed
info: loading plugin "livereload"... OK
info: loading plugin "highlight"... OK
info: loading plugin "search"... OK
info: loading plugin "lunr"... OK
info: loading plugin "sharing"... OK
info: loading plugin "fontsettings"... OK
info: loading plugin "theme-default"... OK
info: found 1 pages
info: found 0 asset files
info: >> generation finished with success in 0.6s !

Starting server ...
Serving book on http://localhost:4000

localdevm · 2018-08-09T07:30:09Z

This is unfortunately only a temporary solution @mulder21c

tehcon · 2018-10-15T15:42:25Z

Win10 64bit
I run "gitbook serve" in an Administrator cmd and it works well

wslx520 · 2018-10-16T07:13:28Z

Maybe someone need: alternative solution for this, vuepress, new, easy to use, more powerful and well maintained

TomYeoman · 2018-12-02T10:33:43Z

I still have the same error, with none of the solutions working.. Is there an official solution to this it's blocking me from using gitbook :(

e/

Running gitbook serve and then deleting _book seems to sometimes work for me, other times it doesn't. ( node 10.10.0, npm 6.4.1

samperumal · 2018-12-16T19:01:27Z

Solution by @mulder21c works, but needs to be done every time the server is started.

yuh926323 · 2018-12-26T07:27:06Z

It works for me and well. @mulder21c

Windows 10 (64-bit)
NodeJS v8.12.0
CLI version: 2.3.2
GitBook version: 3.2.3

Vivianluolita · 2019-01-11T02:28:51Z

It's seems like that the only way is to add virtual data,hope others can deal it.

mulder21c · 2019-02-08T08:29:42Z

I modified the serve.js in gitbook to reduce the inconvenience of deleting the _book directory each time the server started, and I found that it works fine.

I hope this will help those who are having problems like me.

modify the c:\Users\{user name}\.gitbook\versions\3.2.3\lib\cli\serve.js file as follows.

var Server = require('./server');
var watch = require('./watch');

// load fs, path module
var fs = require('fs');
var path = require('path');

...

  .then(function() {
    if (!hasWatch) {
      return waitForCtrlC();
    }

    return watch(book.getRoot())
    .then(function(filepath) {
      // set livereload path
      lrPath = filepath;
      console.log('Restart after change in file', filepath);
      console.log('');

      // add this scripts
      fs.readdir(outputFolder, (err, files) => {
        for (const file of files) {
          fs.unlink(path.join(outputFolder, file), err => {});
        }
      });

      return generateBook(args, kwargs);
    });
  });

rougeyan · 2019-02-14T09:35:13Z

unkonwn reason in win10, but i find we need to keep the built file directory in a service state.

example:
here is a temporary way to solve this problem;
step:

install http-server npm install http-server -g ;
cd to directory _book and run commond http-server;
open a new shell/bash and cd to our file directory to run gitbook serve;

you will find the problem is solved;

thanks for @lguoliang @JaydenShum

win10/win8
node version: 8.12.0
CLI version: 2.3.2
GitBook version: 3.2.3

SamyPesse added bug platform-win32 investigating labels Jun 10, 2016

mlidbom mentioned this issue Oct 27, 2016

random errors when using gitbook plugin on running "gitbook serve". #1309

Closed

DanielRamosAcosta mentioned this issue Nov 14, 2016

gulp serve ULL-ESIT-SYTW-1617/presentaciones-todos#2

Closed

ghost mentioned this issue Dec 20, 2016

gitbook-cli crashes with EPERM: operation not permitted on windows GitbookIO/gitbook-cli#51

Open

LPGhatguy mentioned this issue Sep 11, 2017

gitbook serve livereload error GitbookIO/gitbook-cli#67

Open

tomyam1 added a commit to tepez/gitbook that referenced this issue Dec 20, 2017

update some dependencies to solve issue with running under windows

ea61239

GitbookIO#1379

addisonschultz closed this as completed Mar 25, 2024

git serve can't restart when file changes #1379

git serve can't restart when file changes #1379

Comments

SimonTart commented Jun 10, 2016 • edited Loading

thoemmi commented Jun 15, 2016 • edited Loading

ExByt3s commented Jul 30, 2016

eminoda commented Aug 10, 2016

marshhj commented Aug 20, 2016

CoDEmanX commented Sep 14, 2016 • edited Loading

leohxj commented Sep 18, 2016 • edited Loading

craigbutcher commented Sep 23, 2016

CliffHan commented Oct 20, 2016 • edited Loading

budiadiono commented Oct 24, 2016 • edited Loading

mlidbom commented Oct 27, 2016

mlidbom commented Oct 27, 2016

budiadiono commented Oct 30, 2016

CliffHan commented Oct 31, 2016 • edited Loading

budiadiono commented Oct 31, 2016

CliffHan commented Oct 31, 2016

CliffHan commented Nov 4, 2016 • edited Loading

cortexcompiler commented Nov 8, 2016 • edited Loading

ghost commented Dec 15, 2016

githoniel commented Feb 20, 2017

iulo commented Mar 13, 2017

jptissot commented Mar 15, 2017 • edited Loading

teaho2015 commented Mar 18, 2017

marekgregor commented Mar 21, 2017

mistory commented Apr 25, 2017 • edited Loading

ladieman217 commented Apr 28, 2017

wz5891 commented May 24, 2017 • edited Loading

ska2342 commented Aug 3, 2017

creatop-john commented Aug 7, 2017

wangluzhou commented Aug 18, 2017

jptissot commented Aug 25, 2017

ouweiya commented Sep 25, 2017

tonnyone commented Dec 20, 2017

SkyRockMoon commented Feb 13, 2018

DexterHaslem commented Feb 13, 2018

frantzyy commented Feb 19, 2018

localdevm commented Apr 19, 2018

wslx520 commented Jul 7, 2018

unzoa commented Jul 10, 2018

wikilike7 commented Jul 26, 2018

mulder21c commented Aug 8, 2018

localdevm commented Aug 9, 2018

tehcon commented Oct 15, 2018

wslx520 commented Oct 16, 2018

TomYeoman commented Dec 2, 2018 • edited Loading

samperumal commented Dec 16, 2018

yuh926323 commented Dec 26, 2018

Vivianluolita commented Jan 11, 2019

mulder21c commented Feb 8, 2019 • edited Loading

rougeyan commented Feb 14, 2019

thanks for @lguoliang @JaydenShum

SimonTart commented Jun 10, 2016 •

edited

Loading

thoemmi commented Jun 15, 2016 •

edited

Loading

CoDEmanX commented Sep 14, 2016 •

edited

Loading

leohxj commented Sep 18, 2016 •

edited

Loading

CliffHan commented Oct 20, 2016 •

edited

Loading

budiadiono commented Oct 24, 2016 •

edited

Loading

CliffHan commented Oct 31, 2016 •

edited

Loading

CliffHan commented Nov 4, 2016 •

edited

Loading

cortexcompiler commented Nov 8, 2016 •

edited

Loading

jptissot commented Mar 15, 2017 •

edited

Loading

mistory commented Apr 25, 2017 •

edited

Loading

wz5891 commented May 24, 2017 •

edited

Loading

TomYeoman commented Dec 2, 2018 •

edited

Loading

mulder21c commented Feb 8, 2019 •

edited

Loading