# Cannot build documentation **URL:** \ **Category:** AWX Project\ **Tags:** awx\ **Created:** [October 25, 2021, 8:22am UTC](https://forum.ansible.com/t/cannot-build-documentation/35915 "2021-10-25T08:22:35Z")\ **Posts on this page:** 10\ **Page:** 1
**Author:** ![Andrew\_C](https://avatars.discourse-cdn.com/v4/letter/a/858c86/32.png) [@Andrew\_C](https://forum.ansible.com/u/Andrew_C)\ **Post date:** [October 25, 2021, 8:22am UTC](https://forum.ansible.com/t/cannot-build-documentation/35915/1 "2021-10-25T08:22:35Z")
I am have cloned the latest version of the GIT repo. TOWER\_HOST=[http://awx-demo.test.com](http://awx-demo.test.com) TOWER\_USERNAME=admin TOWER\_PASSWORD=REznGWmHfcDFlm5awGtYf52OEVO1sYsw make clean html When I try to run make html to create the documentation I get the following error: Running Sphinx v4.1.1 Exception occurred: File “/usr/local/lib/python3.6/site-packages/awxkit/cli/sphinx.py”, line 4, in from sphinxcontrib.autoprogram import AutoprogramDirective File “/usr/local/lib/python3.6/site-packages/sphinxcontrib/autoprogram.py”, line 11 from **future** import annotations ^ SyntaxError: future feature annotations is not defined The full traceback has been saved in /tmp/sphinx-err-s32qna1i.log, if you want to report the issue to the developers. Please also report this if it was a user error, so that a better error message can be provided next time. A bug report can be filed in the tracker at [https://github.com/sphinx-doc/sphinx/issues](https://github.com/sphinx-doc/sphinx/issues). Thanks! make: \*\*\* [html] Error 2 Alternatively if there a publicly available AWX documentation site or somewhere that I can download it from? ---
**Author:** ![Vincent\_Rubiolo](https://avatars.discourse-cdn.com/v4/letter/v/a183cd/32.png) [@Vincent\_Rubiolo](https://forum.ansible.com/u/Vincent_Rubiolo)\ **Post date:** [October 25, 2021, 6:02pm UTC](https://forum.ansible.com/t/cannot-build-documentation/35915/2 "2021-10-25T18:02:06Z")
Hi Andrew, I am interesting in the answer on the documentation local build from the git repo too. In the meantime, since AWX forms the base of the Redhat Automation Controller Platform, these are the docs that I am using: [https://docs.ansible.com/automation.html](https://docs.ansible.com/automation.html) (User’s Guide, Admin Guide and API Guide) HTH, Vincent ---
**Author:** ![Vincent\_Rubiolo](https://avatars.discourse-cdn.com/v4/letter/v/a183cd/32.png) [@Vincent\_Rubiolo](https://forum.ansible.com/u/Vincent_Rubiolo)\ **Post date:** [November 16, 2021, 11:16am UTC](https://forum.ansible.com/t/cannot-build-documentation/35915/3 "2021-11-16T11:16:57Z")
Hi Andrew, Did you manage to build the documentation eventually? Thanks for the feedback, Vincent ---
**Author:** ![Andrew\_C](https://avatars.discourse-cdn.com/v4/letter/a/858c86/32.png) [@Andrew\_C](https://forum.ansible.com/u/Andrew_C)\ **Post date:** [November 17, 2021, 6:12am UTC](https://forum.ansible.com/t/cannot-build-documentation/35915/4 "2021-11-17T06:12:32Z")
Hi Vincent, I gave up and used the link in this thread. The documentation is about 90% correct, however it does not cover the differences in the open-source version so you have to work out a couple of things for yourself. Regards, Andrew ---
**Author:** ![Vincent\_Rubiolo](https://avatars.discourse-cdn.com/v4/letter/v/a183cd/32.png) [@Vincent\_Rubiolo](https://forum.ansible.com/u/Vincent_Rubiolo)\ **Post date:** [November 17, 2021, 9:08am UTC](https://forum.ansible.com/t/cannot-build-documentation/35915/5 "2021-11-17T09:08:00Z")
Hi Andrew, Thanks for the feedback, glad to see the link was useful! For what I gathered browsing the AWX source code, the internal doc from the repo at [https://github.com/ansible/awx/tree/devel/docs](https://github.com/ansible/awx/tree/devel/docs) describes the design internals in pretty good details but is different from the customer facing user manual I referenced above. Both complement one another, I don’t know though if there is a way to generate a documentation site from the abovementioned Markdown files … Vincent ---
**Author:** ![Vincent\_Rubiolo](https://avatars.discourse-cdn.com/v4/letter/v/a183cd/32.png) [@Vincent\_Rubiolo](https://forum.ansible.com/u/Vincent_Rubiolo)\ **Post date:** [November 26, 2021, 3:03pm UTC](https://forum.ansible.com/t/cannot-build-documentation/35915/6 "2021-11-26T15:03:32Z")
Hi again Andrew, I proceeded to install the AWX CLI today and it reminded me of this thread. I thus went ahead and tried to generate the documentation from my source tree. I reach my AWX instance via SSL but the certificate is self-signed and it does not seem there is a way to pass down the ‘–conf.insecure’ flag when sphinx is calling the awx commandline (it directly drives it via the Python entry point) so I had to modify my install $HOME/.local/lib/python3.9/site-packages/awxkit/cli/client.py at l102 to set it to insecure by default: 101 # vrubiolo: default is untrusted for docs generation 102 config.assume\_untrusted = True After that, generation via the normal instructions worked fine: $ cd awxkit/awxkit/cli/docs/build/html $ TOWER\_HOST=[https://awx.mine.onprem](https://awx.mine.onprem) TOWER\_USERNAME=admin TOWER\_PASSWORD=XXX make clean html $ cd build/html $ python -m http.server I could then browse the generated doc on my machine. Given the look of your error within the future Python statement, I would tend to think this is a Python environment-related error. In my case, I am using Fedora 34 and Python 3.9.7. The HEAD of my awx repo is at ba324c73ceefa22d516d872527649d090d3bc0cc and I am using awx CLI 19.4.0 from pip. HTH, Vincent ---
**Author:** ![Andrew\_C](https://avatars.discourse-cdn.com/v4/letter/a/858c86/32.png) [@Andrew\_C](https://forum.ansible.com/u/Andrew_C)\ **Post date:** [November 30, 2021, 1:16pm UTC](https://forum.ansible.com/t/cannot-build-documentation/35915/7 "2021-11-30T13:16:37Z")
Hi Vincent, I updated my AWX to 19.5.0 using [ansible/awx-operator: An Ansible AWX operator for Kubernetes built with Operator SDK and Ansible.](https://github.com/ansible/awx-operator) and the Help link takes you to the Ansible Controller version 4.0 so I don’t think I need to serve my own doc server anymore. [Automation Controller User Guide v4.0.0 — Automation Controller User Guide v4.0.0 (ansible.com)](https://docs.ansible.com/automation-controller/latest/html/userguide/index.html) Regards, Andrew ---
**Author:** ![Vincent\_Rubiolo](https://avatars.discourse-cdn.com/v4/letter/v/a183cd/32.png) [@Vincent\_Rubiolo](https://forum.ansible.com/u/Vincent_Rubiolo)\ **Post date:** [November 30, 2021, 1:37pm UTC](https://forum.ansible.com/t/cannot-build-documentation/35915/8 "2021-11-30T13:37:26Z")
Hi Andrew, Great to hear you can reach the Automation Controller doc from your instance now! Did the update to 19.5.0 go smoothly and you were able to keep your existing data? Vincent ---
**Author:** ![Andrew\_C](https://avatars.discourse-cdn.com/v4/letter/a/858c86/32.png) [@Andrew\_C](https://forum.ansible.com/u/Andrew_C)\ **Post date:** [November 30, 2021, 5:34pm UTC](https://forum.ansible.com/t/cannot-build-documentation/35915/9 "2021-11-30T17:34:24Z")
Hi Vincent, This is a crash and burn environment so I didn’t really have anything to migrate. ---
**Author:** ![Vincent\_Rubiolo](https://avatars.discourse-cdn.com/v4/letter/v/a183cd/32.png) [@Vincent\_Rubiolo](https://forum.ansible.com/u/Vincent_Rubiolo)\ **Post date:** [December 1, 2021, 8:35am UTC](https://forum.ansible.com/t/cannot-build-documentation/35915/10 "2021-12-01T08:35:30Z")
Understood. This indeed makes migrations easier 🙂 Vincent