Install Puppet Remediate on a Linux or Windows machine that is connected to the internet.
Make sure you meet the system requirements for installing and running Remediate, and that you have received your license.
Install and run Docker on the node
where you want to install Remediate.
- Download Docker for your operating system:
Download Docker Compose.
Note: If installing Docker Compose on Windows, create a new environment variable called
COMPOSE_CONVERT_WINDOWS_PATHSand set it to
1. By doing this, you enable path conversion from Windows-style to Unix-style in volume definitions. For more information, see the Docker Compose documentation.
Initialize a swarm by running the following command:
docker swarm init
Download the Remediate
Docker Compose file to the same directory as your
Note: If you want to manually validate the signature, see Verify Docker Compose file for more information.
Run the following command (replacing
your-license.jsonwith your own license):
docker-compose run remediate start --license-file your-license.json
The container images are pulled from the Google Cloud Platform.CAUTION: If you start Remediate without a license file you will not have access to the full range of Remediate functionality. If you started Remediate without a license file in error, simply stop the application by issuing the following command:
docker-compose run remediate stop
And start Remediate again using the --license-file parameter as outlined above.
To check that all the images have downloaded
and that the containers have started running, run the following
The list of running containers:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 36139cda23ca gcr.io/puppet-discovery/pdp-go:<version> "/app/entrypoint.sh" 3 minutes ago Up 3 minutes (healthy) 8082/tcp, 8087/tcp remediate_gopdp.1.w035aad0ifvu0ynaimxy64lcq 43709401f394 gcr.io/puppet-discovery/pd-storage:<version> "storageEntryPoint.s…" 3 minutes ago Up 3 minutes (healthy) 5432/tcp remediate_storage.1.omv1rrd3rwhnwo3ngurgtcnxk 551b061acc98 gcr.io/puppet-discovery/licensing-api:<version> "/entrypoint.sh" 3 minutes ago Up 3 minutes (healthy) remediate_licensing.1.kdoj7s492el77rdpc2rza3fx7 43a3568e6b5a vault:1.1.2 "docker-entrypoint.s…" 3 minutes ago Up 3 minutes (healthy) 8200/tcp remediate_vault.1.k0jgyxxi45ldn4pqadhgvjf0o 11b90d8564ef gcr.io/puppet-discovery/identity:<version> "/opt/jboss/tools/do…" 3 minutes ago Up 3 minutes (healthy) 8080/tcp, 8443/tcp remediate_identity.1.b1wkt4kx4ps107949k14ctsqx 1235fd27cbdc gcr.io/puppet-discovery/frontdoor:<version> "nginx -g 'daemon of…" 3 minutes ago Up 3 minutes (healthy) 80/tcp remediate_frontdoor.1.oib8jsr7u4z6wqxvjz02mxcxz a3a641af5269 gcr.io/puppet-discovery/pdp-proxy:<version> "/pdp-proxy-svc" 3 minutes ago Up 3 minutes (healthy) 9200/tcp remediate_export.1.uin509pnc2zb4pf3rdjr1so0x c60250b8a2eb gcr.io/puppet-discovery/node-ui:<version> "/usr/src/app/entryp…" 3 minutes ago Up 3 minutes (healthy) remediate_ui.1.3u0tewgou7t4hz2c46nn4mydo f9af99dc9ca7 gcr.io/puppet-discovery/edge:<version> "/edge-svc" 3 minutes ago Up 3 minutes 9997/tcp remediate_edge.1.koacwnjoce2tabwcbi73619fu 149485b54fec gcr.io/puppet-discovery/controller:<version> "/controller-svc" 4 minutes ago Up 4 minutes (healthy) 9999/tcp remediate_controller.1.mww2fm9up4lmeisjorul89hr4 f9f1ab4a029d gcr.io/puppet-discovery/vr:<version> "/vr-svc" 4 minutes ago Up 4 minutes (healthy) remediate_vr.1.yjlliup91g4mac1bklvvw2nqq
To access Remediate on a local workstation,
the URL is
https://localhost:8443, or port
8443on the host where you installed Remediate.Note: When you first open the site, a warning message will be displayed that indicates the site certificate is untrusted. This is because Remediate uses a self-signed certificate and is expected behavior. Accept the certificate to continue.
- Read and accept the software license agreement.
Sign in to Remediate.
For default usernames and passwords, see Managing user access.