Dashboard: Difference between revisions

Revision as of 21:09, 21 May 2026

1. Dashboard

Welcome to the Dashboard tab! Here, you'll find important information about your container, like IP addresses, status, hostnames, and controls to stop, reboot, and delete your container.

Stop/Reboot controls are especially helpful if a process gets hung or your container runs out of memory.

Do not click delete container unless you want to permanently wipe your container. This operation cannot be undone and you will have to reapply for a new container. If your container is broken, try restoring from a backup first!

2. Domains/Reverse Proxy

The Domains tab allows you to reverse proxy whatever you're hosting in your Nest container, making it accessible to the public internet! To start, make sure your program is listening to all addresses on a certain port (e.g., 3000 or 8080).

Go to your domain's DNS settings page and do the following:

Create a CNAME record. If you want it to be a subdomain, add a name, otherwise use `@` to leave it as root.
Make sure the target is set to your Nest address (your-username.hackclub.app).
Double-check that the proxy setting is off / set to DNS only.
Save it! Note that other DNS providers might handle CNAME creation differently, and the Cloudflare screenshot is for illustrative purposes only.

Now, head back over to your Nest dashboard's Domains tab, and add the domain! In this example, it's birdie.mycooldomain.com. In the target port box, include the port your project is running on (in this case, port 8080). Then, click Add Domain!

DNS changes like the ones we just made can take up to 48 hours to propagate depending on the provider, so please be patient!

@@ Line 2: / Line 2: @@
 [[File:Nest-Dashboard.png|left|thumb|708x708px]]
 Welcome to the Dashboard tab! Here, you'll find important information about your container, like IP addresses, status, hostnames, and controls to stop, reboot, and delete your container.
 '''Stop/Reboot controls''' are especially helpful if a process gets hung or your container runs out of memory.
+'''Do not click delete container''' unless you want to permanently wipe your container. This operation cannot be undone and you will have to reapply for a new container. If your container is broken, try restoring from a backup first!
-'''Do not click delete container''' unless you want to permanently wipe your container. This operation cannnot be undone and you will have to reapply for a new container. If your container is messed up, first consider a backup.
 === 2. Domains/Reverse Proxy ===
-[[File:Example-Cloudflare-CNAME.png|left|thumb|708x708px|Cloudflare DNS page included for illustrative purposes only.]]
+[[File:Example-Cloudflare-CNAME.png|left|thumb|708x708px]]
-[[File:Nest-Domains.png|left|thumb|708x708px]]
+The Domains tab allows you to reverse proxy whatever you're hosting in your Nest container, making it accessible to the public internet! To start, make sure your program is listening to all addresses on a certain port (e.g., 3000 or 8080).
-Welcome to the domains tab! This allows you to reverse proxy whatever you're hosting in your Nest container and put it on a public IP!
-To start, make sure your program is listening to all addresses on a certain port (e.g. 3000 or 8080). Then, go to your domain's DNS page and add a CNAME (canonical name) record. In this case, we want our project to be located at birdie.mycooldomain.com, so we would add birdie in the name since we don't just want the root domain.
+Go to your domain's DNS settings page and do the following:
-Make sure the target is set to your hackclub.app subdomain (your-username.hackclub.app) and that proxy status, if included, is set to DNS only. Then save it! Note that other DNS providers might handle CNAME creation differently.
+# Create a CNAME record. If you want it to be a subdomain, add a name, otherwise use `@` to leave it as root.
+# Make sure the target is set to your Nest address ('''your-username.hackclub.app''').
+# Double-check that the proxy setting is off / set to '''DNS only'''.
+# Save it! Note that other DNS providers might handle CNAME creation differently, and the Cloudflare screenshot is for illustrative purposes only.
-Now, head back over to your Nest dashboard's domains tab, and add the domain! In this example, it's birdie.mycooldomain.com. In the target port box, include the port your project is running on (in this case, port 8080). Then, click add domain!
+[[File:Nest-Domains.png|left|thumb|627x627px]]
+Now, head back over to your Nest dashboard's Domains tab, and add the domain! In this example, it's birdie.mycooldomain.com. In the target port box, include the port your project is running on (in this case, port 8080). Then, click Add Domain!
 DNS changes like the ones we just made can take up to 48 hours to propagate depending on the provider, so please be patient!