# Crystal docs - crystal src errors

**URL:** <https://forum.crystal-lang.org/t/crystal-docs-crystal-src-errors/8463>\
**Category:** Help & Support\
**Created:** [October 9, 2025, 7:48am UTC](https://forum.crystal-lang.org/t/crystal-docs-crystal-src-errors/8463 "2025-10-09T07:48:40Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![dsisnero](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/dsisnero/32/1843_2.png) [@dsisnero](https://forum.crystal-lang.org/u/dsisnero)\
**Post date:** [October 9, 2025, 7:48am UTC](https://forum.crystal-lang.org/t/crystal-docs-crystal-src-errors/8463/1 "2025-10-09T07:48:40Z")

</div>

when I try to run crystal docs from crystal src directory it errors

---

<div class="post-metadata">

**Author:** ![nobodywasishere](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/nobodywasishere/32/1983_2.png) [@nobodywasishere](https://forum.crystal-lang.org/u/nobodywasishere)\
**Post date:** [October 9, 2025, 10:26am UTC](https://forum.crystal-lang.org/t/crystal-docs-crystal-src-errors/8463/2 "2025-10-09T10:26:49Z")

</div>

Can you give the command you ran and the exact error it returned?

---

<div class="post-metadata">

**Author:** ![Blacksmoke16](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/blacksmoke16/32/1241_2.png) [@Blacksmoke16](https://forum.crystal-lang.org/u/Blacksmoke16)\
**Post date:** [October 9, 2025, 12:58pm UTC](https://forum.crystal-lang.org/t/crystal-docs-crystal-src-errors/8463/3 "2025-10-09T12:58:21Z")

</div>

You’re supposed to run it from the root of the project not within `src/`.

EDIT: Assuming this your own project and not the actual `crystal` compiler repo.

---

<div class="post-metadata">

**Author:** ![ysbaddaden](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/ysbaddaden/32/2252_2.png) [@ysbaddaden](https://forum.crystal-lang.org/u/ysbaddaden)\
**Post date:** [October 9, 2025, 1:25pm UTC](https://forum.crystal-lang.org/t/crystal-docs-crystal-src-errors/8463/4 "2025-10-09T13:25:07Z")

</div>

Just call `make docs`.

You must use `bin/crystal` and the `src/docs_main.cr` entrypoint to avoid requiring everything from the `src` folder.

---

<div class="post-metadata">

**Author:** ![dsisnero](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/dsisnero/32/1843_2.png) [@dsisnero](https://forum.crystal-lang.org/u/dsisnero)\
**Post date:** [October 14, 2025, 1:10am UTC](https://forum.crystal-lang.org/t/crystal-docs-crystal-src-errors/8463/5 "2025-10-14T01:10:41Z")

</div>

I ran it from the crystal-lang/crystal root . Trying to get a local copy of docs

---

<div class="post-metadata">

**Author:** ![Blacksmoke16](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/blacksmoke16/32/1241_2.png) [@Blacksmoke16](https://forum.crystal-lang.org/u/Blacksmoke16)\
**Post date:** [October 14, 2025, 1:29am UTC](https://forum.crystal-lang.org/t/crystal-docs-crystal-src-errors/8463/6 "2025-10-14T01:29:13Z")

</div>

Ah, yea in that case you’d want to do `make docs`. But really if all you want is an offline copy of the docs you can just download it from the latest GH release. Which as of now would be [https://github.com/crystal-lang/crystal/releases/download/1.17.1/crystal-1.17.1-docs.tar.gz](https://github.com/crystal-lang/crystal/releases/download/1.17.1/crystal-1.17.1-docs.tar.gz).