LogoLogo
Go to i3d.netGet support
  • Home
  • Game Hosting
    • Get started
      • Set Up Guide
      • Game Template
      • Game Deploy
    • Overview
      • API guide for game hosting
      • Terminology
      • API v3 usage
      • API v3 authentication
      • API v3 error handling
      • API v3 error codes
    • Processes
      • Application Management
      • Application Build Provisioning
      • Application Build Management
      • Deployment Configuration
      • Deployment Process
      • Automatic Deployment
      • Automatic Scaling
      • Dependency Installation
      • Patching
        • Utility patching
        • Forced Deployment
        • Forced Deployment Manually
        • Rolling Deployment
        • Rolling Deployment Manually
        • A/B Deployment
        • A/B Deployment Manually
    • Elements
      • Application
        • Applicationproperty
        • Applicationbuild
        • Applicationbuildproperty
        • Applicationbuildconfiguration
        • Applicationinstance
        • Applicationinstanceproperty
        • Applicationinstanceip
        • Label
        • Metadata
        • Element Relations
        • Platform Variables
      • Deployment
        • Fleet
        • Deploymentprofile
        • Deploymentregion
        • Deploymentcontainer
        • Deploymentcontainerlocation
        • Deployment Templates
          • Gamedeploymenttemplate
          • Utilitydeploymenttemplate
          • Dependencydeploymenttemplate
        • Host Capacity
          • Instancetypecapacity
        • Dclocation
      • Host
        • Hostcpu
        • Hostip
        • Hostdisk
        • Hostmemory
      • Patching
        • Patchjobapplicationbuild
        • Patchjobfleet
        • Patchjoboverallprogress
        • Patchjobemail
    • Features
      • Task System
      • Platform Events
    • Cloud Usage
      • Cloud Credentials
      • Cloud Instance Types
    • Game Integration
      • Orchestrator overview
      • Matchmaker Allocation
      • Ping beacons overview
      • Upgrade GCP VMs to AMD Milan or later
      • Game server run status
      • Gameliftanywhere integration
      • Game Hosting-SDK
        • Build
        • Integration Guide
        • Sdk Unity Plugin
        • Sdk Unreal Plugin
      • Management Protocol
        • A2S
        • Arcus
          • Usage
          • Configuration
          • Packet Structure
          • Handling Server Query Response
          • Available Opcodes
        • Arcus V2
          • Request Response
    • Events
    • Examples
      • Registering Application And Builds
      • Env From Scratch
  • Anti-DDoS
    • About our Anti-DDoS
    • DDoS attack types
    • Warden: Capabilities and benefits
      • Anti-DDoS onboarding guide
      • Warden: How it works
      • Armor configuration templates
    • DDoS category attack types
  • Compute
    • Dedicated Bare Metal
      • Catalog
    • FlexMetal
      • Getting started with FlexMetal
      • OS Customization
      • Talos installation
      • Tag management
      • Check your quota usage
      • Reinstall your servers
      • Troubleshooting
  • Contact
  • Api
    • General
    • Game
    • GLAD API
  • Endpoints
Powered by GitBook

© i3D.net | All rights reserved.

On this page

Was this helpful?

Export as PDF
  1. Compute
  2. FlexMetal

Reinstall your servers

PreviousCheck your quota usageNextTroubleshooting

Last updated 13 days ago

Was this helpful?

Warning: The operation will always cause a full disk wipe. All data will be lost! Proceed with caution.

To reinstall your servers, use the endpoint provided in the . Ensure you obtain the required UUID from the POST /servers response body. You may pass optional parameters such as:

  • name (hostname)

  • os (operating system), which must include a slug property. If the OS is not Windows or Talos, the sshKey is mandatory.

  • kernelParam (optional)

  • partitions (optional)

  • sshKey (essential if the OS is not Windows or Talos)

  • postInstallScript (must be a valid Shell script)

Usage Scenarios

  • Parameters:

    • name: (string) Optionally include kernelParam, partitions, sshKey

  • Behavior: The originally provisioned OS will be reinstalled, including any specified kernelParam, custom partitions, and/or sshKey.

    • If you pass a new sshKey, it replaces the original.

  • Parameters:

    • os: (object) Fully specify the OS you want to install.

  • Behavior: The originally provisioned OS will be replaced by the provided OS object, which is installed instead.

  • Parameters:

    • sshKey: (array)

  • Behavior: The originally provisioned OS is reinstalled, but only the passed SSH keys are injected (not the default/original ones).

Example PATCH request with all of the options

{
  "name": "host.example.com",
  "os": {
    "slug": "ubuntu-2404-lts",
    "kernelParams": [
      {
        "key": "test-kernel-param-key",
        "value": "test-kernel-param-value"
      }
    ],
    "partitions": [
      {
        "target": "/custom",
        "filesystem": "ext4",
        "size": 10240
      }
    ]
  },
  "sshKey": [
    "ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAyNTYAAABBBHo8IaPkQ6UnDZvi4F4RBSouRa6Gtysdg2EF+SIXheVF2SGBQ2uH7RfDjXRfvq4VpHJrKYs4kWfNoHQg8ZG6PH4= ecdsa-key-20240131"
  ],
  "postInstallScript": "#!/bin/bash\necho \"Hello world!\" > /root/test.txt"
}
API documentation