Dashboard - Revision history

U0A55A4B21K: fixed url in the note

2026-07-12T14:09:51Z

fixed url in the note

← Older revision		Revision as of 14:09, 12 July 2026
Line 24:		Line 24:


	Note: You can also get more subdomains of *.username,hackclub.app, just enter that in the domain box and update the DNS record accordingly.<br style="clear:both;" />		Note: You can also get more subdomains of *.username.hackclub.app, just enter that in the domain box and update the DNS record accordingly.<br style="clear:both;" />

	=== 3. SSH Keys ===		=== 3. SSH Keys ===

Admin: note about more subdomains

2026-06-01T22:49:45Z

note about more subdomains

← Older revision		Revision as of 22:49, 1 June 2026
Line 17:		Line 17:
	# Make sure the proxy setting is off / set to '''DNS only'''.		# Make sure the proxy setting is off / set to '''DNS only'''.
	# Save it! Note that other DNS providers may handle this differently — the Cloudflare screenshot is for illustrative purposes only.		# Save it! Note that other DNS providers may handle this differently — the Cloudflare screenshot is for illustrative purposes only.
	~~<br style="clear:both;" />~~

	[[File:Nest-Domains.png\|right\|thumb\|500px]]		[[File:Nest-Domains.png\|right\|thumb\|500px]]
Line 23:		Line 22:

	If you get an "unauthorized" error, that's a bug and reloading usually resolves the issue. DNS changes can take up to 48 hours to propagate depending on the provider, so please be patient!		If you get an "unauthorized" error, that's a bug and reloading usually resolves the issue. DNS changes can take up to 48 hours to propagate depending on the provider, so please be patient!
	<br style="clear:both;" />

			Note: You can also get more subdomains of *.username,hackclub.app, just enter that in the domain box and update the DNS record accordingly.<br style="clear:both;" />

	=== 3. SSH Keys ===		=== 3. SSH Keys ===

Admin: disclaimer about backups

2026-06-01T22:45:42Z

disclaimer about backups

← Older revision		Revision as of 22:45, 1 June 2026
Line 36:		Line 36:
	Ever made a change that broke everything? It happens to everyone.		Ever made a change that broke everything? It happens to everyone.

	Backups let you revert your container to a previous state without having to delete it and reapply.		Backups let you revert your container to a previous state without having to delete it and reapply. You can wait for an automatic backup to occur at 9pm UTC daily, which will appear in your backup page, or backup your container manually by downloading it to your PC using a tool like WinSCP, though '''automatic backups are usually much easier'''.

	For example, clicking restore on the top backup will restore your container to its exact state at 21:43:00 on 5/17. Do note that any work done after that backup was created will be permanently lost, so use caution.<br style="clear:both;" />		For example, clicking restore on the top backup will restore your container to its exact state at 21:43:00 on 5/17. Do note that any work done after that backup was created will be permanently lost, so use caution.<br style="clear:both;" />

Admin at 14:38, 28 May 2026

2026-05-28T14:38:26Z

← Older revision		Revision as of 14:38, 28 May 2026
Line 20:		Line 20:

	[[File:Nest-Domains.png\|right\|thumb\|500px]]		[[File:Nest-Domains.png\|right\|thumb\|500px]]
	Head back to your Nest dashboard's Domains tab and add the domain — in this example, <code>birdie.mycooldomain.com</code>. Enter the port your project is running on (in this case, 8080) in the target port box, then click '''Add Domain'''!		Head back to your Nest dashboard's Domains tab and add the domain — in this example, <code>birdie.mycooldomain.com</code>. Enter the port your project is running on (in this case, 8080) in the target port box, then click '''Add Domain'''!

	DNS changes can take up to 48 hours to propagate depending on the provider, so please be patient!		If you get an "unauthorized" error, that's a bug and reloading usually resolves the issue. DNS changes can take up to 48 hours to propagate depending on the provider, so please be patient!
	<br style="clear:both;" />		<br style="clear:both;" />

Admin: final i think??

2026-05-28T09:40:27Z

final i think??

← Older revision		Revision as of 09:40, 28 May 2026
Line 1:		Line 1:
	~~<div style="background:#fff3cd; border:1px solid #ffc107; padding:10px; margin-bottom:16px;">⚠️ This guide is still in progress!</div>~~

	=== 1. Dashboard ===		=== 1. Dashboard ===
	[[File:Nest-Dashboard.png\|right\|thumb\|500px]]		[[File:Nest-Dashboard.png\|right\|thumb\|500px]]
Line 7:		Line 5:
	'''Stop/Reboot controls''' are especially helpful if a process gets hung or your container runs out of memory.		'''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 cannot be undone and you will have to reapply for a container. If your container is broken, try restoring from a backup first!
	<br style="clear:both;" />		<br style="clear:both;" />

