> For the complete documentation index, see [llms.txt](https://developer.fotokite.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.fotokite.com/network-integration.md). # Network Integration The Fotokite system and Fotokite API can operate in different network setups depending on your needs. On this page we present supported network configurations. Choose one of the following network setups and follow the instructions below: * **Standalone setup**\ Connect your client device directly to the Ground Station. \ Select [#standalone-setup](#standalone-setup "mention") * **Integrated setup**\ Connect your client device and one ore more Ground Stations to the same local network. \ Select [#integrated-setup](#integrated-setup "mention") A more detailed guide on supported network setups can be found in our user manual in [Network Integration and Setup](https://manual.fotokite.com/installation-and-integration/network-integration-and-setup). ## Standalone setup ### What is **a standalone setup**? The Fotokite Ground Station provides its own IP network with DHCP and Internet access via the built-in modem. This network can be accessed by connecting to the Wi-Fi network provided by the Ground Station. It is also possible to connect to the Ground Station network via the Ethernet port on the Ground Station, if it is configured in "Bridged" mode.

Standalone setup

### When should a **standalone setup** be used? This can be used for development and stand-alone deployments. Controlling more than one Sigma system via Ground Station network access is not supported. ### Setup 1. Connect your client device to the Ground Station: 1. Over Wi-Fi: Connect your client device to the Ground Station Wi-Fi network. 2. Over Ethernet: Connect your client device over Ethernet with the Ground Station. Make sure the Ethernet port is set to "Bridged" mode in Fotokite Live - System Connect - Advanced Ground Station Settings. Also make sure you pick the correct Ethernet port if you have a Roof Top Box. See [Network Integration and Setup](https://manual.fotokite.com/installation-and-integration/network-integration-and-setup#physical-connection) 2. You can now call API endpoints using the following URLs: ```bash # HTTP with ip and port curl http://192.168.2.100:3128/api/v1/health # HTTPS with ip and port curl --insecure https://192.168.2.100:3128/api/v1/health # HTTP with hostname curl http://.sigma.fotokite-system.com/api/v1/health # HTTPS with hostname curl https://.sigma.fotokite-system.com/api/v1/health ``` ## **Integrated setup** ### What is the i**ntegrated setup**? The Fotokite system can be connected to any local network. Either via Wi-Fi or via ethernet. This network can be, for example a vehicle network, a building/office network or simply a smartphone with an enabled Wi-Fi hotspot.

Integrated setup

### When should an **integrated network setup** be used? We recommend this setup for any deployment that has its own upstream Internet connection. The integrated setup must be used if more than one Fotokite device should be controlled from a single client device. ### Using hostname The Ground Station network will automatically resolve the hostname `.sigma.fotokite-system.com` to the IP address 192.168.2.100, where all Sigma interfaces can be reached. The Ground Station will issue globally trusted TLS certificates for this domain name, and encrypted communication via HTTPS or RTSPS can be used seamlessly without extra setup. Despite the fully qualified domain name, all communication remains local and an internet connection is not required, apart from initial setup. ### Setup 1. Connect your client device to your local network. {% hint style="danger" %} The 192.168.2.X/24 IPv4 subnet is used internally by the Fotokite system. There will be address conflicts if the customer network is configured with an overlapping IP address range. This cannot be changed. {% endhint %} 2. Connect your Fotokite Live tablet to your Ground Station over Wi-Fi. This is required for setup only. 3. Connect your Ground Station to your local network 1. Over Wi-Fi: Select your network in Fotokite Live - System Connect - Internet over Wi-Fi. 2. Over Ethernet: Connect your Ground Station over Ethernet with your local network. Make sure the Ethernet port is set to "NAT (DHCP)" or "NAT (Static)" mode in Fotokite Live - System Connect - Advanced Ground Station Settings. 4. If "NAT (DHCP)" is selected, the Ground Station will now automatically configure an IP address using DHCP. The IP address will be shown in Advanced Ground Station Settings*.*

NAT (DHCP)

5. Now you can try to access the API (unencrypted using --insecure) using the displayed IP address shown in Advanced Ground Station Settings (as in the screenshot above). 
# HTTPS (without certificate verification)
curl --insecure https://10.21.0.120/api/v1/health
6. Setup an encrypted connection\ \ The Ground Station will issue globally trusted TLS certificates for the domain name `.sigma.fotokite-system.com`, and encrypted communication via HTTPS or RTSPS can be used. Despite the fully qualified domain name, all communication remains local and an internet connection is not required, apart from initial setup. 7. Determine your Fotokite system name. You can find it in Fotokite Live > System Connect. 8. Setup a local hostname binding for \.sigma.fotokite-system.com on your client device or your network router.
Now you can try to access the API (encrypted) using the hostname as shown below. ```bash # HTTPS curl https://.sigma.fotokite-system.com/api/v1/health ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://developer.fotokite.com/network-integration.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.