> For the complete documentation index, see [llms.txt](https://orbitai.gitbook.io/orbitai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://orbitai.gitbook.io/orbitai/local-host/setting-up-a-local-host-server-and-run-orbitai-agents-with-docker.md).

# Setting Up a Local Host Server and Run OrbitAI Agents with Docker

This guide will walk you through setting up a local host server on your Windows machine using Docker, so you can securely run and deploy OrbitAI Agents. Follow these steps carefully:

***

## **Step 1: Open Windows Terminal**

1. Press `Windows + S` to open the search bar.
2. Type **"Windows Terminal"** and press `Enter`.
3. You’ll see a terminal window open, ready for commands.

***

## **Step 2: Install Docker**

Docker is required to containerize and run the OrbitAI Agents securely on your local host.

1. **Download Docker Desktop**:
   * Go to the official [Docker website](https://www.docker.com/products/docker-desktop/) and download Docker Desktop for Windows.
2. **Install Docker**:
   * Run the downloaded installer and follow the on-screen instructions.
   * Ensure you select the option to enable **WSL 2 features** during installation (Windows Subsystem for Linux).
3. **Start Docker**:
   * After installation, open **Docker Desktop** from the Start menu.
   * Confirm Docker is running by checking its icon in the system tray.
4. **Verify Installation**:
   * In your Windows Terminal, type the following command and press `Enter`:

     ```
     docker --version
     ```
   * If Docker is installed correctly, it will display the current version.

***

## **Step 3: Access OrbitAI’s GitHub Repository (Coming Soon)**

Our GitHub repository will host the files and commands you need to deploy OrbitAI Agents. Once available:

1. Open a browser and navigate to our GitHub repository (link coming soon).
2. Locate the **Docker Setup Files** section in the repository.
3. Download or clone the repository to your local machine using this command in the terminal:

   ```
   git clone https://github.com/OrbitAI/OrbitAI-Agents.git
   ```

***

## **Step 4: Set Up Your Agent Using Docker**

1. **Navigate to the Folder**:
   * Use the `cd` command to navigate to the folder where you downloaded the repository. For example:

     ```
     cd C:\Users\YourUsername\OrbitAI-Agents
     ```
2. **Run the Docker Command**:
   * Copy the provided Docker commands from the GitHub repository and paste them into the terminal. For example:

     ```
     docker build -t orbitai-agent .
     docker run -d -p 8000:8000 orbitai-agent
     ```
3. **Access Your Agent**:
   * Open your web browser and go to `http://localhost:8000` to access the OrbitAI interface.

***

## **Step 5: Secure Your Local Deployment**

1. **Check Firewall Settings**:
   * Ensure your local firewall allows Docker to run but blocks unauthorized external access to the local host.
2. **Use Secure Credentials**:
   * Always set strong passwords for any agent or interface requiring authentication.

***

## **Step 6: Verify Agent Operation**

1. Check the logs in Docker to confirm your agent is running:

   ```
   docker logs <container_id>
   ```

   Replace `<container_id>` with the ID of your running container.
2. Test the functionality of your OrbitAI Agent through the local interface.