Skip to content

Puhti and Mahti computing services have been decommissioned. Puhti and Mahti login nodes and storage services will remain available until 15 October 2026, but are no longer covered by service contracts. Please clean up and migrate your data to Roihu ASAP. See Roihu data migration guide for instructions.

Push Your First Image

This tutorial walks through the process of building a container image and storing it in Satama.

Step 1: Build a Container Image

First build your container image locally:

docker build -t <image_name>:<version> .
And verify that the image exists locally

docker image ls
Here you should see your image

Step 2: Tag the Image

Before pushing the image to Satama, it must be tagged with the registry path.

For a detailed explanation of tagging images, see Tag image

Step 3: Authenticate to Satama

Log in to Satama by personal CLI token or by Robot account.

Step 4: Push the Image

Push the tagged image to the registry.

docker push satama.csc.fi/<project>/<image_name>:<version>
For more detail about pushing image

Step 5: Verify the Image

After pushing the image, open the Satama Web UI and verify that the repository and tag appear in your project.

You can learn more about navigating the Web interface