# AMP First Time Setup

## Welcome to

Please click Next >> to continue setup.

### AMP Licence

Please enter the AMP licence key you'd like AMP to use.

If you own more than one licence key it is recommended you add the largest first. Additional licences may be added later.

AMP Licence Key

You may continue setup without a licence key, but you will need to re-run this setup to activate the licence specific features or to create instances. Search for "Default Auth Server" at the top right and click the "Re-run Setup" button

Need AMP licences? You can buy one here.

### Verifying licence details...

### Operation Mode

These operation modes determine how AMP will behave. Controller/Target setups are for larger deployment with multiple machines that will be running AMP installations. If you're unsure what mode you need, pick Standalone (Default).

### For AMP installations on a single host/machine:

Standalone (Default)
Creates local instances, does not log into a controller instance. Recommended for users running AMP locally.
Choose this if you're not sure which mode you need.

### For AMP installations across multiple separate hosts/machines: (For advanced users)

### AMP Professional Edition or above is required to use multi-server deployments.

Controller
Cannot create local instances, provides login services and management to target ADS instances.
You must create at least one additional target ADS instance. Target
Creates local instances, logs into and managed by a controller instance. Hybrid (Not Recommended)
Behaves like both a target and a controller. It can create instances locally, but also delegate instance creation to other targets.

### Controller Details

Please enter the details for the ADS Controller that this target should use for authentication and management.

Before continuing, please place your AMP controller into Pairing mode by clicking the hubPair New Target button in the top right corner of your controller. This will allow you to add this target to that specific controller. The target and controller must be able to directly communicate with each other.

#### Friendly Name

The name that will show in the controller for this target.

#### ADS Controller URL

The URL of your AMP controller instance.

#### Pairing Code

Select the "Pair New Target" button on your controller to obtain a pairing code.

### Pairing with controller...

### Privacy Settings

These settings affect all users who use this AMP installation

Submit anonymous crash reports
If enabled, AMP will automatically send anonymous diagnostic data to CubeCoders for analysis in the event that AMP should suffer an error that it can't recover from. This includes basic non-personal information about your system such as the OS, system version, and loaded AMP plugins.
Disabling automatic crash reports may reduce the quality of support that CubeCoders can provide. Allow anonymous Usage Data
Anonymous in-browser usage data gathering allows CubeCoders to see which devices and browsers AMP is being used on most frequently, and which games are most frequently being set up. We use this aggregate data to determine application usage and focus our efforts accordingly. Analytics isn't loaded until after you login to AMP.
Analytics is run internally by CubeCoders Limited, no data is sent to third-party services. Use enhanced licence reporting
Include instance names and other basic information in licence reporting to make it easier to see how your licence is being used.
This information will become viewable by the licence account holder.

Further Information: What information is included in AMP error reports?

### Applying configuration changes...

## Secure Logins

Authenticate with your mobile device, token, fingerprint, or any other Webauthn/Passkeys compatible security method.

AMP supports Webauthn and Passkeys, which allows you to login securely using one of many different options including your mobile device, biometrics, a security token, and many other methods. It's faster, more convenient, and more secure than traditional password based logins.

Webauthn is built right into your browser. There's no need to sign up to any third party service and there's no software or browser extensions to install. When you click Setup, your browser will show you a list of available options.

Including mobile devices, fingerprint readers, and hardware authenticators.

Get a compatible hardware security token
Referral link, opens in new tab

Use timed one-time passwords (TOTP) by scanning a QR code with your authenticator app.

I don't want extra security

Standard username and password only. 2FA or secure devices can be added later.

### Finished!

ADS is now configured. AMP must now be restarted to complete setup.

Once restarted this instance will be ready for use.

### AMP is now restarting...

The page will reload automatically once the restart has completed.

If the reload does not occur within 30 seconds, please manually restart AMP.

### While you're waiting...

Consider joining the Official CubeCoders Discord to get fast answers to your questions.

### Unsupported Environment

You are currently running AMPs core inside a container using an unofficial image built by a third-party.

Containers have a number of limitations that make it unsuitable for this application:

- Containers cannot expose new ports without a full shutdown - including every server running in the same container.
- It will prevent AMP from being able to manage the system firewall and opening ports for game servers automatically.
- You will not be able to securely isolate individual game servers from each other.

If you are using an appliance operating system such as TrueNAS, OpenMediaVault or UnRAID - we recommend that you create a normal Linux virtual machine and install AMP inside it using the official script.

Otherwise, the recommended method of using Podman with AMP is to install AMP on the host itself, and allow AMP to deploy individual instances in their own containers. AMP has minimal dependencies, and will not bloat the host environment with unnecessary pacakges.

By using a third-party container, CubeCoders will not provide any support for this installation.

We strongly recommend that users only use the official installation script.