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.
In the dashboard
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.
The public Edge Proxy page describes web proxies, and the Game Shield page describes join addresses and external servers, each with prices from the catalogue.
Kinds of proxy
Section titled 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). - Join address
- A name under
coritan.gg, such assurvival-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). - 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).
- coritan.gg name
- A free name under
coritan.gg, such asalex.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). - 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).
Find your connections
Section titled Find your connectionsIn the dashboard, select Game Shield in the sidebar. The page lists the join addresses and external servers on your account, and each one is a card. Web proxies belong to a website, so they have a tab of their own, described under Web proxies. An account with no game product sees the page as Web proxies, with that tab only.
The header has two buttons. Create a join address opens a page for a server hosted here, at /dashboard/proxies/game/new. Choose the Edition (Minecraft Java, Minecraft Bedrock or TCP service), choose the Server, type the Join subdomain and select Create join address. It costs nothing. Connect an external server opens the order page for a server you run elsewhere (Order an external server). On the Web proxies tab, the header has Open Domain Management instead.
A row of tabs sits under the header, each with its count: All, Join addresses, External servers and, when your account has web proxies, Web proxies. The tiles, the strip, the search and the filters below all work on the tab you are on. While a search or filter is on, a line under the heading says how many rows match, such as "3 of 12".
Read the tiles
Section titled Read the tilesFour tiles sit above the list. Connections, Active and Needs attention are filters: select one to show those rows, and select it again to turn the filter off. Join domain is a fact, and selecting it does nothing. On a phone, a tile shows only its figure.
- Connections counts the rows on the tab. Its footer says what they are, such as "1 join address, 2 external servers". Selecting it clears every filter and the search.
- Active counts the rows that are active. Its footer shows the players online on external servers that answered the last check, such as "27 players online". With nobody online, it reads "All active" when every row is active, and "In service" when some rows are not.
- Needs attention counts the rows with a problem. It turns red while the count is above zero. Its footer reads "Backends, DNS records and payments", or "Nothing to fix" at zero.
- Join domain shows the domain that every join address ends in, such as
coritan.gg, or a dash when the page cannot read it. Its footer reads "Every join address ends in it. Minecraft players type the name without a port." When the join port is not 25565, it reads "Every join address ends in it. Java players add :" and the port "to the name."
What needs attention
Section titled What needs attentionA row needs attention when something stopped it or when you can fix something. A card shows up to two of its problems in red or amber, the worst first.
| Problem on the card | Button | What it means |
|---|---|---|
| This join address is suspended. Contact support to find out why and what to do. | Contact support | We stopped the row. An external server whose route or billing is suspended counts too, and its card reads Suspended. The sentence names the row's kind: join address, external server or web proxy. |
| This join address has an error. Contact support and we will look into it. | Contact support | The row's status is error or failed. |
| We got no answer from the backend address. | Open connection | An external server failed its last check. The sentence names the address of your server, with its port. The button opens the Connection tab. A server nobody has checked yet is not a problem. |
| The CNAME for the custom domain is missing, so players cannot join at it. | Check custom domain | The custom domain's DNS record failed its checks (Use your own domain for a join address). The button opens the Custom domain tab. |
| Waiting for payment. We set this server up as soon as you pay the invoice. Or: Payment is overdue. Open the invoice to pay it. | Open invoices | An external server's invoice is unpaid or overdue (Manage an external server's plan). |
| We could not issue a certificate for the host. Or: The certificate for the host has expired. | Open SSL | A web proxy's certificate failed or ran out. The button opens the website's SSL/TLS tab, or the web proxy's Overview when no website holds it. |
| This web proxy has nowhere to send visitors. | Set origin | A web proxy has no origin, no additional origins and no redirect. The button opens the Origin tab. |
When a row needs attention, a strip under the tiles says "1 connection needs attention" or "3 connections need attention". The noun follows the tab: join addresses on Join addresses, external servers on External servers and web proxies on Web proxies. The strip lists up to three rows, or one on a phone, each with its name, the first problem and its button. Show all and the number filters the list to all of them. The strip is hidden while any filter or search is on.
Notes are not problems
Section titled Notes are not problemsA card can carry a calm note. A note is not counted in Needs attention, and a new account opens with no red tile.
- "We are setting this up. This usually takes under a minute." A row that is pending or provisioning shows it.
- "Waiting for a certificate. This usually takes a few minutes." A web proxy shows it while its certificate is pending. The list does not call a pending certificate stuck.
- "Waiting for the DNS record at" the hostname, "We keep checking, and the join address works meanwhile." A custom domain shows it until its record is found. The join address keeps working.
A web proxy with no certificate is not a problem either. Its card says None in plain type, because going without a certificate is a choice.
Search, filter and sort
Section titled Search, filter and sortThe toolbar narrows and orders the list:
- The search box, "Search Game Shield" ("Search web proxies" on the Web proxies tab), finds a row by its name, its address, where it forwards to or its custom domain.
- The Show menu holds
All connections(All join addresses,All external serversorAll web proxieson those tabs), Active, Pending, Suspended and Needs attention, each with a count. Pending holds the rows that are pending or provisioning. Suspended includes an external server whose route we stopped. - The Sort by menu holds Name, A to Z (the default), Newest first and Problems first. Problems first puts the worst problems first, as the strip does. In the table, selecting a column heading sorts by it, and the menu then names that column.
- Clear filters appears while Show or the search is on, and turns them off.
- Cards and Table switch how the list looks, and Refresh reads the list again. Your choice of cards or table stays in your browser. A phone always shows cards and has neither control.
The search, Show, the sort and the page stay in the address, so a reload or a shared link brings them back. The address words are q, status (active, pending, suspended or attention), sort (-created_at or attention, and none for Name, A to Z) and page. ?new=join is an older link that goes on to the Create a join address page.
The list shows 24 rows a page. When there are more, page buttons appear below it. A search or filter that matches nothing says "No matches", with Reset filters. When one kind fails to load, a warning such as Could not load your external servers appears above the list, with Try again, and the rest of the list still shows. When every kind fails, the page says Could not load Game Shield.
Read a card
Section titled Read a cardA card shows the name (the address when the row has no display name) and a status badge: Active, Pending, Provisioning, Suspended, Error, Overdue or Unpaid. Under the name is the address when the name is a display name. Otherwise it reads "Join address", "External server" or "Web proxy". Under them, a line says each problem, up to two, and a note. Facts follow, the most useful first:
| Row | Facts |
|---|---|
| Join address | Edition, Forwards to (the server it forwards to, with "Hosted here", or an address), Custom domain (with Verified, DNS record pending or DNS record missing under it) and Added. |
| External server | Edition, Forwards to, Backend, Region, Custom domain, Renews and Added. Backend reads Online, Offline, Suspended or Not checked, with the players under it, such as "27 / 150 players". Hold the pointer over an offline Backend to read the text the check returned. Renews shows the date of an active server, and no price. A card shows six facts at most. |
| Web proxy | Certificate (Active with "Expires" and the date, Pending, Failed, Expired or None), Origin (Not set in amber, or the address with "Encrypted connection to your server" or "Unencrypted connection to your server" under it), Protection (the badges Web application firewall or Firewall off, HTTPS and Development mode) and Added. |
The footer of a card holds these controls:
- A button for each problem, two at most, such as Contact support, Open connection, Check custom domain, Open invoices, Open SSL or Set origin.
- Copy address for a join address. Test connection for an external server that is active and not suspended: it checks your server and says that it answered, and how fast, or "We got no answer from" its address. Open settings for a web proxy, which opens its website's tab.
- The ... menu, named "More actions for" and the name. For a join address it opens Overview, Server list and Custom domain, and Open server for a server hosted here. For an external server it opens Overview, Connection, Server list, Custom domain and Billing. An external server's menu then offers Copy join address and Copy backend address. Both menus offer Check custom domain now when a custom domain is linked. For a web proxy it opens Origin, Rules and SSL/TLS, then Request certificate (unless a certificate is active or being issued), Copy domain and Open site, which opens the site in a new tab.
Test connection, Check custom domain now and Request certificate do what the same buttons do inside the row, and a message says what came back. When you press one too often, the message reads "That was asked too many times in a row. Try again in a minute." Nothing on a card deletes, turns on or turns off a row.
Read the table
Section titled Read the tableTable shows one row for each entry, with columns that depend on the tab:
| Tab | Columns |
|---|---|
| All | Address, Type (Java, Bedrock, TCP or Web), Forwards to, Health, Status and Created. |
| Join addresses, External servers | Join address, Edition, Forwards to, Server list, Backend and Status. |
| Web proxies | Domain, Origin, Certificate, Protection, Status and Created. |
The Status column shows the badge with the first problem's short label under it, such as Suspended, Error, Not answering, DNS record missing, Payment overdue, Certificate failed or No origin. A narrow window hides Created. Select a row to open it. Select a heading to sort by it.
Web proxies
Section titled Web proxiesThe Web proxies tab has its own tiles, and the strip and the toolbar work as above:
- Web proxies counts the web proxies, with the number of websites they are on in its footer, such as "On 2 websites", or "Not on a website yet". Selecting it clears every filter.
- Certificate active counts the web proxies with an active certificate, as a fact. Its footer reads "of" and the number of web proxies, such as "of 10 web proxies".
- Needs attention counts the web proxies with a failed or expired certificate or no origin. Its footer reads "Certificates and origins".
- Web application firewall counts the web proxies with the firewall on, as a fact. Its footer reads "of" and the number of web proxies.
A web proxy opens on its website's tab, with that hostname chosen (Manage a website's origin). The list reads up to 200 web proxies. When you have more, a line under the toolbar says "Showing the first 200 of 312 web proxies. Find the others on their website's page in Domain Management."
Your first connection
Section titled Your first connectionWhile a tab has nothing to list, it shows a starter page. All says No join addresses or external servers yet, with a card for Create a join address and one for Connect an external server. Join addresses says No join addresses yet, and External servers says No external servers yet, each with its own card. Web proxies says No web proxies yet, with Open Domain Management. An account with nothing at all sees the cards of All on any game tab.
What you can do
Section titled What you can doWeb proxies:
- Create a web proxy on a website's Origin tab
- Change a web proxy's origin
- Redirect requests with rules
- Customise the error page
- Change a web proxy's settings: the WAF, HTTPS, caching and development mode
Game servers:
- Create a join address for a server hosted here
- Customise the server list entry that players see in their game
- Use your own domain for a join address
- Connect a server you host elsewhere, and manage its plan
Names and problems:
A web proxy's settings are the website's tabs (Manage a website's origin). A web proxy whose domain no website holds keeps its own page under Web proxies.
How Edge Proxy is billed
Section titled How Edge Proxy is billedWeb 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).
Limits and availability
Section titled Limits and availability- A hostname has one web proxy across all of Coritan, and a name under
coritan.ggbelongs 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).
- 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 its button.
- The list shows 24 rows a page, and reads up to 200 web proxies.