# Edge Proxy

> Put a web proxy in front of a site, give a game server a join address, and connect game servers you host elsewhere.

Source: https://docs.coritan.com/proxies/

In the dashboard:

- /dashboard/proxies: https://www.coritan.com/dashboard/proxies
- /dashboard/proxies/web: https://www.coritan.com/dashboard/proxies/web
- /dashboard/proxies/game: https://www.coritan.com/dashboard/proxies/game

A proxy is a hostname that Coritan's edge answers for. The edge takes each visitor's or player's connection for the name and forwards it to your server, which can be hosted here or anywhere else. Proxies are for people who run a website or an app, and for people who run a game server.

## Kinds of proxy

*Web proxy*
: Puts a hostname you hold, such as `www.example.com`, behind the edge. The edge answers HTTPS for it with a free certificate, checks requests with the web application firewall (WAF) and forwards them to your *origin*: one of your servers here, or any public address. Use one for a website, an app or an API ([How web proxies work](/proxies/web-proxies/)).

*Join address*
: A name under `coritan.gg`, such as `survival-smp.coritan.gg`, that players type in their game to reach one of your servers hosted here. It carries Minecraft Java, Minecraft Bedrock or another game that connects over TCP ([How join addresses work](/proxies/join-addresses/)).

*External server*
: A join address for a Minecraft Java or Bedrock server that you run somewhere else, such as at home or with another host. You order it as a plan ([How external servers work](/proxies/external-servers/)).

*coritan.gg name*
: A free name under `coritan.gg`, such as `alex.coritan.gg`, with a DNS zone on your account. A web proxy can serve it, or a name under it, when you have no domain of your own ([Claim a free coritan.gg name](/proxies/coritan-gg-names/)).

*Custom domain*
: A name you own, such as `play.example.com`, where players can join a Minecraft server as well as at its join address ([Use your own domain for a join address](/proxies/join-addresses/custom-domain/)).

## The Edge Proxy page

In the dashboard, select [Edge Proxy](https://www.coritan.com/dashboard/proxies) in the sidebar. The page lists every proxy on your account.

Three cards sit at the top:

**Proxies**
: How many proxies the account has, split into web proxies and game proxies, such as `Web 2 · Game 3`.

**Join domain**
: The domain that every join address ends in, such as `coritan.gg`.

**Needs attention**
: How many proxies have something to look at: a certificate that is not active, an external server that does not answer, a custom domain whose `CNAME` record has gone, or a status such as `suspended` or `pending`. Select the card to list those proxies.

The tabs split the list:

- **All** lists every proxy, with its **Address**, **Type** (`Web`, `Java`, `Bedrock` or `TCP`), where it **Forwards to**, its **Health** (such as `TLS active` or `Online`), its **Status** and the date it was **Created**.
- **Web** lists web proxies, with the **Domain**, the **Origin**, the **Certificate** and the **Protection** badges. The `WAF` and `HTTPS` badges are filled in while each is on, and `Dev mode` appears while development mode is on.
- **Game** lists join addresses and external servers, with the **Join address**, the **Edition** and the **Server list** entry. The **Backend** column shows an external server's check (`Online`, `Offline`, `Suspended` or `Not checked`) and a custom domain that is not working yet or has stopped (`CNAME pending` or `CNAME lost`).

Type in **Search proxies** to find a proxy by its name, its address or where it forwards. Filter the list with **All**, **Active**, **Needs attention** or **Suspended**. Select a row to open the proxy, and **All proxies** at the top of its page to come back.

**New proxy…** creates any kind. It asks what the edge answers for (**Website or app**, **Minecraft Java**, **Minecraft Bedrock** or **TCP service**), then where to forward (**A server hosted here** or **A server elsewhere**). For a game, **A server elsewhere** opens the order page for an external server.

When one kind of proxy fails to load, a warning such as `Could not load your web routes` appears above the list, and the rest of the list still shows. Select **Try again** to load it again.

## What you can do

Web proxies:

- [Create a web proxy](/proxies/web-proxies/create-a-web-proxy/)
- [Change a web proxy's origin](/proxies/web-proxies/change-the-origin/)
- [Redirect requests with rules](/proxies/web-proxies/redirect-rules/)
- [Customise the error page](/proxies/web-proxies/custom-error-page/)
- [Change a web proxy's settings](/proxies/web-proxies/settings/): the WAF, HTTPS, caching and development mode

Game servers:

- [Create a join address](/proxies/join-addresses/create-a-join-address/) for a server hosted here
- [Customise the server list entry](/proxies/join-addresses/server-list/) that players see in their game
- [Use your own domain for a join address](/proxies/join-addresses/custom-domain/)
- [Connect a server you host elsewhere](/proxies/external-servers/connect-an-external-server/), and [manage its plan](/proxies/external-servers/billing/)

Names and problems:

- [Claim a free coritan.gg name](/proxies/coritan-gg-names/)
- [Troubleshoot proxies and join addresses](/proxies/troubleshooting/)

A website hosted here has its web proxy on its own page as well ([Manage a website's web proxy](/websites/proxy/)).

## How Edge Proxy is billed

Web proxies and join addresses for servers hosted here come with no order and no invoice, and so do coritan.gg names. An external server is a plan that you order and renew like any other service ([Manage an external server's plan](/proxies/external-servers/billing/)).

## Limits and availability

- A hostname has one web proxy across all of Coritan, and a name under `coritan.gg` belongs to one join address or claimed name.
- A **TCP service** join address forwards only to a server hosted here. An external server carries Minecraft Java or Minecraft Bedrock only.
- A **Minecraft Bedrock** join address takes players on Bedrock 26.50 and newer ([Editions and ports](/proxies/join-addresses/#editions-and-ports)).
- A server hosted here or an external server has at most one custom domain.
- An account holds up to 3 coritan.gg names.
- When your account does not offer a kind of proxy, the page leaves out its tab, and **New proxy…** leaves out its choice or marks it `Not available on this account.`