Quickstart Setup Guide¶

This guide provides an introduction to Trustpoint and instructions for setting up the Trustpoint using Docker.

Getting Started with Docker 🐳¶

Prerequisites ✅¶

Make sure you have the following installed:

Docker: Version 20.10 or higher.
Git: To clone the Trustpoint repository.

Step-by-Step Setup (Load from Dockerhub) ⬇️¶

Pull the Trustpoint Docker Image

First, pull the Trustpoint Docker image from Docker Hub. This command will download the pre-built container image directly:
```
docker pull trustpoint2023/trustpoint:latest
```
This command pulls the latest version of the Trustpoint image from Docker Hub.
Run the Trustpoint Container with a Custom Name and Port Mappings 🚀

Once the image is pulled, you can start a new container with a custom name and port mappings:
```
docker run -d --name trustpoint-container -p 80:80 -p 443:443 trustpoint2023/trustpoint:latest
```
- -d: Runs the container in detached mode.
- –name trustpoint-container: Names the container trustpoint-container.
- -p 80:80: Maps the container’s HTTP port to your local machine’s port 80.
- -p 443:443: Maps the container’s HTTPS port to your local machine’s port 443.

Step-by-Step Setup (Build container) 🔧¶

Clone the Trustpoint Repository

First, clone the Trustpoint source code from the official repository:
```
git clone https://github.com/TrustPoint-Project/trustpoint.git
cd trustpoint
```
This command downloads the Trustpoint source code to your local machine and navigates into the project directory.
Build the Trustpoint Docker Image

Use Docker to build the Trustpoint image from the source:
```
docker build -t trustpoint .
```
- -t trustpoint: Tags the image with the name trustpoint.
- .: Specifies the current directory as the build context.
Run the Trustpoint Container with a Custom Name and Port Mappings 🚀

Start the Trustpoint container using the image you just built, with a custom name and both port mappings:
```
docker run -d --name trustpoint-container -p 80:80 -p 443:443 trustpoint
```
- -d: Runs the container in detached mode.
- –name trustpoint-container: Names the container trustpoint-container.
- -p 80:80: Maps the container’s HTTP port to your local machine’s port 80.
- -p 443:443: Maps the container’s HTTPS port to your local machine’s port 443.

Verify the Setup 🔍¶

Once the container is running, you can verify the setup:

Web Interface: Open https://localhost in your browser to access the Trustpoint interface.
Default Credentials: Use the following login information to access the Trustpoint interface:
- Username: admin
- Password: testing321
Note

You may need to accept a self-signed certificate in your browser to proceed.

🥳 CONGRATULATIONS!

You’ve successfully set up Trustpoint! Your environment is now ready to securely manage digital identities for your industrial devices. You can start registering devices, issuing certificates, and building a trusted network.

Change the Current Admin User Password 🔑¶

To secure your Trustpoint setup, it’s important to change the default admin user password:

Go to https://localhost/admin
Click on the Users section in the Django admin dashboard.
Select the admin user from the list.
Scroll down to the password field and click the “change password” link.
Enter and confirm the new password.
Click Save to update the password.

Tips and Troubleshooting 🧰¶

View Logs: For troubleshooting, view logs with:
```
docker logs -f trustpoint-container
```

Stop and Remove the Container: Stop and remove the container with:

docker stop trustpoint-container && docker rm trustpoint-container

What to Do Next ➡️¶

After setting up and Trustpoint, here are some recommended next steps to explore the full capabilities of the platform:

Explore Trustpoint with test data 🧪: Familiarize yourself with Trustpoint’s functionalities by running it with sample test data. To populate test data, navigate to Home > Notifications > Populate Test Data in the Trustpoint interface.
Use the Trustpoint in conjunction with the Trustpoint Client 💻: The easiest way to fully utilize Trustpoint is by pairing it with the associated Trustpoint Client, which is installed on end devices. The client enables streamlined identity management and certificate issuance. For more details, visit the Trustpoint-Client Documentation.
Issue your first certificate for an end device 🛡️: To do this, you need an Issuing CA certificate, a domain and a device that you must define in Trustpoint. Therefore follow the steps described in Quickstart Operation Guide