Skip to content

Docs CSC now features an automatic Finnish translation. Click here for more information.

Warning!

Puhti and Mahti are being decommissioned in stages, and their storage areas will become fully unavailable from 15 October 2026. Clean up unnecessary files and move any data you need to keep by 31 August 2026. See the Roihu data migration guide for instructions on transferring your data to Roihu.

Puhti scratch is very full: keep only active data there and move or delete everything else. No new Puhti scratch quota will be granted.

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