Differences

This shows you the differences between two versions of the page.

--- manuals:distributions:nixos [2026/03/12 09:54] – flakes aither
+++ manuals:distributions:nixos [2026/08/10 17:49] (current) – panika
@@ Line 18: / Line 18: @@
 You can log in using a [[manuals:vps:management#root_password|generated password]]
 or [[manuals:vps:management#ssh_public_keys|deploy your public key]] using vpsAdmin.
-The system can then be configured using ''nixos-rebuild --flake /etc/nixos#vps'' or any other
+The system can then be configured using :
-deployment tool.
+<code>
+nixos-rebuild switch --flake /etc/nixos#vps
+</code>
 Note that our VPS are Linux containers, so there is no boot loader, the kernel is shared
@@ Line 32: / Line 35: @@
 ===== Impermanence =====
 See [[manuals:distributions:nixos:impermanence]].
+===== GitHub API limit =====
+Nixpkgs  are downloaded from [[https://github.com/nixos/nixpkgs|GitHub]] and [[https://nixos.wiki/wiki/Binary_Cache|Binary Cache]]. GitHub does not support IPv6 and rate limits either  [[https://docs.github.com/en/rest/using-the-rest-api/rate-limits-for-the-rest-api?apiVersion=2026-03-10#primary-rate-limit-for-unauthenticated-users|per IPv4]] or [[https://docs.github.com/en/rest/using-the-rest-api/rate-limits-for-the-rest-api?apiVersion=2026-03-10#primary-rate-limit-for-authenticated-users|per user]].
+After exhausting the API limit, Nix (or rather GitHub API) complains:
+<code>
+error: unable to download 'GITHUB_URL': HTTP error 403 ('')
+       response body:
+       {"message":"API rate limit exceeded for IP_ADDR. (But here's the good news: Authenticated requests get a higher rate limit. Check out the documentation for more details.)","documentation_url":"https://docs.github.com/rest/overview/resources-in-the-rest-api#rate-limiting"}
+</code>
+The solution is to [[https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-fine-grained-personal-access-token|create personal access token]] (Public repositories, the Permissions could be blank) and enter [[https://search.nixos.org/options?channel=26.05&query=nix.settings&type=options#show=option%253Anix.settings|the configuration]] to Nix:
+<code>
+# configuration.nix
+nix.settings.access-tokens = [ "github.com=github_pat_TokenTokenChangeMe" ];
+</code>

Knowledge base

User Tools

Site Tools

Differences

Page Tools