Edge Installation

After creating a deployment, you need to run the installation command on the Linux server at your site.

Prerequisites

• A Linux server at the site (see hardware requirements)
• Root or sudo access on the server
• Internet connectivity (for downloading Docker images and establishing the VPN connection)
• The bootstrap command from the deployment creation dialog

Running the installation

Copy the bootstrap command from the deployment detail page and run it on your edge server:

curl -sSL https://api.fleetera.ai/api/edge/install.sh | \
  sudo bash -s -- --api-url https://api.fleetera.ai --token <TOKEN>

What the bootstrap script does

1. Installs Docker — if Docker is not already present on the machine, the script installs it
2. Sets up VPN — installs and configures a WireGuard-based VPN client and joins your private mesh network using the pre-authorized auth key
3. Downloads configuration — pulls the generated Docker Compose file and service configurations
4. Starts Fleetera Edge services — launches all containers including the database, MQTT broker, core services, device services, and the Fleetera config agent
5. Registers with the cloud — the config agent sends its first heartbeat, and the deployment status changes from Deploying to Online

Token management

The bootstrap token is a one-time use credential:

Regenerating a token

If the token expires or the installation fails, you can regenerate it from the deployment detail page:

1. Navigate to the deployment
2. Click Regenerate Token
3. Confirm the action — the old token is invalidated
4. A new token and VPN auth key are generated
5. The updated installation command is displayed

Token regeneration is available when the deployment is in Pending, Offline, or Error status. It is not available when the deployment is Online.

Verifying the installation

After the bootstrap script completes:

1. Check the deployment status in the Fleetera platform — it should show Online
2. Verify the VPN IP address appears on the deployment detail page
3. Check that Docker containers are running on the edge server:

docker ps

You should see containers for Fleetera Edge core services, device services, the MQTT broker, Redis, and the Fleetera config agent.

Stopping and restarting

To stop the edge gateway on the server:

docker compose down

To restart it:

docker compose up -d