Line 29:		Line 27:
	=== 3. SSH Keys ===		=== 3. SSH Keys ===
	[[File:Example SSH Keys Page.png\|right\|thumb\|500px]]		[[File:Example SSH Keys Page.png\|right\|thumb\|500px]]
	~~If you've gotten this far, you should have at least one~~ SSH key ~~on your dashboard — it's~~ your only way into your container!		Your SSH key is your only way into your container; you should always have at least one added!

	If you ever switch computers, that key does not transfer over. While it is possible to copy an SSH key between machines, it's '''not''' recommended. Instead, generate a new SSH key on each ~~computer~~ you want to ~~use~~ and add it to your dashboard. The [[quickstart]] has command-by-command instructions if you need help!		If you ever switch computers, that key does not transfer over. While it is possible to copy an SSH key between machines, it's '''not''' recommended. Instead, generate a new SSH key on each device you want to SSH in from, and add it to your dashboard. The [[quickstart]] has command-by-command instructions if you need help!
	<br style="clear:both;" />		<br style="clear:both;" />

	=== 4. Backups ===		=== 4. Backups ===
	[[File:Nest-Backups.png\|right\|thumb\|500px]]		[[File:Nest-Backups.png\|right\|thumb\|500px]]
	Ever made a change that broke everything? It happens to ~~the best of us! Backups let you revert your container to a previous state without having to delete it and reapply~~.		Ever made a change that broke everything? It happens to everyone.

	For example, clicking restore on the top backup will restore your container to its exact state at 21:43:00 on 5/17. Do note that any work done after that backup was created will be lost, so ~~restore with care!~~		Backups let you revert your container to a previous state without having to delete it and reapply.
	<br style="clear:both;" />
			For example, clicking restore on the top backup will restore your container to its exact state at 21:43:00 on 5/17. Do note that any work done after that backup was created will be permanently lost, so use caution.<br style="clear:both;" />

Admin at 09:34, 28 May 2026

2026-05-28T09:34:12Z

← Older revision		Revision as of 09:34, 28 May 2026
Line 27:		Line 27:
	<br style="clear:both;" />		<br style="clear:both;" />

			=== 3. SSH Keys ===
			[[File:Example SSH Keys Page.png\|right\|thumb\|500px]]
			If you've gotten this far, you should have at least one SSH key on your dashboard — it's your only way into your container!

	3. SSH ~~Keys~~		If you ever switch computers, that key does not transfer over. While it is possible to copy an SSH key between machines, it's '''not''' recommended. Instead, generate a new SSH key on each computer you want to use and add it to your dashboard. The [[quickstart]] has command-by-command instructions if you need help!
			<br style="clear:both;" />

	[[File:~~Example SSH Keys Page~~.png\|thumb\|~~494x494px~~]]		=== 4. Backups ===
	~~If you've gotten this far, we would hope~~ that you ~~are sitting on the dashboard right now with at least 1 SSH key in there; it's your only way into~~ your container!		[[File:Nest-Backups.png\|right\|thumb\|500px]]
			Ever made a change that broke everything? It happens to the best of us! Backups let you revert your container to a previous state without having to delete it and reapply.

			For example, clicking restore on the top backup will restore your container to its exact state at 21:43:00 on 5/17. Do note that any work done after that backup was created will be lost, so restore with care!
	~~Problem is~~, ~~if you ever switch computers, that key does not transfer over! While there are methods to transfer~~ the ~~same SSH key between computers, it is '''not''' recommended. You'll want~~ to ~~create~~/~~use another SSH key for~~ any ~~other computer you want to have access to your container. The [[quickstart]] has command-by-command instructions if you need help~~!		<br style="clear:both;" />


	~~4. Backups~~

Admin: saving changes

2026-05-28T09:28:01Z

saving changes

← Older revision		Revision as of 09:28, 28 May 2026
Line 26:		Line 26:
	DNS changes can take up to 48 hours to propagate depending on the provider, so please be patient!		DNS changes can take up to 48 hours to propagate depending on the provider, so please be patient!
	<br style="clear:both;" />		<br style="clear:both;" />


			3. SSH Keys

			[[File:Example SSH Keys Page.png\|thumb\|494x494px]]
			If you've gotten this far, we would hope that you are sitting on the dashboard right now with at least 1 SSH key in there; it's your only way into your container!


			Problem is, if you ever switch computers, that key does not transfer over! While there are methods to transfer the same SSH key between computers, it is '''not''' recommended. You'll want to create/use another SSH key for any other computer you want to have access to your container. The [[quickstart]] has command-by-command instructions if you need help!


			4. Backups

Admin at 09:07, 28 May 2026

2026-05-28T09:07:18Z

← Older revision		Revision as of 09:07, 28 May 2026
Line 1:		Line 1:
	~~{{warning\|~~This guide is still in progress!}}		<div style="background:#fff3cd; border:1px solid #ffc107; padding:10px; margin-bottom:16px;">⚠️ This guide is still in progress!</div>

	=== 1. Dashboard ===		=== 1. Dashboard ===
Line 8:		Line 8:

	'''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 cannot be undone and you will have to reapply for a new container. If your container is broken, try restoring from a backup first!
	{{clear}}		<br style="clear:both;" />

	=== 2. Domains/Reverse Proxy ===		=== 2. Domains/Reverse Proxy ===
