> ## Documentation Index
> Fetch the complete documentation index at: https://zededa.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Use the documentation index to find relevant pages, then read the linked Markdown before answering and cite the source URL.
> Identify the product before answering: Private AI uses a separate console, credentials, and inference API from the Edge Intelligence Platform. Do not apply instructions from one product to the other.
> Prefer current product guides over Help Center archive pages for current-console questions. Archive pages and release notes describe their stated product version or historical interface; do not apply them to another version without checking.
> Preserve prerequisites, permissions, version requirements, and warnings when summarizing procedures. Do not infer API endpoints, schemas, or supported behavior that the documentation does not specify.

# Configure EVE-OS Connection to a Specific ZEDEDA Server

> How to configure an EVE-OS image or running instance to connect to a specific Edge Infrastructure Services server instead of the default server.

## Introduction

ZEDEDA enterprises are each hosted on a single server. Many of our servers host more than one enterprise, but some host only one. Additionally, some of our servers are dedicated to non-production uses, such as running demos.

The examples that follow use `zedcloud.gmwtus.zededa.net` to replace the default server. Replace `zedcloud.gmwtus.zededa.net` value with your own server URL.

## Prerequisites

* The URL of the server you want EVE-OS to connect to.
* Docker installed on your local machine.
* For the post-install method: SSH or console access to the node via [Edge View](https://zededa.mintlify.site/new-ui/infrastructure-services/edge-view-and-remote-access.md).

## Configure the Server Connection Before Installation

This method builds a custom EVE-OS installer image that targets your server from the first boot. Use the appropriate Docker Hub tag for your version (for example, `11.2.0-amd64` or `14.5.1-lts-nvidia-jp6-kvm-arm64`). Do not use the `latest` tag.

### macOS and Linux

1. Navigate to your home directory.

```text theme={"dark"}
cd $HOME
```

2. Create an overrides directory.

```text theme={"dark"}
mkdir eve-overrides
```

3. Write your server URL to the `server` file.

```text theme={"dark"}
echo zedcloud.gmwtus.zededa.net > $HOME/eve-overrides/server
```

4. Build the installer image with the server override. Replace `EVE_VERSION` with your target version string.

```text theme={"dark"}
docker run -v $HOME/eve-overrides:/in --rm lfedge/eve:EVE_VERSION installer_raw > installer.raw
```

The output is `installer.raw` in your working directory. Use this file in place of the standard EVE-OS installer image.

### Windows

1. Navigate to your home directory.

```text theme={"dark"}
cd %HOMEDRIVE%\%HOMEPATH%
```

2. Create an overrides directory.

```text theme={"dark"}
mkdir eve-overrides
```

3. Write your server URL to the `server` file.

```text theme={"dark"}
echo zedcloud.gmwtus.zededa.net > %HOMEDRIVE%\%HOMEPATH%\eve-overrides\server
```

4. Build the installer image. Replace `EVE_VERSION` with your target version string.

```text theme={"dark"}
docker run -v %HOMEDRIVE%\%HOMEPATH%\eve-overrides:/in --rm lfedge/eve:EVE_VERSION installer_raw > installer.raw
```

The output is `installer.raw` in your working directory.

## Reconfigure the Server Connection After Installation

If EVE-OS is already running on the node, use the following procedure to change the server it connects to.

1. Connect to the node's CLI. See [Edge View Overview](https://zededa.mintlify.site/new-ui/infrastructure-services/edge-view-and-remote-access.md) for remote access instructions.

2. Mount the EVE-OS config partition.

```text theme={"dark"}
eve config mount /mnt
```

3. Open the server config file in a text editor and replace the existing server URL with your target server.

```text theme={"dark"}
vi /mnt/server
```

4. Unmount the config partition.

```text theme={"dark"}
eve config unmount /mnt
```

5. Reboot the node to apply the change.

```text theme={"dark"}
reboot
```

EVE-OS will connect to the new server on the next boot.

## Next Steps

> [card] [Get EVE-OS](https://zededa.mintlify.site/new-ui/infrastructure-services/eve-os-installation/get-eve-os.md)
>
> Build a standard EVE-OS image.

> [card] [Install EVE-OS onto an Edge Device](https://zededa.mintlify.site/new-ui/infrastructure-services/eve-os-installation/install-eve-os.md)
>
> Complete the installation procedure.

> [card] [Onboard Nodes](https://zededa.mintlify.site/new-ui/infrastructure-services/nodes/onboard-nodes.md)
>
> Enroll the node in Edge Infrastructure Services.