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
    • Tools & Integrations
      • Container
        • What is Docker
        • Your First Docker
        • 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
    • Container Registry
    • 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
    • Relays (P2P)
      • Relay Edgegap API
      • Transport Samples
      • Game Integration
      • Lobby Service
      • Lobby API
      • Unity Lobby Sample
    • Glossary
    • SLA Terms
Powered by GitBook
LogoLogo

Connect with Community

  • Discord
  • Linkedin
  • X

Read More

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

© 2025 Edgegap

On this page
  • Creating a new service
  • Deploying a service
  • Terminating a service

Was this helpful?

  1. Documentation
  2. Relays (P2P)

Lobby Service

Lobby service supports only Relays (P2P) and not Dedicated Servers. Please see Matchmaking.

In order to be able to group players in your peer-to-peer game through our lobbies, you will need to deploy a service to manage them beforehand. This can easily be done through a few calls to our API.

To do so, you will need to get an API token from the Edgegap dashboard if you do not have one already. Once you have one, make sure to include it in the authorization headers of all your service requests

Creating a new service

Creating a new lobby service is as easy as sending a POST request to /v1/lobbies along with what you wish to name it.

{
  "name": "string"
}

The newly created service will not be ready to be used quite yet, you will then need to deploy it.

Deploying a service

To deploy a service, send a POST request to /v1/lobbies:deploy with the name of your service.

{
  "name": "string"
}

This will take a short while to complete after going through some validations. You can track its status by sending GET requests to /v1/lobbies/{service_name}, or by viewing it in your Relay Profiles in the dashboard once it is active and running.

Once that is the case, you will get a response that contains a URL when sending the previously mentionned GET request. This is the URL you will be querying in your game in order to manage the lobbies. The requests sent to this URL do not need to include the Edgegap API token in the authorization headers.

{
  "name": "string",
  "url": "string",
  "status": "string"
}

Terminating a service

If you wish to terminate a service, you simply need to send a POST request to /v1/lobbies:terminate along with the service's name.

{
  "name": "string"
}

This will not delete the service, but merely deactivate it. If you wish, you could still re-deploy it afterwards.

PreviousGame IntegrationNextLobby API

Last updated 2 days ago

Was this helpful?

📚