How to fix HTTP 404 on Github Pages?

Question

Here is my GitHub repository on the gh-pages branch. Everything looks good, I have my index.html, my CSS, JS and pictures folders.

But when I access http://roine.github.com/p1 I get HTTP 404 not found.

Any explanation and solution?

I assume you followed the [documentation](http://pages.github.com/)? Have you got an email?- From the 404: "We'll send you an email when your page has been built. It may take up to ten minutes until your page is available." — David Cain, Jul 20 '12 at 10:22
I tried the generated page, and it was working fine. Then I have remove gh-pages branch and rebuild it with my custom html. I'm waiting since at least one hour now — Jonathan de M., Jul 20 '12 at 10:25
I contacted the github support, and they said it was a problem on their side, and they fixed it manually — Jonathan de M., Oct 15 '12 at 05:41
please try with `https`. if it's working then after few time it will for with `http` — Rohit Suthar, Oct 07 '15 at 13:00
the https trick worked for me in another way. I have everything right and the setting page said the site is published, gave me the right url. However it keep giving 404. I changed the url to http, it worked, then https worked too. Looks like the http site need to be accessed to "activate" it first. — dracodoc, Jan 19 '18 at 15:27
For me it started working after 10-20 mins. Its takes time. So be patient. — MechaCode, Sep 25 '18 at 09:09
https://stackoverflow.com/questions/53797321/react-github-pages-deploy-err-aborted-404-not-found/67376311#67376311 — KushalSeth, May 04 '21 at 16:42

Arnaud · Answer 1 · 2020-01-11T12:41:07.430

267

I had just one commit with all my files. I pushed an empty commit, refreshed the page and it worked.

git commit --allow-empty -m "Trigger rebuild"
git push

If this doesn't work, as @Hendrikto pointed out in the comments, check out the Github status page and make sure GitHub Pages are operational.

edited Jan 11 '20 at 12:41

answered Aug 27 '17 at 17:51

Arnaud

17,268
9
65
83

2

I was using the npm package angular-cli-ghpages and what I did was add a space to my index.html file, reran the command "npx ngh" which pushed a new commit for me acheiving the same glorious results. Thanks, this had me stumped and your answer inspired me to do this. – Patrick Graham Aug 15 '18 at 19:41
if you don't want to use the command line you can just edit your README.md direclty from the web interface. – Christophe Le Besnerais Feb 21 '19 at 14:51
2

It may also be a problem with Github itself. [This page](https://www.githubstatus.com/) tells you the status of Github. I had the same problem, and no fix worked. The status page said "degraded performance", and I just had to wait for the servers to be fully functional again. – Hendrikto Mar 12 '19 at 19:23
Good point @Hendrikto, I added a reference to your comment in the answer. – Arnaud Jan 11 '20 at 12:41
thank you surprisingly nobody has mentioned this anywhere and for some reason, this answer is not chosen as the right answer. I think it needs to be documented somewhere. Can you also provide a reference to the Github doc perhaps? @Arnaud – Novin Shahroudi Jan 11 '21 at 22:18
I did this, and now I no longer see a 404, but (perhaps even worse), now I see "ERR_TOO_MANY_REDIRECTS". Huh? – starmandeluxe Apr 20 '22 at 08:13
1

@starmandeluxe Probably a problem with your DNS setup. – Arnaud Apr 20 '22 at 08:52

eQ19 · Answer 2 · 2022-04-26T12:36:57.633

126

I did all the tricks on my repo to fix page 404 on Github Page (https://eq19.github.io/) but it kept 404'ing.

Finaly found that my browser hardly keep the 10 minutes cache before it up on the web.

Just add /index.html into the end of URL then it showed up and solved the case.

https://username.github.io/{repoName}/index.html

edited Apr 26 '22 at 12:36

answered Apr 26 '18 at 03:31

eQ19

9,880
3
65
77

3

This worked for me. I created the site following the instructions in the [main GitHub Pages page](https://pages.github.com/) so its kinda disappointing that it doesn't work out of the box. – CGK Nov 02 '18 at 04:53
2

Thanks! I had the same problem. It's bizarre that we have to add /index.html. – Raja Rao Nov 12 '18 at 23:59
1

I did a soft cache clear but it didnt work but adding /index.html worked. Thanks – Prince Tegaton Sep 07 '19 at 22:01
2

Worked for me as well but this has never happened to me before, I currently have multiple pages running on both https://username.github.io and https://username.github.io/ and have never needed to append an index.html – Sanchit Batra May 10 '20 at 17:26
1

i had to open the dev console and force index.html in the url. Thanks o/ – heavyrick Jul 16 '20 at 18:30
1

hmmm 404 says a resource is missing, i find it hard to believe that chrome caches the 404 error code. Maybe the html, but not the 404 – Nearoo Apr 23 '22 at 17:14
1

it was useful for me – Alejandro Gonzalez May 17 '22 at 23:00
1

This worked for me https://username.github.io/home.html – Dulangi_Kanchana Dec 23 '22 at 03:12

Ky - · Answer 3 · 2020-12-31T21:48:31.510

120

In my case, I had folders whose names started with _ (like _css and _js), which GH Pages ignores as per Jekyll processing rules. If you don't use Jekyll, the workaround is to place a file named .nojekyll in the root directory. Otherwise, you can remove the underscores from these folders

edited Dec 31 '20 at 21:48

answered Sep 25 '16 at 20:23

Ky -

30,724
51
192
308

13

.nojekyll is a must if you're not using Jekyll, docs here: https://github.com/blog/572-bypassing-jekyll-on-github-pages – Claudiu Constantin Sep 28 '17 at 13:03
4

Thank you for this, I have emailed github and asked them to update their guide at [pages.github.com](https://pages.github.com/) (which doesn't mention the .nojekyll file) – sunyata Oct 11 '17 at 16:58
1

Thanks! It was required for Vue app, too bad it is not mentioned in vue-cli deploy guide. – Ondřej Ševčík Jun 28 '19 at 05:20
1

this fixed it for me. My user site was originally working without it but stopped working. You can just add a file online and commit it there too. I did this, refreshed and it instantly worked. – bot19 May 24 '20 at 02:23
@OndřejŠevčík Is vue-cli specifically about GitHub page deployment? If no, then it is not really their role to warn about footguns on all possible hostings – reducing activity Nov 15 '21 at 13:34
1

@bot19 yeah, it was part of vue-cli deploy that talked about deploying to GitHub Pages – Ondřej Ševčík Nov 16 '21 at 14:49
1

Was using Astro which now uses a `_astro` sub-directory to serve bundles. Thanks OP! – VRG May 06 '23 at 14:08

Jonathan de M. · Accepted Answer · 2012-12-18T15:53:18.740

62

Four months ago I have contacted the support and they told me it was a problem on their side, they have temporarily fix it (for the current commit).

Today I tried again

I deleted the gh-pages branch on github

git push origin --delete gh-pages
I deleted the gh-pages branch on local

git branch -D gh-pages
I reinitialized git

git init
I recreated the branch on local

git branch gh-pages
I pushed the gh-pages branch to github

git push origin gh-pages

Works fine, I can finally update my files on the page.

edited Dec 18 '12 at 15:53

answered Dec 11 '12 at 02:27

Jonathan de M.

9,721
8
47
72

42

Apparently, you don't even need to delete your local branch. Just `git checkout gh-pages ; git push origin --delete gh-pages ; git push origin` and you're done. – interestinglythere Mar 12 '14 at 10:00
4

Deleting remote branch and pushing mine again solved the problem. Page was visible after a minute. – Kulbi Dec 16 '14 at 13:21
I think it's suppose to be an "orphan" branch – wayofthefuture Jun 28 '16 at 20:33
Just had to delete the origin branch ("gh-pages") and re-did everything. Worked for me! – wle8300.com Jun 25 '17 at 19:59

ChrisGPT was on strike · Answer 5 · 2019-05-01T11:55:00.560

46

If you haven't already, choose a Jekyll theme in your GitHub Pages settings tab. Apparently this is required even if you're not using Jekyll for your Pages site.

edited May 01 '19 at 11:55

answered Mar 23 '19 at 15:25

ChrisGPT was on strike

127,765
105
273
257

13

I was getting 404 Not Found and having tried all eighteen of the other solutions suggested in answers here I documented my attempts in a duplicate question: [Very simple HTML resulting in 404 Not Found on GitHub Pages](https://stackoverflow.com/q/55314621/575530). Chris's 19th answer was the one that fixed it for me. GitHub Pages is a great service, it is a shame the documentation is so poor. – dumbledad Mar 24 '19 at 10:13
4

Just choosing a scheme still is not enough, you also need to create a new commit on the `gh-pages` branch to trigger an update afterwards! – sschuberth Sep 30 '19 at 11:26

score 23 · Answer 6 · answered Jan 30 '17 at 07:32

23

I had the same issue after forking a repo with a gh-pages branch. I was able to fix by simply pushing a new commit (just whitespace in index.html) to my fork's gh-pages branch.

answered Jan 30 '17 at 07:32

Clay

10,885
5
47
44

I put a whitespace in "index.html", committed and pushed changes. Nothing happened. Removed whitespace from the filename, committed and pushed changes again and it worked! Thanks. – Nahiyan May 15 '17 at 17:31
also note that github pages use a small caching window (10 minutes at the time of writing: `Cache-Control:max-age=600`). so you may also have to wait on that cache window to expire or force refresh your browser. – Clay Jun 27 '17 at 18:29
5

Why mess with the whitespace? Just push an empty commit with `--allow-empty`. – Hendrikto Feb 05 '18 at 13:01

Timeless · Answer 7 · 2019-04-18T03:18:26.673

20

In my case on 8/Aug/2017

if your user page is https://github.com/mgravell, you repo name must be mgravell.github.io
under root, create a file index.html
under root, create a folder docs, create a file CNAME under docs (note: NO extension like .txt, make sure your file system shows extension)
gh-pages branch is optional, master branch is sufficient

more: check official docs here: https://help.github.com/articles/configuring-a-publishing-source-for-github-pages/

edited Apr 18 '19 at 03:18

answered Aug 08 '17 at 06:40

Timeless

7,338
9
60
94

Should the CNAME file be empty? If not what should be in it? – dumbledad Mar 23 '19 at 13:02
@dumbledad empty file will be fine – Timeless Mar 23 '19 at 13:02

score 20 · Answer 8 · answered May 09 '19 at 10:28

20

Just wait about ten minutes to one hour. If it still doesn't work, contact github. Usually it's the problem at their end. But, if you're in a hurry, you can try to open by adding "?" question mark at the end of URL. It force query to search for the resource. Like this:

http://roine.github.com/p1?

answered May 09 '19 at 10:28

Rivalus

1,052
9
10

The question mark trick works for webpages, but doesn't seem to work for directories that autoredirect to index.html – Jason S Feb 23 '23 at 19:09

score 18 · Answer 9 · edited Oct 02 '21 at 21:34

18

In my case the browser had a previous cached version of my app. To avoid getting the cached version, access you url using a random query string:

https://{{your-username}}.github.io/{{your-repository}}?randomquery

edited Oct 02 '21 at 21:34

Koray Tugay

22,894
45
188
319

answered Jan 13 '21 at 10:46

Rashomon

5,962
4
29
67

Big uff. That was a lifesaver – k0pernikus May 01 '21 at 12:41
This works. But it could be the github server which cached the site. – Timathon May 18 '21 at 06:44

score 13 · Answer 10 · answered Nov 01 '12 at 00:42

13

My pages also kept 404'ing. Contacted support, and they pointed out that the url is case sensitive; solved my issue.

answered Nov 01 '12 at 00:42

JefClaes

3,275
21
23

3

I already tried both, with and without capital, before contacting the support – Jonathan de M. Nov 01 '12 at 09:31

score 6 · Answer 11 · answered Sep 09 '17 at 19:03

6

in my case i had to go to project settings and enable the github pages. The default is off

answered Sep 09 '17 at 19:03

João Nunes

3,751
31
32

This one and choosing a Jekyll theme (even though I don't want to use Jekyll) is what fixed mine. Also, I had originally had my repo set to private. I guess that doesn't work with Github Pages. – Azurespot Jan 07 '21 at 22:14
1

This did the trick, although it messed my github page url real good. It's incredible they don't mention a single time this need of turning github pages ON in their tutorial page https://pages.github.com. – darksoulsong Dec 31 '21 at 19:12

score 5 · Answer 12 · answered Jan 19 '18 at 15:47

If you saw 404 even everything looks right, try switching https/http.

The original question has the url wrong, usually you can check repo settings and found the correct url for generated site.

However I have everything set up correctly, and the setting page said it's published, then I still saw 404.

Thanks for the comment of @Rohit Suthar (though that comment was to use https), I changed the url to http and it worked, then https worked too.

score 4 · Answer 13 · answered May 11 '19 at 17:48

4

Add the following in the beginning of the index.html file

<!DOCTYPE html>

answered May 11 '19 at 17:48

Anirban Mukherjee

390
2
3

score 4 · Answer 14 · answered May 21 '20 at 10:04

4

In my case in react was necessary to select the gh-pages branch:

answered May 21 '20 at 10:04

Jöcker

5,281
2
38
44

score 4 · Answer 15 · answered Oct 16 '20 at 11:34

I was facing the same issue, after trying most of the methods mentioned above I couldn't get the solution. In my case the issue of because of Github changing the name of master to main branch.

Go to Setting -> go to GitHub Pages section and change the branch to main:

to

Save it and select a theme, and the website is live.

score 3 · Answer 16 · answered Oct 17 '17 at 12:54

3

If you are sure that your structure is correct, just push an empty commit or update the index.html file with some space, it works!

answered Oct 17 '17 at 12:54

Ahad Dastbelaraki

119
9

Joe Gasewicz · Answer 17 · 2020-04-25T11:01:45.400

I had this exact problem with typedocs. The README.md worked but none of the actual docs generated by my doc strings displayed, I just got a 404 Github Pages screen.

To fix this, just place a empty file in your /docs directory (or wherever you generate your docs) & call it .nojekyll

To confirm, your file structure should now look like:

./docs/.nojekyll  # plus all your generated docs

Push this up to your remote Github repo and your links etc should work now.

Also make sure you have selected in your Github settings:

Settings -> Github Pages -> Source -> master brach /docs folder

Depending on your doc framework, you probably have to recreate this file each time you update your docs, this is an example of using typedocs & creating the .nojekyll file each time in a package.json file:

# package.json

      "scripts": {
        "typedoc": "typedoc --out docs src && touch docs/.nojekyll"
      },

score 3 · Answer 18 · answered Feb 10 '21 at 10:46

The solution for me was to set right the homepage in package.json.

My project name is monsters-rolodex and I am publishing from console gh-pages -d build.

"homepage": "https://github.com/monsters-rolodex",

The project was built assuming it is hosted at /monsters-rolodex/.

Before it didn't work because in the homepage url I included my github username.

score 2 · Answer 19 · answered Sep 25 '17 at 15:59

I got the site to work by deleting the "username.github.io" folder on my computer going through the steps again, including changing the index/html file.

My mistake (I think) is that i initially cloned "https://github.com/username/username.github.io.git" instead of https://github.com/username/username.github.io (no ".git")

score 2 · Answer 20 · answered Jul 20 '18 at 07:11

In my case, all the suggestions above were correct. I had most pages working except few that were returning 404 even though the markdown files are there and they seemed correct. Here is what fixed it for me on these pages:

On one page, there were a few special characters that are not part of UTF-8 and I think that's why GitHub pages was not able to render them. Updating/removing these char and pushing a new commit fixed it.
On another page, I found that there were apostrophes ' surrounding the title, I removed them and the page content started showing fine

score 2 · Answer 21 · edited Jan 05 '20 at 10:59

Another variant of this error:

I set up my first Github page after a tutorial but gave the file readme.md a - from my perspective - more meaningful name: welcome.md.

That was a fatal mistake:

We’ll use your README file as the site’s index if you don’t have an index.md (or index.html), not dissimilar from when you browse to a repository on GitHub.

from Publishing with GitHub Pages, now as easy as 1, 2, 3

I was then able to access my website page using the published at link specified under Repository / Settings / GitHub Pages followed by welcome.html or shorter welcome.

030 · Answer 22 · 2020-05-05T03:08:45.123

2

For some reason, the deployment of the GitHub pages stopped working today (2020-may-05). Previously I did not have any html, only md files. I tried to create an index.html and it published the page immediately. After removal of index.html, the publication keeps working.

edited May 05 '20 at 03:08

answered May 05 '20 at 02:20

030

10,842
12
78
123

score 2 · Answer 23 · answered Oct 13 '20 at 14:30

I was following this YT video. So, when I ran the command in my terminal, it pushed the code to gh-pages branch already. Then I pushed to the master branch. It was giving me 404 error.

Then I swapped the branch to master and then again reverted to gh-pages and now the error is gone. It's pointing to the index.html even if it's not in the URL.

Erik Živković · Answer 24 · 2023-04-03T12:16:17.790

In my case it was that I had recently set up a custom domain for GitHub pages, but GitHub had forgotten my custom domain under (repo)<name>.github.io / Settings / Pages.

I added the custom domain again and then it immediately started working.

EDIT: I forgot to update this at the time, but now that I got an upvote I am adding more info.

The real reason that the domain was forgotten is that GitHub adds a commit on top of your repo with a special file called CNAME that contains the information. If you remove that file by mistake (rebase or force-push) then the domain mapping is also removed.

strongwillow · Answer 25 · 2013-07-21T13:33:21.193

1

I bound my domain before this problem appeared. I committed and pushed the branch gh-pages and it solved my problem. New commits force jekyll to rebuild your pages.

edited Jul 21 '13 at 13:33

answered Jul 21 '13 at 13:25

strongwillow

328
2
13

score 1 · Answer 26 · answered Aug 19 '17 at 20:41

1

In my case, the URL was quite long. So, I guess there is a limit. I put it to my custom subdomain and it worked.

answered Aug 19 '17 at 20:41

Ahmad Awais

33,440
5
74
56

score 1 · Answer 27 · answered Jun 12 '18 at 23:00

1

On a private repo, when I first added and pushed my gh-pages branch to github, the settings for github pages automatically changed to indicate that the gh-pages branch would be published, but there no green or blue bar with the github.io url and no custom domain options.

It wasn't until I switched the source to master and quickly switched the source back to gh-pages that it actually updated with the green bar that contains the published url.

answered Jun 12 '18 at 23:00

chrismarx

11,488
9
84
97

1

This helps. My project was **private at first** and in that state I pushed project to Github pages and I get 404 (ofc). After switching from `gh-pages` to `master`, and then back from `master` to `gh-pages` everything was fine and application start to work. – zrna Jun 08 '20 at 10:43

score 1 · Answer 28 · answered May 20 '22 at 08:57

1

Your GitHub Pages is available at http://roine.github.io/p1 instead of http://roine.github.com/p1.

By the way, you can fix your project's description.

answered May 20 '22 at 08:57

TimTIM Wong

788
5
16

score 0 · Answer 29 · answered Jul 01 '18 at 13:31

0

Go to settings section of your repository and choose master branch at the Source section and click save button after that refresh the page and you will be able to see the link of your page!.

answered Jul 01 '18 at 13:31

twenk11k

557
5
17

score 0 · Answer 30 · answered Nov 29 '18 at 07:22

I faced this problem (404) too and the root cause was my file was named INDEX.md. I was developing on Windows and my local Jekyll site worked (since Windows treats file names case insensitive by default). When pushed to Github, it didn't work. Once I renamed the INDEX.md to index.md, things worked well.

score 0 · Answer 31 · answered Nov 30 '18 at 02:32

Yet another scenario:

using an Organization Page (not a Project page) that has a repository named <orgname>.github.io
source documents as markup in master branch (asciidoc)
Travis CI pulling source doc files from master and pushing generated html files to gh-pages branch

The gh-pages branch is updated with the generated html pages. The GitHub Environment tab provides the link to the organization page. Clicking it results in a 404.

According to https://help.github.com/articles/configuring-a-publishing-source-for-github-pages/

User and Organization Pages that have this type of repository name are only published from the master branch

If I understand this correctly, GitHub Pages will not be published from the gh-pages branch if you are creating a User or Organization site rather than a Project site.

I renamed my repo to make it a Project site rather than Organization site and then the gh-pages branch was published as expected.

score 0 · Answer 32 · answered Jun 11 '19 at 20:45

0

I had same issue.. Very strange issue.. My HTML was with space after title

> <title>
> 
> <script>

Fixed, after removing space

> <title>
> <script>

answered Jun 11 '19 at 20:45

Pastuh

376
2
12

This is probably just equivalent to causing a site rebuild as in https://stackoverflow.com/a/45907768/124703 – Kenyon Jan 10 '21 at 23:20

score 0 · Answer 33 · answered Aug 20 '19 at 15:41

Also, GitHub pages doesn't currently support Git LFS. As such, if you have images (or other binary assets) in GitHub pages committed with Git LFS, you'll get 404 not found for those files.

This will be quite common for documentation generated with Doxygen or similar tool.

The solution in this case is to simply not commit those files with Git LFS.

score 0 · Answer 34 · answered Sep 17 '19 at 19:07

0

In my case my repository was private. Make repository public and go through all steps again.

answered Sep 17 '19 at 19:07

Santosh Kadam

1,265
14
14

score 0 · Answer 35 · answered Nov 29 '19 at 00:21

0

I also faced this issue, my pages getting 404. And then I added README.md on my repository, and the 404 was gone.

answered Nov 29 '19 at 00:21

Tri

2,722
5
36
65

score 0 · Answer 36 · answered Sep 15 '20 at 02:42

I faced the same issue(404 on a newly set up GitHub pages website) yesterday. I tried many methods such as switching a new theme etc. But it seems that it still did not work on my case. I finally figured it out by switching the branch of GitHub pages website to another branch, click save. Wait for a while and switch it back again. Then the problem was suddenly solved.

score 0 · Answer 37 · answered Nov 03 '20 at 05:04

0

I had to rename my repo to a random name then rename it back to it's original name for it to work.

Seems like it might be a GH Pages bug.

answered Nov 03 '20 at 05:04

Gustavo Maximo

4,426
3
17
26

score 0 · Answer 38 · answered Dec 06 '21 at 08:35

0

I used umijs to package and deploy the project to github pages. The following operations helped me:

1. In 13 line, add base: my-project-name;
1. Redeploy gh-pages

A little guess: github pages need to be deployed to a non-root directory

answered Dec 06 '21 at 08:35

xq nie

41
5

score 0 · Answer 39 · answered Dec 06 '21 at 10:26

0

The following operations helped me:

webpack build:

Webpack output.publicPath

publicPath: './'

vite build:

vite base

base: './'

answered Dec 06 '21 at 10:26

xq nie

41
5

score 0 · Answer 40 · answered Mar 21 '22 at 16:30

For me the key was recognising that you could see error messages from the build process by going to the 'Actions' tab in your github repo. Clicking on the latest 'pages build and deployment' workflow revealed the error message that was preventing publication (simple bug in my _config.yml).

score 0 · Answer 41 · answered Aug 08 '22 at 23:25

If you're using a framework like Angular, it could be that you have to set the base href path: https://stackoverflow.com/a/54409380/1585161

Using Angular CLI: ng build --baseHref="/users/"

Or more generally: <base href="/users/">

Also be sure that your image assets start with ./assets not /assets

score 0 · Answer 42 · answered Sep 06 '22 at 01:47

Today bumped into the same issue. In my case I was adding script as module, which resulted in HTTP 404 trying to fetch the file when deployed with Github Pages. I had to switch my bundler to make it work.

in the index.html file

DID NOT WORK:
<script type="module" src="./index.4b5c177027.js"></script>

WORKS:
<script src="./index.4b5c177027.js"></script>

Best,

score 0 · Answer 43 · answered Jun 04 '23 at 03:55

In my case, I had first created a site without jekyll and had a .nojekyll file. I then changed my mind and created a site with jekyll (ignoring the non-empty repository warning and using --force). Then I had just forgotten to delete the .nojekyll file. Deleting it fixed the issue.

score 0 · Answer 44 · answered Jun 14 '23 at 21:10

0

if you are reviving an old website, go to actions -> pages-build-deployment -> pages build and deployment -> Re-run all jobs

answered Jun 14 '23 at 21:10

Varun Garg

2,464
23
37

score 0 · Answer 45 · answered Aug 01 '23 at 01:57

For Angular 16 I did:

npm i angular-cli-ghpages --save-dev

Then ran these 2 commands:

ng build --base-href "https://danday74.github.io/pods-prototype/"
npx angular-cli-ghpages --dir=dist/pods

Where:

danday74 is YOUR_USERNAME

pods-prototype is YOUR_GITHUB_REPO_NAME

dist/pods is YOUR_LOCAL_FOLDER where the build files are located

Then I could access my site (after a 10 sec delay) at:

https://danday74.github.io/pods-prototype

How to fix HTTP 404 on Github Pages?

45 Answers45

Linked

Related