Add instructions on how to fix errors when downloading tarballs (#12)

Reviewed-on: auxolotl/foundation#12
Reviewed-by: Ruby Iris Juric <ruby+auxolotl@srxl.me>
Reviewed-by: Jake Hamilton <jake.hamilton@hey.com>
Co-authored-by: 5225225 <5225225@mailbox.org>
Co-committed-by: 5225225 <5225225@mailbox.org>
This commit is contained in:
5225225 2025-10-04 20:08:59 +00:00 committed by Jake Hamilton
parent f39cac8cae
commit deb8e03cb2

View file

@ -29,6 +29,50 @@ in
# ...
```
### Bypassing Geoblocking
If you get an error(possibly with different hashes) such as
```
error: hash mismatch in file downloaded from 'https://repo.or.cz/tinycc.git/snapshot/fd6d2180c5c801bb0b4c5dde27d61503059fc97d.tar.gz':
specified: sha256-R81SNbEmh4s9FNQxCWZwUiMCYRkkwOHAdRf0aMnnRiA=
got: sha256-YFl5pQIdfJAn4ijH1UU8OY+DRtJ0LPd5r0eoIF8iyMI=
```
and you're in the UK, you will need to manually add the tinycc revisions to the store, because of
Online Safety Act-caused geoblocking.
If you have [Tor](https://www.torproject.org/) running, you can use it as a proxy with the below
script to manually add the items to your nix store.
```
curl --proxy socks5://localhost:9050 -LO https://repo.or.cz/tinycc.git/snapshot/86f3d8e33105435946383aee52487b5ddf918140.tar.gz
curl --proxy socks5://localhost:9050 -LO https://repo.or.cz/tinycc.git/snapshot/fd6d2180c5c801bb0b4c5dde27d61503059fc97d.tar.gz
nix-store --add-fixed sha256 86f3d8e33105435946383aee52487b5ddf918140.tar.gz
nix-store --add-fixed sha256 fd6d2180c5c801bb0b4c5dde27d61503059fc97d.tar.gz
```
Alternatively, use a VPN or some other form of proxy to download the files
* <https://repo.or.cz/tinycc.git/snapshot/86f3d8e33105435946383aee52487b5ddf918140.tar.gz>
* <https://repo.or.cz/tinycc.git/snapshot/fd6d2180c5c801bb0b4c5dde27d61503059fc97d.tar.gz>
and add them to your nix store as shown above.
This will fix the build until a garbage collection run.
### `ftpmirror.gnu.org` HTTP errors
If you get an error such as
`error: unable to download 'https://ftpmirror.gnu.org/gnu/gmp/gmp-6.3.0.tar.xz': HTTP error 403
(Forbidden)`
or any other HTTP error, try re-running the build. Some of the mirrors in the `ftpmirror.gnu.org`
pool may be flaky, and retrying will get a different mirror chosen. Once it's downloaded, it will
be cached in your nix store, so you won't run into the issue again until a garbage collection run.
## Development
This foundational package set is created using modules. Each builder and package is separated