Line 19:		Line 19:
	# Make sure the proxy setting is off / set to '''DNS only'''.		# Make sure the proxy setting is off / set to '''DNS only'''.
	# Save it! Note that other DNS providers may handle this differently — the Cloudflare screenshot is for illustrative purposes only.		# Save it! Note that other DNS providers may handle this differently — the Cloudflare screenshot is for illustrative purposes only.
	{{clear}}		<br style="clear:both;" />

	[[File:Nest-Domains.png\|right\|thumb\|500px]]		[[File:Nest-Domains.png\|right\|thumb\|500px]]
Line 25:		Line 25:

	DNS changes can take up to 48 hours to propagate depending on the provider, so please be patient!		DNS changes can take up to 48 hours to propagate depending on the provider, so please be patient!
	{{clear}}		<br style="clear:both;" />

Admin at 09:03, 28 May 2026

2026-05-28T09:03:46Z

← Older revision		Revision as of 09:03, 28 May 2026
Line 1:		Line 1:
	This guide is in progress!		{{warning\|This guide is still in progress!}}

	=== 1. Dashboard ===		=== 1. Dashboard ===
	[[File:Nest-Dashboard.png\|~~left~~\|thumb\|~~708x708px~~]]		[[File:Nest-Dashboard.png\|right\|thumb\|500px]]
	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.		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.		'''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 cannot be undone and you will have to reapply for a new container. If your container is broken, try restoring from a backup first!
			{{clear}}

	=== 2. Domains/Reverse Proxy ===		=== 2. Domains/Reverse Proxy ===
	[[File:Example-Cloudflare-CNAME.png\|~~left~~\|thumb\|~~708x708px~~]]		[[File:Example-Cloudflare-CNAME.png\|right\|thumb\|500px]]
	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).		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:		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 <code>@</code> to leave it as root.
			# Set the target to your Nest address ('''your-username.hackclub.app''').
			# Make sure the proxy setting is off / set to '''DNS only'''.
			# Save it! Note that other DNS providers may handle this differently — the Cloudflare screenshot is for illustrative purposes only.
			{{clear}}

	~~# Create a CNAME record. If you want it to be a subdomain, add a name, otherwise use `@` to leave it as root~~.		[[File:Nest-Domains.png\|right\|thumb\|500px]]
	~~# Make sure the target is set~~ to your Nest ~~address (~~'~~''your-username~~.~~hackclub~~.~~app''')~~.		Head back to your Nest dashboard's Domains tab and add the domain — in this example, <code>birdie.mycooldomain.com</code>. Enter the port your project is running on (in this case, 8080) in the target port box, then click '''Add Domain'''!
	~~# 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.~~

	~~[[File:Nest-Domains.png\|left\|thumb\|627x627px]]~~		DNS changes can take up to 48 hours to propagate depending on the provider, so please be patient!
	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!		{{clear}}

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

Admin: Added disclaimer about progress

2026-05-22T05:11:18Z

Added disclaimer about progress

← Older revision		Revision as of 05:11, 22 May 2026
Line 1:		Line 1:
			This guide is in progress!

	=== 1. Dashboard ===		=== 1. Dashboard ===
	[[File:Nest-Dashboard.png\|left\|thumb\|708x708px]]		[[File:Nest-Dashboard.png\|left\|thumb\|708x708px]]