Nest Wiki - Recent changes [en]

Frequently Asked Questions

Admin — Mon, 08 Jun 2026 14:29:30 GMT

grammatical errors

← Older revision		Revision as of 14:29, 8 June 2026
(2 intermediate revisions by the same user not shown)
Line 2:		Line 2:
	Nest is a free Linux hosting service provided by [https://hackclub.com Hack Club] for teenagers to host their apps and projects for free. You can host websites, Discord bots, really anything that doesn't go against the [[Acceptable Use Policy]]! Everyone gets 2 cores, 2 GB memory and 16 GB storage by default; you can request more [https://nest.fillout.com/resources here].		Nest is a free Linux hosting service provided by [https://hackclub.com Hack Club] for teenagers to host their apps and projects for free. You can host websites, Discord bots, really anything that doesn't go against the [[Acceptable Use Policy]]! Everyone gets 2 cores, 2 GB memory and 16 GB storage by default; you can request more [https://nest.fillout.com/resources here].

	==== '''How can I get started?''' ====		==== '''How can I get started? What is an SSH pubkey?''' ====
	Visit the [[Quickstart]] Guide!		Visit the [[Quickstart]] Guide!

			==== '''Why did I just get an "unauthorized" error whenever I tried to submit in Nest?''' ====
			This is just a bug! Reload the page and it should work.

	==== '''What OS should I choose?''' ====		==== '''What OS should I choose?''' ====
Line 17:		Line 20:
	Read our guide on [[Using PM2]] and [[Using Systemd]]!		Read our guide on [[Using PM2]] and [[Using Systemd]]!

	'''How can i complain about the nest admins?'''		==== '''How can i complain about the nest admins?''' ====

	Please send an email to root [at] hackclub [dot] app		Please send an email to root [at] hackclub [dot] app

Dashboard

Admin — Mon, 01 Jun 2026 22:49:45 GMT

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 ===

Frequently Asked Questions

Admin — Mon, 01 Jun 2026 22:46:32 GMT

disclaimer about nixos

← Older revision		Revision as of 22:46, 1 June 2026
Line 10:		Line 10:
	'''Debian''': The distro Ubuntu is based on; it's a bit leaner and more stable. A great pick if you're a bit more comfortable with Linux or want something a bit more optimized.		'''Debian''': The distro Ubuntu is based on; it's a bit leaner and more stable. A great pick if you're a bit more comfortable with Linux or want something a bit more optimized.

	'''NixOS''': Steep learning curve, but easier to roll back changes. Only choose this if you're familiar and want to learn Nix specifically!		'''NixOS''': Steep learning curve, but easier to roll back changes. Only choose this if you're familiar and want to learn Nix specifically! '''No support is provided by Nest for NixOS!'''

	<nowiki>*</nowiki>note that all OSes we provide are CLI (command line) as they are the best way to learn Linux!		<nowiki>*</nowiki>note that all OSes we provide are CLI (command line) as they are the best way to learn Linux!

Dashboard

Admin — Mon, 01 Jun 2026 22:45:42 GMT

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;" />

Quickstart

Admin — Mon, 01 Jun 2026 07:20:55 GMT

refine quickstart

← Older revision		Revision as of 07:20, 1 June 2026
Line 1:		Line 1:
	Before you can access your Nest container, you'll need to apply for ~~a container~~ at https://dashboard.hackclub.app. If you haven't already, you ~~will~~ be asked to verify your age through [https://auth.hackclub.com/ Hack Club Auth]. Age verification is not ~~done~~ by Nest.		Before you can access your Nest container, you'll need to apply for one at https://dashboard.hackclub.app. If you haven't already, you'll be asked to verify your age through [https://auth.hackclub.com/ Hack Club Auth]. Age verification is handled by Hack Club Auth, not by Nest itself.

	You'll be asked to pick a username, paste your public SSH key, and tell us what you'll use Nest for. Nest ~~exclusively use~~ SSH keys instead of passwords ~~since~~ they're ~~easier and~~ more secure.		You'll be asked to pick a username, paste your '''public''' SSH key, and tell us what you'll use Nest for. Nest uses SSH keys instead of passwords: they're more secure, and once set up you never type a password again.
	~~----If~~ you~~'re confused, here's how to create/find your SSH public key:~~
	1. ~~You might have already generated an SSH key! If you're unsure, use this command to check:~~

	~~Linux/MacOS~~:<~~syntaxhighlight~~>~~cat ~/.ssh/id_ed25519~~.pub</~~syntaxhighlight~~>~~Windows:<syntaxhighlight>type %userprofile%\~~.~~ssh\id_ed25519~~.~~pub</syntaxhighlight>~~		'''Important:''' only ever paste your '''public''' key (the file ending in <code>.pub</code>). Never paste your private key (the matching file with no extension). Your public key is safe to share; your private key is not and should never leave your machine.

			----
			If you're not sure how to find your public SSH key, here's how:

			'''1. Check whether you already have a key.'''

			Linux/macOS:<syntaxhighlight>cat ~/.ssh/id_ed25519.pub</syntaxhighlight>Windows (PowerShell):<syntaxhighlight>type $env:USERPROFILE\.ssh\id_ed25519.pub</syntaxhighlight>Windows (Command Prompt):<syntaxhighlight>type %USERPROFILE%\.ssh\id_ed25519.pub</syntaxhighlight>
			If it prints a long string starting with <code>ssh-ed25519</code>, you already have a key. Copy that entire line and skip to submitting it.

			If you get "No such file or directory," you might have no key, or you might have an older RSA key. Run the same command again with <code>id_rsa.pub</code> instead of <code>id_ed25519.pub</code>. If that prints a string starting with <code>ssh-rsa</code>, use it instead.

	~~If it returns a long string starting with <code>ssh-ed25519</code>, then you already have one! Just copy that entire thing!~~

	2. If ~~that command brought back "No such file or directory" or a similar issue, it means~~ you ~~don't~~ have an SSH key~~. You can generate one now by running this command:<syntaxhighlight>~~		If you have a SSH key copy it and skip step 2 and 3.
	~~ssh-keygen -t ed25519~~
	~~</syntaxhighlight>You can press enter during the prompts to use the default settings~~.

	3. ~~Now~~ you'~~ll need to copy that string of text~~. ~~Run this command to show it:~~		'''2. Generate a key (only if you don't have one).'''

	~~Linux/MacOS~~:<syntaxhighlight>		If neither command returned a key, create one:<syntaxhighlight>ssh-keygen -t ed25519</syntaxhighlight>
	~~cat ~/.~~ssh~~/id_ed25519.pub~~		You can press Enter at each prompt to accept the defaults (this creates the key with no passphrase). Adding a passphrase when prompted is optional but more secure, since it protects the key if your machine is ever compromised.
	</syntaxhighlight>~~Windows:<syntaxhighlight>type %userprofile%\~~.~~ssh\id_ed25519~~.~~pub</syntaxhighlight>~~

			'''3. Display your public key so you can copy it.'''

			Linux/macOS:<syntaxhighlight>cat ~/.ssh/id_ed25519.pub</syntaxhighlight>Windows (PowerShell):<syntaxhighlight>type $env:USERPROFILE\.ssh\id_ed25519.pub</syntaxhighlight>Windows (Command Prompt):<syntaxhighlight>type %USERPROFILE%\.ssh\id_ed25519.pub</syntaxhighlight>
			Copy the entire line starting with <code>ssh-ed25519</code> and paste it into the application.

	~~It should return a long string starting with <code>ssh-ed25519</code>, just copy that entire thing!~~
	----		----
			Once submitted, your application may take up to 72 hours for an admin to review. You'll be notified whether it's approved or rejected. If it's rejected, you can should ask an admin in #nest-help on Slack.

	Once ~~submitted~~, ~~your application might take up to 72 hours for an admin to review, approve, or reject your application.~~		Once approved, SSH into your container with (replace <code>username</code>):<syntaxhighlight>ssh username@hackclub.app</syntaxhighlight>
			The first time you connect, you'll see a message about the host's authenticity and a prompt asking whether to continue. Type <code>yes</code> and press Enter. You'll only be asked this once.
	~~Once your application has been accepted you can~~ SSH into your ~~new~~ container ~~using this command:~~ (replace username)<syntaxhighlight>ssh username@hackclub.app</syntaxhighlight>

			If you instead get <code>Permission denied (publickey)</code>, the key you submitted probably doesn't match the one on your machine, or your SSH agent isn't using it. Check that the public key in the dashboard matches the output of the <code>cat</code>/<code>type</code> command above.

	Congratulations~~! You~~'re now inside your ~~new~~ Nest container~~! Now you~~ can start hosting your projects.		Congratulations, you're now inside your Nest container and can start hosting your projects.

	You can also manage your container at https://dashboard.hackclub.app! If you're ~~confused~~ about the dashboard, read the [[Dashboard]] guide!		You can also manage your container at https://dashboard.hackclub.app. If you're unsure about the dashboard, read the [[Dashboard]] guide.

Your data on nest

Admin — Sat, 30 May 2026 13:55:15 GMT

Admin set 51 as the approved revision for "Your data on nest"

Using PM2

Admin — Sat, 30 May 2026 13:55:10 GMT

Admin set 45 as the approved revision for "Using PM2"

Limitations

Admin — Sat, 30 May 2026 13:55:03 GMT

Admin set 70 as the approved revision for "Limitations"

Dashboard

Admin — Sat, 30 May 2026 13:54:55 GMT

Admin set 86 as the approved revision for "Dashboard"

IPv6 vs IPv4

Admin — Sat, 30 May 2026 13:54:20 GMT

Admin set 89 as the approved revision for "IPv6 vs IPv4"

IPv6 vs IPv4

U083H6XP1H6 — Sat, 30 May 2026 13:48:43 GMT

← Older revision		Revision as of 13:48, 30 May 2026
Line 4:		Line 4:

	You can view your public IPv6 on the dashboard.		You can view your public IPv6 on the dashboard.

			==== What if i need a public IPv4? ====
			You can currently purchase a dedicated IPv4 address on the [https://macondo.hackclub.com Macondo] shop for 200 gold per 6 month period, with options for up to 3 years.

	==== IPv6 Support ====		==== IPv6 Support ====
	Currently, IPv6 support worldwide sits at around 45%, to test if you can use IPv6 you can use https://test-ipv6.com/.		Currently, IPv6 support worldwide sits at around 45%, to test if you can use IPv6 you can use https://test-ipv6.com/.

	~~==== IPv4 Support ====~~
	~~You can currently purchase one (1) dedicated IPv4 on the Macondo shop for up to three years.~~

	==== Binding to IPv6 ====		==== Binding to IPv6 ====
	To bind to IPv6, you need to use <code>::</code> instead of <code>0.0.0.0</code>, <code>::</code> will bind to all interfaces, including IPv4. You can then access your service with <code>[ipv6]:port</code> for example <code>[2a01:4f9:3081:399c::1]:8080</code>. And if you want to point a domain at your ipv6 you can do so with a AAAA record.		To bind to IPv6, you need to use <code>::</code> instead of <code>0.0.0.0</code>, <code>::</code> will bind to all interfaces, including IPv4. You can then access your service with <code>[ipv6]:port</code> for example <code>[2a01:4f9:3081:399c::1]:8080</code>. And if you want to point a domain at your ipv6 you can do so with a AAAA record.

IPv6 vs IPv4

Admin — Sat, 30 May 2026 13:41:56 GMT

← Older revision		Revision as of 13:41, 30 May 2026
Line 7:		Line 7:
	==== IPv6 Support ====		==== IPv6 Support ====
	Currently, IPv6 support worldwide sits at around 45%, to test if you can use IPv6 you can use https://test-ipv6.com/.		Currently, IPv6 support worldwide sits at around 45%, to test if you can use IPv6 you can use https://test-ipv6.com/.

			==== IPv4 Support ====
			You can currently purchase one (1) dedicated IPv4 on the Macondo shop for up to three years.

	==== Binding to IPv6 ====		==== Binding to IPv6 ====
	To bind to IPv6, you need to use <code>::</code> instead of <code>0.0.0.0</code>, <code>::</code> will bind to all interfaces, including IPv4. You can then access your service with <code>[ipv6]:port</code> for example <code>[2a01:4f9:3081:399c::1]:8080</code>. And if you want to point a domain at your ipv6 you can do so with a AAAA record.		To bind to IPv6, you need to use <code>::</code> instead of <code>0.0.0.0</code>, <code>::</code> will bind to all interfaces, including IPv4. You can then access your service with <code>[ipv6]:port</code> for example <code>[2a01:4f9:3081:399c::1]:8080</code>. And if you want to point a domain at your ipv6 you can do so with a AAAA record.

User:U096NGLTF4K

U096NGLTF4K — Sat, 30 May 2026 07:48:39 GMT

create page

New page

oh hi, its lachlan

Dashboard

Admin — Thu, 28 May 2026 14:38:26 GMT

← 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;" />

Quickstart

Admin — Thu, 28 May 2026 14:36:58 GMT

← Older revision		Revision as of 14:36, 28 May 2026
Line 31:		Line 31:
	Congratulations! You're now inside your new Nest container! Now you can start hosting your projects.		Congratulations! You're now inside your new Nest container! Now you can start hosting your projects.

	You can also manage your container at https://dashboard.hackclub.app!		You can also manage your container at https://dashboard.hackclub.app! If you're confused about the dashboard, read the [[Dashboard]] guide!

Main Page

Admin — Thu, 28 May 2026 14:35:56 GMT

← Older revision		Revision as of 14:35, 28 May 2026
Line 4:		Line 4:
	To get started, check out the [[Quickstart]] guide, which walks you through creating an account, verifying that you are a student, logging in, and basic usage of Nest. '''Please read the [[Acceptable Use Policy]] and [[Limitations]] page before using Nest.''' You can also review our [[Nest Wiki:Privacy policy\|privacy policy]] and [[Your data on nest\|what happens to your data on Nest]]. There's also a list of [[Frequently Asked Questions]] that you really should read.		To get started, check out the [[Quickstart]] guide, which walks you through creating an account, verifying that you are a student, logging in, and basic usage of Nest. '''Please read the [[Acceptable Use Policy]] and [[Limitations]] page before using Nest.''' You can also review our [[Nest Wiki:Privacy policy\|privacy policy]] and [[Your data on nest\|what happens to your data on Nest]]. There's also a list of [[Frequently Asked Questions]] that you really should read.

	===== Nest Services: =====		=== How to Use Nest Services: ===

	* [[Dashboard]]		* [[Dashboard]]
	* [[Forgejo]]		* [[Forgejo]]

	===== Tool Guides: =====		=== Tool Guides: ===

	* [[Using PM2\|PM2]]		* [[Using PM2\|PM2]]
	* [[Systemd]]		* [[Systemd]]
Line 16:		Line 14:
	* more coming soon...		* more coming soon...

	===== Important Concepts: =====		=== Important Concepts: ===

	* [[IPv6 vs IPv4]]		* [[IPv6 vs IPv4]]

Frequently Asked Questions

Admin — Thu, 28 May 2026 14:34:45 GMT

← Older revision		Revision as of 14:34, 28 May 2026
Line 1:		Line 1:
	'''What is Nest? What do I get?'''		==== '''What is Nest? What do I get?''' ====

	Nest is a free Linux hosting service provided by [https://hackclub.com Hack Club] for teenagers to host their apps and projects for free. You can host websites, Discord bots, really anything that doesn't go against the [[Acceptable Use Policy]]! Everyone gets 2 cores, 2 GB memory and 16 GB storage by default; you can request more [https://nest.fillout.com/resources here].		Nest is a free Linux hosting service provided by [https://hackclub.com Hack Club] for teenagers to host their apps and projects for free. You can host websites, Discord bots, really anything that doesn't go against the [[Acceptable Use Policy]]! Everyone gets 2 cores, 2 GB memory and 16 GB storage by default; you can request more [https://nest.fillout.com/resources here].

			==== '''How can I get started?''' ====
	'''How can I get started?'''

	Visit the [[Quickstart]] Guide!		Visit the [[Quickstart]] Guide!

	'''What OS should I choose?'''		==== '''What OS should I choose?''' ====

	'''Ubuntu''': If you're unsure, pick Ubuntu! It has one of the easier learning curves and has the most support and beginner resources.		'''Ubuntu''': If you're unsure, pick Ubuntu! It has one of the easier learning curves and has the most support and beginner resources.

Line 18:		Line 14:
	<nowiki>*</nowiki>note that all OSes we provide are CLI (command line) as they are the best way to learn Linux!		<nowiki>*</nowiki>note that all OSes we provide are CLI (command line) as they are the best way to learn Linux!

			==== '''How can i make my services run in the background?''' ====
	'''How can i make my services run in the background?'''

	Read our guide on [[Using PM2]] and [[Using Systemd]]!		Read our guide on [[Using PM2]] and [[Using Systemd]]!

Line 27:		Line 21:
	Please send an email to root [at] hackclub [dot] app		Please send an email to root [at] hackclub [dot] app

			==== '''Is nest down?''' ====
			Stop saying nest is broken or "nest is down". You're going to need to actually say what you're having issues with. If you're using SSH, use <code>ssh -vvv username@hackcub.app</code> and put those logs there. If you can't access USERNAME.hackclub.app? Say that, give the (sub)domain, and give logs. If [https://status.hackclub.app/ https://status.hackclub.app/status/nest] says Nest is down, then we already know.

	~~'''Is nest down?'''~~		==== '''Can i host ___?''' ====

	Stop saying nest is broken or "nest is down". You're going to need to actually say what you're having issues with. If you're using SSH, use <code>ssh -vvv username@hackcub.app</code> and put those logs there. If you can't access USERNAME.hackclub.app? Say that, give the (sub)domain and give logs. https://status.hackclub.app/status/nest says nest is down? We already know.


	'''Can i host ___?'''

	As long as it's not abusive and not against [[Acceptable Use Policy\|the acceptable use policy]] then yes.		As long as it's not abusive and not against [[Acceptable Use Policy\|the acceptable use policy]] then yes.

			==== '''Do i get my own IP?''' ====
	'''Do i get my own IP?'''

	You do not get your own public IPv4, but you do get a public IPv6. We have a reverse proxy which you can use to proxy your websites without needing your own dedicated IP.		You do not get your own public IPv4, but you do get a public IPv6. We have a reverse proxy which you can use to proxy your websites without needing your own dedicated IP.

			==== '''Is there a limit to the number of ports that can be opened?''' '''Are any ports blocked?''' ====
	'''Is there a limit to the number of ports that can be opened?''' '''Are any ports blocked?'''

	65535 is the limit for ports, and port 25 is blocked to prevent malicious email spam.		65535 is the limit for ports, and port 25 is blocked to prevent malicious email spam.

			==== '''Can i portscan on nest?''' ====
	'''Can i portscan on nest?'''

	No, you will be banned.		No, you will be banned.

			==== '''Why is ID verification taking so long?''' ====
	'''Why is ID verification taking so long?'''		We do not know; it's not in our control. ID verification is done by [https://auth.hackclub.com HCA].

	We do not know, it's not in our control. ID verification is done by [https://auth.hackclub.com HCA].

Main Page

Admin — Thu, 28 May 2026 14:31:56 GMT

← Older revision		Revision as of 14:31, 28 May 2026
Line 6:		Line 6:
	===== Nest Services: =====		===== Nest Services: =====

	* [[Dashboard]] ~~(in progress)~~		* [[Dashboard]]
	* [[Forgejo]]		* [[Forgejo]]

Dashboard

Admin — Thu, 28 May 2026 09:40:27 GMT

final i think??

← Older revision		Revision as of 09:40, 28 May 2026
(One intermediate revision by the same user not shown)
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 27:		Line 25:
	<br style="clear:both;" />		<br style="clear:both;" />

			=== 3. SSH Keys ===
			[[File:Example SSH Keys Page.png\|right\|thumb\|500px]]
			Your SSH key is your only way into your container; you should always have at least one added!

	~~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 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;" />
	~~[[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 ===
			[[File:Nest-Backups.png\|right\|thumb\|500px]]
			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.

	4. ~~Backups~~		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;" />

File:Nest-Backups.png

Admin — Thu, 28 May 2026 09:31:18 GMT

Admin uploaded File:Nest-Backups.png

New page

backups page

File:Nest-Backups.png

Admin — Thu, 28 May 2026 09:31:18 GMT

Admin set the upload from Thu, 28 May 2026 09:31:18 GMT as the approved revision for "File:Nest-Backups.png"

Dashboard

Admin — Thu, 28 May 2026 09:28:01 GMT

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

File:Example Backups Screenshot.png

Admin — Thu, 28 May 2026 09:25:53 GMT

Admin uploaded File:Example Backups Screenshot.png

New page

stop reading my image descriptions -colton, 2026

File:Example Backups Screenshot.png

Admin — Thu, 28 May 2026 09:25:53 GMT

Admin set the upload from Thu, 28 May 2026 09:25:53 GMT as the approved revision for "File:Example Backups Screenshot.png"

File:Example SSH Keys Page.png

Admin — Thu, 28 May 2026 09:14:50 GMT

Admin uploaded File:Example SSH Keys Page.png

New page

its a screenshot! -colton, 2026

File:Example SSH Keys Page.png

Admin — Thu, 28 May 2026 09:14:50 GMT

Admin set the upload from Thu, 28 May 2026 09:14:50 GMT as the approved revision for "File:Example SSH Keys Page.png"

Dashboard

Admin — Thu, 28 May 2026 09:07:18 GMT

← Older revision		Revision as of 09:07, 28 May 2026
(One intermediate revision by the same user not shown)
Line 1:		Line 1:
	This guide is 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 ===
	[[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!
			<br style="clear:both;" />

	=== 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.
			<br style="clear:both;" />

	~~# 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!		<br style="clear:both;" />

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

Frequently Asked Questions

Admin — Thu, 28 May 2026 09:00:56 GMT

← Older revision		Revision as of 09:00, 28 May 2026
Line 7:		Line 7:

	Visit the [[Quickstart]] Guide!		Visit the [[Quickstart]] Guide!

			'''What OS should I choose?'''

			'''Ubuntu''': If you're unsure, pick Ubuntu! It has one of the easier learning curves and has the most support and beginner resources.

			'''Debian''': The distro Ubuntu is based on; it's a bit leaner and more stable. A great pick if you're a bit more comfortable with Linux or want something a bit more optimized.

			'''NixOS''': Steep learning curve, but easier to roll back changes. Only choose this if you're familiar and want to learn Nix specifically!

			<nowiki>*</nowiki>note that all OSes we provide are CLI (command line) as they are the best way to learn Linux!

Main Page

Admin — Thu, 28 May 2026 08:46:00 GMT

Important Concepts:

← Older revision		Revision as of 08:46, 28 May 2026
(One intermediate revision by the same user not shown)
(No difference)

Limitations

U0A546Y17DK — Sun, 24 May 2026 19:18:01 GMT

← Older revision		Revision as of 19:18, 24 May 2026
Line 3:		Line 3:
	* you cannot mount a SMB, CIFS or NFS share		* you cannot mount a SMB, CIFS or NFS share
	* you do not get a public ipv4 (but we have a reverse proxy for http(s)), only a public ipv6		* you do not get a public ipv4 (but we have a reverse proxy for http(s)), only a public ipv6
	* containers have 2 cores, 2GB memory and 16GB storage by default, but you can ~~report~~ more [https://forms.hackclub.com/nest-resources here]		* containers have 2 cores, 2GB memory and 16GB storage by default, but you can request more [https://forms.hackclub.com/nest-resources here]
	* nest cannot guarantee an SLA, but we are working as hard as we can to keep the uptime as close to 100% as possible		* nest cannot guarantee an SLA, but we are working as hard as we can to keep the uptime as close to 100% as possible
	* access to /dev/net/tun (required for some things like wireguard) is disabled by default, but might be granted on request		* access to /dev/net/tun (required for some things like wireguard) is disabled by default, but might be granted on request

Main Page

Admin — Fri, 22 May 2026 05:38:06 GMT

fixed Nest status link

← Older revision		Revision as of 05:38, 22 May 2026
(One intermediate revision by the same user not shown)
Line 6:		Line 6:
	===== Nest Services: =====		===== Nest Services: =====

	* [[Dashboard]]		* [[Dashboard]] (in progress)
	* [[Forgejo]]		* [[Forgejo]]

Line 28:		Line 28:
	Forgejo: https://git.hackclub.app		Forgejo: https://git.hackclub.app

	Nest Status: https://status.hackclub.app/~~status/nest~~		Nest Status: https://status.hackclub.app/

Dashboard

Admin — Fri, 22 May 2026 05:11:18 GMT

Added disclaimer about progress

← Older revision		Revision as of 05:11, 22 May 2026
(3 intermediate revisions by the same user not shown)
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]]
	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 ~~server~~. 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 ===		=== 2. Domains/Reverse Proxy ===
	~~[[File:Nest-Domains.png\|left\|thumb\|708x708px]]~~
	~~Welcome to the domains tab! This allows you to reverse proxy your~~
	[[File:Example-Cloudflare-CNAME.png\|left\|thumb\|708x708px]]		[[File:Example-Cloudflare-CNAME.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).

			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.

			[[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!

Dashboard

Admin — Thu, 21 May 2026 19:38:09 GMT

Created Using Dashboard guide!

New page

=== 1. Dashboard ===
[[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 server. 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:Nest-Domains.png|left|thumb|708x708px]]
Welcome to the domains tab! This allows you to reverse proxy your
[[File:Example-Cloudflare-CNAME.png|left|thumb|708x708px]]

File:Example-Cloudflare-CNAME.png

Admin — Thu, 21 May 2026 19:37:06 GMT

Admin deleted page File:Example-Cloudflare-CNAME.png Deleted old revision 20260521193610!Example-Cloudflare-CNAME.png: Doxxed a nest admin's container username