Skip to main content
Skip table of contents

Foreman Web Interface

Navigate to the URL you configured for Foreman during the setup, this could be your own custom URL that you have created the DNS records for, or it could be the Public IPv4 DNS name provided to the EC2 instance.

Your web browser will warn you about the SSL Certificate, this can be ignored.

image-20250403-132442.png

When you have the login screen, use the credentials created during setup - the username and password displayed when accessing the CLI interface of the EC2 instance.

image-20250403-132517.png

Initial Login

Every time you log into foreman you will see the main dashboard.

image-20250403-132546.png

To list the hosts, got to Hosts > All Hosts

image-20250403-132609.png

First module

To show foreman and puppet working, you can add a module from Puppet forge for this we will use ntp.

SSH to the CLI of your Foreman EC2 machine and run the following to download and install the ntp and stdlib modules (dependency of the ntp module)

BASH
sudo puppet module install puppetlabs-ntp --version <version>

The version number can be obtained from the Puppet forge ntp page.

image-20250403-133245.png

Once the module is installed it needs to be added to Foreman. Navigate to Configure > Pullet ENC > Classes and click the Import environments button.

image-20250403-132705.png

After a few moments it will display the two new modules, tick the box to Add them and click Update.

image-20250403-133103.png

This will take you to the classes screen and will list the various classes that form the two modules you have added.

image-20250403-133409.png

To add the ntp module to a host, go to you list of hosts (Hosts > All Hosts) and click Edit for the host you wish to add the module too.

image-20250403-134654.png

Go to the Puppet ENC tab

image-20250403-134801.png

Click the +ntp module to show the classes. The click ntp to add it to Included Classes

image-20250403-134852.png

There is no need to add any of the other components as ntp includes these automatically.

image-20250403-134933.png

You can wait for puppet to run on your host, or you can log into it and manually run puppet to make it happen quicker. By default, puppet will run every 30 minutes.

BASH
sudo puppet agent -t

This will force puppet to run and output everything it does.

image-20250403-135221.png

This information is fed back to Foreman and can be reviewed by selecting the host and going to reports.

image-20250403-135440.png

If something errors you will see these as failed runs.

image-20250403-135523.png

Looking at a report will show what was done, any files that were updated you will be able to access a diff output.

image-20250403-151706.png

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.