Skip to main content

AMP Commands

The ampinstmgr tool is used for managing AMP (Assetto Corsa Multiplayer) instances. It provides various flags, operations, and commands to create, configure, and control AMP instances.

tip

The ampinstmgr tool is available only on Linux and Windows. You need to sudo su -l amp as root to use it.

Flags​

  • --nocache: Do not use an existing cached copy of AMP when creating or updating instances.
  • --advanced: Show advanced operations when using the help command.
  • --shared: (Linux Only, Experimental Feature) Create instances as 'shared' instances without their own copy of AMP. Saves disk space, but instances are always the latest version from the main AMP package.
  • --version: Display the version and exit.
  • --sync-certs: (Linux Only) Sync against the system certificate store. Normally performed automatically.
  • --log-sensitive: Include sensitive arguments (passwords, etc.) in the main log. Use with care.
  • --docker: (Linux Only) Create instances inside Docker containers (requires AMP user membership in the 'docker' group).
  • --strict: Error out if a parameter is missing. For use in non-interactive scripts.

Provisioning Settings​

Commands like createinstance and reconfiguremultiple accept provisioning settings. Format: +Area.Setting.Key Value, e.g.,

ampinstmgr reconfiguremultiple * +Core.Login.AuthServerURL http://localhost:8080

Available Operations​

  • --BrowseInstance [Instance Name]: Browse to an instance.
  • --ChangeInstanceStream [Instance Name] [Release Stream] (Force): Switch an instance to a different release stream.
  • --CreateInstance, -c [Module] [Instance Name] [IP Binding] [Port Number] [License Key] [Admin Username] [Admin Password] [Provision Settings]: Create a new standalone AMP instance.
  • --DeleteInstance, -d [Instance Name] (Skip Verification): Delete an existing AMP instance.
  • --Help, -? (Command): Display Help.
  • --LastLog [Instance Name]: View the most recent log file for a given AMP instance.
  • --QuickStart, -quick [Username] [Password] (IP Binding) (Port) (Provision Settings): Create an ADS instance.
  • ... (other operations)

AMP Instance Manager (ampinstmgr) Command Reference

Available Operations​

The ampinstmgr tool provides a range of operations to manage AMP instances efficiently. Here is a list of available operations along with their descriptions:

  • --BrowseInstance [Instance Name]
    Browse to the specified instance.

  • --ChangeInstanceStream [Instance Name] [Release Stream] (Force)
    Switch an instance to a different release stream. Use the (Force) option to forcefully perform the switch.

  • --CreateInstance, -c [Module] [Instance Name] [IP Binding] [Port Number] [License Key] [Admin Username] [Admin Password] [Provision Settings]
    Create a new standalone AMP instance. Provide various parameters such as the module, instance name, IP binding, port number, license key, admin username, and admin password. You can also include additional provisioning settings.

  • --DeleteInstance, -d [Instance Name] (Skip Verification)
    Delete an existing AMP instance. Use the (Skip Verification) option to skip confirmation prompts.

  • --Help, -? (Command)
    Display detailed help information about the specified command.

  • --LastLog [Instance Name]
    View the most recent log file for a given AMP instance.

  • --QuickStart, -quick [Username] [Password] (IP Binding) (Port) (Provision Settings)
    Quickly create an ADS (Assetto Corsa Dedicated Server) instance. Specify the username, password, IP binding, port, and additional provisioning settings.

  • --RebindInstance [Instance Name] [IP Binding] [Port Number]
    Change the IP/Port binding of an existing AMP instance.

  • --ReconfigureInstance [Instance Name] [Provision Settings]
    Reconfigure an AMP instance by providing new provisioning settings.

  • --ResetLogin, -e [Instance Name] [Username] [Password]
    Reset the login details for a standalone instance.

  • --RestartAllInstances (Instances) (Delay)
    Restart all AMP instances. Optionally provide a delay in milliseconds between restarting instances.

  • --RestartInstance, -r [Instance Name]
    Restart a running AMP instance. If the instance is already stopped, it will be started.

  • --SetStartBoot, -x [Instance Name]
    Toggle the boot-time flag for an instance.

  • --ShowAllInstancePorts
    Show port usage for all instances.

  • --ShowInstanceInfo, -i [Instance Name]
    Show detailed information about a given instance.

  • --ShowInstancePorts [Instance Name]
    Show port usage by a specific instance.

  • --ShowInstancesList, -l
    Print information about current instances as a list.

  • --ShowInstancesTable, -t
    Display a table of current instances.

  • --ShowModuleList, -m
    Display a list of available modules.

  • --StartAllInstances, -a (Instances) (Delay)
    Start all AMP instances. Optionally provide the number of instances and a delay in milliseconds between starting instances.

  • --StartBoot, -b (Delay)
    Start boot-time AMP instances. Optionally provide a delay in milliseconds between starting instances.

  • --StartInstance, -s [Instance Name]
    Start an existing AMP instance.

  • --StopAllInstances, -o (Instances)
    Stop all running AMP instances. Optionally specify the number of instances to stop.

  • --StopInstance, -q [Instance Name]
    Stop a running AMP instance.

  • --UpgradeAll, -p (Restart Running Instances) (Mainline Instances Only)
    Upgrade all AMP instances. Use the (Restart Running Instances) option to automatically restart running instances after upgrading. Use the (Mainline Instances Only) option to upgrade only instances set to the Mainline release stream.

  • --UpgradeInstance, -u [Instance Name]
    Upgrade an existing AMP instance in-place.

  • --Version
    Display the version of ampinstmgr.

  • --View [Instance Name] (Force)
    View the console of a running AMP instance. Use the (Force) option to forcefully attach to the console, even if it appears not to be running.

Example Commands​

Creating a New Instance​

ampinstmgr -c AssettoCorsaServer MyInstance 0.0.0.0 9600 MyLicenseKey admin mypassword +Core.Login.AuthServerURL http://localhost:8080

Restarting an Instance​

ampinstmgr -r MyInstance

Conclusion​

The ampinstmgr tool provides a comprehensive set of flags and operations for managing AMP instances efficiently. By using these commands, you can create, configure, and control instances according to your requirements.