# How to install Ansible AWX on a local host

**URL:** <https://forum.ansible.com/t/how-to-install-ansible-awx-on-a-local-host/4514>\
**Category:** Get Help\
**Tags:** awx\
**Created:** [March 22, 2024, 1:38pm UTC](https://forum.ansible.com/t/how-to-install-ansible-awx-on-a-local-host/4514 "2024-03-22T13:38:22Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![Nikolay](https://avatars.discourse-cdn.com/v4/letter/n/a698b9/32.png) [@Nikolay](https://forum.ansible.com/u/Nikolay)\
**Post date:** [March 22, 2024, 1:38pm UTC](https://forum.ansible.com/t/how-to-install-ansible-awx-on-a-local-host/4514/1 "2024-03-22T13:38:22Z")

</div>

Good afternoon, friends!  
I’m starting to work with ansible, I ask for your help, sorry for the naive question. How do I install Ansible AWX on a localhost without internet access on Debian?  
Thanks!

---

<div class="post-metadata">

**Author:** ![Denney-tech](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/denney-tech/32/1556_2.png) [@Denney-tech](https://forum.ansible.com/u/Denney-tech)\
**Post date:** [March 22, 2024, 7:32pm UTC](https://forum.ansible.com/t/how-to-install-ansible-awx-on-a-local-host/4514/2 "2024-03-22T19:32:39Z")

</div>

Well, first, you need to make all of the images available on some local docker registry.

Second, AWX is designed to be run in a kubernetes cluster, not on a single localhost. You’re best bet is to follow @kurokobo’s tutorial on deploying it to a single-node k3s cluster. You’ll have to account for pulling the images you need from a local registry you setup (Nexus OSS or ProjectQuay might be suitable, or even TheForeman could work).

[https://github.com/kurokobo/awx-on-k3s](https://github.com/kurokobo/awx-on-k3s)

---

<div class="post-metadata">

**Author:** ![kurokobo](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/kurokobo/32/182_2.png) [@kurokobo](https://forum.ansible.com/u/kurokobo)\
**Post date:** [March 23, 2024, 1:51am UTC](https://forum.ansible.com/t/how-to-install-ansible-awx-on-a-local-host/4514/3 "2024-03-23T01:51:18Z")

</div>

The method about air-gapped installation is the one of the FAQ for me.  
It may be the time to consider adding air-gapped installation guide 😂

---

<div class="post-metadata">

**Author:** ![smoohiii](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/smoohiii/32/4004_2.png) [@smoohiii](https://forum.ansible.com/u/smoohiii)\
**Post date:** [July 1, 2024, 3:34pm UTC](https://forum.ansible.com/t/how-to-install-ansible-awx-on-a-local-host/4514/5 "2024-07-01T15:34:59Z")

</div>

Any progress on this? I’m running into the same issue

---

<div class="post-metadata">

**Author:** ![kurokobo](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/kurokobo/32/182_2.png) [@kurokobo](https://forum.ansible.com/u/kurokobo)\
**Post date:** [July 10, 2024, 3:28pm UTC](https://forum.ansible.com/t/how-to-install-ansible-awx-on-a-local-host/4514/6 "2024-07-10T15:28:03Z")

</div>

Completely no progress ☹

---

<div class="post-metadata">

**Author:** ![djyasin](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/djyasin/32/114_2.png) [@djyasin](https://forum.ansible.com/u/djyasin)\
**Post date:** [July 10, 2024, 6:49pm UTC](https://forum.ansible.com/t/how-to-install-ansible-awx-on-a-local-host/4514/7 "2024-07-10T18:49:03Z")

</div>

Hi @Nikolay,  
While we don’t have specific instructions for how to accomplish this, there is some chatter on another thread about this topic that you may find helpful:

> [@Seeking Guidance for Offline AWX Installation and Execution Environment Setup](http://forum.ansible.com/t/seeking-guidance-for-offline-awx-installation-and-execution-environment-setup/3995/11):
>
> Note, that method is for only recommended for development or testing, not for production use. AWX can also alternatively be installed and [run in Docker](https://github.com/ansible/awx/blob/devel/tools/docker-compose/README.md), but this install path is only recommended for development/test-oriented deployments, and has no official published release. [awx/INSTALL.md at devel · ansible/awx · GitHub](https://github.com/ansible/awx/blob/devel/INSTALL.md) How did you configure your Execution Environment and Job Templates to achieve “being configured to use the local Docker registry”?

You may also refer to the following documentation as well:

**Postgres image:** [Database configuration - Ansible AWX Operator Documentation](https://ansible.readthedocs.io/projects/awx-operator/en/latest/user-guide/database-configuration.html?h=image#note-about-overriding-the-postgres-image)

**Note about overriding images needed for awx deployment -** [Deploying a specific version of awx - Ansible AWX Operator Documentation](https://ansible.readthedocs.io/projects/awx-operator/en/latest/user-guide/advanced-configuration/deploying-a-specific-version-of-awx.html?h=image#deploying-a-specific-version-of-awx)

For backup and restore objects, this needs to be specified on the spec as well  
postgres\_image:  
postgres\_image\_version:  
pointing to your mirrored image repository image for postgresql
