How do I configure AMP to use Docker?

AMP allows you to deploy individual instances inside containers in order to isolate them from the host.

Note that ampinstmgr and ADS based instances cannot be run inside containers, as they need the ability to create them.

Linux

  1. From SSH/Terminal run sudo su -l
  2. Run bash <(wget -qO- getamp.sh) installDocker
  3. Reboot Linux
    4.Login to the AMP panel and navigate to Configuration -> New Instance Defaults and enable “Create in Docker Containers”
  4. Create your first Docker instance!

Note: AMP may require you to manually add the amp user to the docker group. If so, it will prompt that you run this command usermod -a -G docker amp as root.

Windows

  1. Install Docker Desktop using the Install Guide
  2. Open the start menu and type compmgmt.msc to open Computer Management
  3. Expand “Local Users and Groups” and select Groups
  4. Double-click docker-usersand click Add
  5. In the “Enter the object names to select” section type NETWORK SERVICE
  6. Click OK to close out of all windows
  7. Reboot Windows
  8. Login to the AMP panel and navigate to Configuration -> Networking to disable “Use Host Networking for new Containers”
  9. Navigate to Configuration -> New Instance Defaults and enable “Create in Docker Containers”
  10. Set the Default auth server to be http://host.docker.internal:8080 (Assuming ADS is on port 8080)
  11. Change the default AMP IP Binding to 0.0.0.0.
  12. Create your first Docker instance!

Now instances created via ADS will be created inside containers automatically. No additional configuration is required.

You can also use the --docker flag when creating instances via ampinstmgr. E.g. ampinstmgr --docker create rust