LogoLogo
edgegap.comDashboard
  • 📘Learning Center
    • Getting Started
    • Unity Games
      • Getting Started - Servers
      • Developer Tools
    • Unreal Engine Games
      • Getting Started - Servers
      • Developer Tools
    • Matchmaking
      • Getting Started
      • Matchmaker In-Depth
      • Ping Beacons
    • Advanced Features
      • Apps and Versions
      • Deployments
      • Managed Clusters
  • API Reference
    • Dedicated Servers
    • Integration
    • Matchmaking
    • Peer to Peer
  • Release Notes
  • 📚Documentation
    • Sample Projects
      • Unity Netcodes
        • Unity NGO
        • Photon Fusion 1
        • Photon Fusion 2
        • Mirror
        • Mirror WebGL
        • Fishnet
        • Fishnet WebGL
        • Photon Bolt
      • Unreal Top-Down Sample
      • NuxtJS
      • Ruby On Rails
      • Unity Lobbies
      • Unity Matchmaker
    • Tools & Integrations
      • Container
        • What is Docker
        • Your First Docker
        • The Good Practices
        • SSH in Your Container
        • External Registries
          • Docker Hub
          • AWS ECR
          • GCP GCR
          • Gitlab registry
      • Deploy from Nakama
      • EOS Lobby Integration
      • Switch From Gamelift
      • Switch From Multiplay
      • Playfab Bridge
    • Deployment
      • Endpoint Storage
        • How to Save Logs
        • Upload File to Deployment
      • Webhooks
    • Application
      • Command and Arguments
      • 1:1 Port Mapping
    • Session
      • How They Work
      • Application Version Configuration
      • Manage Request
      • Selectors Filtering
    • Fleet
      • Fleet Policy
      • Policy Filter
      • Linking Version
      • Fleet's Deployment
    • Container Registry
    • Distributed Relay
      • Matchmaker/Lobby
      • Relay Edgegap API
      • Transport Samples
    • Lobby
      • Lobby Service
      • Functions
    • Glossary
    • SLA Terms
Powered by GitBook
On this page
  • Getting your credentials
  • Docker login Warning
  • Pushing an image to the registry
  • Tagging the same build artifact multiple times (pushing an image duplicate)
  • Managing your images
  • Delete build artifacts via API
  • Requesting more storage
  • Next steps

Was this helpful?

  1. 📚Documentation

Container Registry

PreviousFleet's DeploymentNextDistributed Relay

Last updated 2 months ago

Was this helpful?

LogoLogo

Connect with Community

  • Discord
  • Linkedin
  • X

Read More

  • Release Notes
  • Blog
  • Enterprise
  • Legal
  • edgegap.com

© 2025 Edgegap

Now that you know how to use our platform, you need to containerize your game server. You will need a place to store your container images to be accessible when deploying your game servers.

That is why we created the Edgegap Container Registry. It is a privately managed container repository that works much like standard public container registries, but with the added benefit of increased security, vulnerability scans and other goodies! With high availability and dashboard integration, you will spend less time learning new tools, and your servers will always be ready to go.

Getting your credentials

To push images, you will first need to authenticate to our registry, and for that, you need credentials. Find the Container Registry tab in the Service section to request your credentials in the sidebar. From there, you can request access to our registry.

In the box at the bottom of the screen, you will find everything you need to connect to the registry and push your container images.

Field
Description

URL

The URL of our container registry. You will need to use it when logging in and pushing images.

Project

The name of your assigned project. You must include it in your image repository path.

Username

The username to use when logging in to the registry.

Token

The password to use when logging in to the registry.

You can now login to the repository using your tool of choice:

Linux

# enter your password when prompted
docker login -u '<REPOSITORY_USERNAME>' registry.edgegap.com

cmd

# enter your password when prompted
docker login -u <REPOSITORY_USERNAME> registry.edgegap.com

Powershell

# enter your password when prompted
docker login -u '<REPOSITORY_USERNAME>' registry.edgegap.com

Docker login Warning

WARNING! Your password will be stored unencrypted in /home/user/.docker/config.json.

You can configure the credentials store by following this setup. Remember that this warning is normal behaviour from Docker.

It's important that you understand that your robot username, and the token for your private repository are encoded in base64 in your machine at this path $HOME/.docker/config.json. Anybody who has access to this file can easily decrypt your robot account token with a base64 decoder. Ensure that the environment docker login registry.edgegap.com you use is safe and that the access permissions to this file are restricted.

To remove your credentials from this file, you can easily use docker logout registry.edgegap.com each time you push and pull your private images.

Pushing an image to the registry

If you need help containerizing your project, see our documentation on this topic to get you started.

First, you need to add a tag to your image corresponding to the registry. Then, since you are logged in to the registry, all you need to do is push your image to the URL and project found on the page:

docker image tag <IMAGE_NAME>:<TAG> registry.edgegap.com/<PROJECT_NAME>/<IMAGE_NAME>:<TAG>
docker push registry.edgegap.com/<PROJECT_NAME>/<IMAGE_NAME>:<TAG>

You may push as many images as your storage permits and separate them in different repositories as you see fit. However, you should read the "App templates" section before pushing too many images!

You will then find your repositories on the same page upon refreshing.

Tagging the same build artifact multiple times (pushing an image duplicate)

If you happen to push the same build artifact twice, if the tag value is the same no change will be made.

If you happen to push the same build artifact twice, with two different tag values, no additional storage space will be consumed and our registry will simply create the new tag pointing to the same build artifact.

Managing your images

You may see your repositories by going to the same page after you have pushed at least one image.

By clicking on one of those repositories, you can see the images it contains, grouped by artifact. If you tagged the same image with two different tags and pushed those to the registry, you will see them as the same artifact.

The images tagged 1.0.1 and 1.0.2 in the picture above have the same artifact. The image tagged 1.0.3, however, has a different artifact.

If you delete an artifact, you will also delete its associated tags. The confirmation dialogue will list all the tags that this action would delete to ensure you do not accidentally delete needed resources.

Delete build artifacts via API

If the dashboard UI is too slow for you, or you need an automated continuous integration pipeline that would delete your outdated build artifacts automatically to keep your registry usage within limits, consider using our Container Registry API. Our Container Registry API allows listing all tags for a given app (image), as well as deleting individual tags. Since each image artifact (build) may have multiple tags associated at the same time (such as v1.1.0, dev, latest, or more), you will need to delete all tags associated with a specific artifact in order to free up space in your Edgegap Container Registry.

Requesting more storage

When your request for access to the registry has been approved, you will be given a certain amount of storage space in the registry.

You may request additional space by clicking on the "Request more storage" button next to the space usage indicator.

When a staff member has approved your request, you will have more space to push your images.

Next steps

Learn how to containerize your application with our guide: Getting started with Docker.