{"id":42285092,"url":"https://github.com/touilleio/alephium-standalone","last_synced_at":"2026-01-27T09:05:16.439Z","repository":{"id":62314981,"uuid":"559243242","full_name":"touilleio/alephium-standalone","owner":"touilleio","description":"Standalone, fast-sync (via snapshot from https://archives.alephium.org) Alephium full node pre-configured for the mainnet","archived":false,"fork":false,"pushed_at":"2024-12-29T14:30:50.000Z","size":34,"stargazers_count":2,"open_issues_count":0,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-29T15:26:11.794Z","etag":null,"topics":["alephium","blockchain","fullnode","layer1","mainnet"],"latest_commit_sha":null,"homepage":"","language":"HCL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/touilleio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-29T14:03:56.000Z","updated_at":"2024-12-29T14:30:54.000Z","dependencies_parsed_at":"2023-02-18T15:31:22.727Z","dependency_job_id":"14ca1bd2-6cdd-442b-9b03-e0a707172aa9","html_url":"https://github.com/touilleio/alephium-standalone","commit_stats":null,"previous_names":[],"tags_count":61,"template":false,"template_full_name":null,"purl":"pkg:github/touilleio/alephium-standalone","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/touilleio%2Falephium-standalone","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/touilleio%2Falephium-standalone/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/touilleio%2Falephium-standalone/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/touilleio%2Falephium-standalone/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/touilleio","download_url":"https://codeload.github.com/touilleio/alephium-standalone/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/touilleio%2Falephium-standalone/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28810468,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T07:41:26.337Z","status":"ssl_error","status_checked_at":"2026-01-27T07:41:08.776Z","response_time":168,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alephium","blockchain","fullnode","layer1","mainnet"],"created_at":"2026-01-27T09:05:02.773Z","updated_at":"2026-01-27T09:05:16.431Z","avatar_url":"https://github.com/touilleio.png","language":"HCL","funding_links":[],"categories":[],"sub_categories":[],"readme":"Alephium standalone\n====\n\nThis repository builds a container image of [Alephium layer 1 blockchain](https://alephium.org) full node\nbased on the official [`alephium/alephium`](https://hub.docker.com/r/alephium/alephium/tags), wrapping the original entrypoint with [entrypoint-wrapper.sh](./entrypoint-wrapper.sh)\nin order to add the features described below. The final images are available in [Docker Hub](https://hub.docker.com/r/touilleio/alephium-standalone/tags) under the\nname `touilleio/alephium-standalone`.\n\n# Features\n\n- Provides a standalone script [snapshot-loader.sh](snapshot-loader.sh) to load the latest snapshot from [https://archives.alephium.org](https://archives.alephium.org) to speed up the initial sync, if not already sync'ed\n- Ships a default [mainet user.conf](./user-mainnet.conf) with the following config:\n  - Runs on port *39973* (instead of the default 9973) to be compatible with platforms such as [Flux](https://www.runonflux.io/)\n  - Without [API key](https://wiki.alephium.org/full-node/Full-Node-More/#api-key)\n  - A [testnet user.conf](./user-testnet.conf) is also available for [testing](https://wiki.alephium.org/network/testnet-guide).\n- Check the sha256sum of the downloaded snapshot (using [tee-hash](https://github.com/touilleio/tee-hash) to do it all in one stream)\n\nA basic [docker-compose.yml](./docker-compose.yml) show how to quickly run the container.\n\n# Environment variables\n\n| Environment variable           | Default                    | Description                                                                                                                                                                                                                     |\n|--------------------------------|----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ALEPHIUM_HOME                  | `/alephium-home/.alephium` | Path, inside the official `alephium/alephium`, there the full node stores its data. See the official [Dockerfile.release](https://github.com/alephium/alephium/blob/master/docker/release/Dockerfile.release) for more details. |\n| ALEPHIUM_NETWORK               | `mainnet`                  | Which network to load the snapshots for. Possible values are mainnet and testnet. !! If you set your own `user.conf`, this value should match `alephium.network.network-id` in `user.conf` !! (mainnet = 0, testnet = 1)        |\n| ALEPHIUM_FORCE_RELOAD_SNAPSHOT | `0`                        | If set to `1`, the database will be dropped at every reboot. Useful for testing, not recommended in working setups.                                                                                                             |\n| NODE_TYPE                      | `pruned`                   | Define which snapshot to load between the pruned or the full snapshots. Pruned snapshot decrease the resources rquirement to ~50GB of disk storage.                                                                      |\n\n# Using the standalone script\n\nLoading the snapshot in a dedicated folder `$ALEPHIUM_HOME` can be done manually using the script [snapshot-loader.sh](snapshot-loader.sh) as given below. Mind configuring `ALEPHIUM_HOME` and `ALEPHIUM_NETWORK` accordingly, and make sure `ALEPHIUM_HOME` is writable.\n\n```\nALEPHIUM_HOME=/tmp\nALEPHIUM_NETWORK=testnet\ncurl -L https://github.com/touilleio/alephium-standalone/raw/main/snapshot-loader.sh | env ALEPHIUM_HOME=${ALEPHIUM_HOME} ALEPHIUM_NETWORK=${ALEPHIUM_NETWORK} sh\n```\n\nIf the script completes, the snapshot has been successfully downloaded and is available in `${ALEPHIUM_HOME}/${ALEPHIUM_NETWORK}`.\nYou might need to change ownership of the files depending on what you'll do next.\n\n```\nchown nobody:nogroup -R \"${ALEPHIUM_HOME}/${ALEPHIUM_NETWORK}\"\n```\n\nFor more details about [Alephium Archives](https://archives.alephium.org) and snapshot loading, go to the [official snapshot loading documentation](https://docs.alephium.org/full-node/loading-snapshot)\n\n# One liner to launch the container\n\nMostly given as a reference, this *one liner* allows launching an Alephium full node in one line (if `docker` is installed):\n\n```\nALEPHIUM_HOME=/tmp\nALEPHIUM_NETWORK=testnet\ndocker run -p 39973:39973 -p 127.0.0.1:12973:12973 \\\n  -v ${ALEPHIUM_HOME}:/alephium-home/.alephium \\\n  -e ALEPHIUM_NETWORK=${ALEPHIUM_NETWORK} touilleio/alephium-standalone:latest\n```\n\nThis command is not production ready and extra care must be taken for running a productive full node.\n\n# Wrapper script details\n\nThe [wrapper script](./entrypoint-wrapper.sh) contains lots of comments to make it understandable of what and how it is wrapping\nthe official [entrypoint.sh script](https://github.com/alephium/alephium/blob/master/docker/release/entrypoint.sh).\n\n# Troubleshooting\n\n## Restarting from scratch\n\nIf you want to restart from scratch and re-download the database, delete all what is inside your alephium data folder,\ni.e. if you're using the provided [docker-compose.yml](./docker-compose.yml):\n\n```\nrm -r alephium-data/*\n```\n\n# Terraform setup\n\nA terraform setup is provided for your convenience in the [terraform](./terraform) folder. Launch an AWS instance sync'ed\nto the chain withing ~30 minutes by simply doing:\n\n```\nterraform apply\n```\n\nPlease refer to the official [terraform doc](https://developer.hashicorp.com/terraform/tutorials) if needed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftouilleio%2Falephium-standalone","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftouilleio%2Falephium-standalone","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftouilleio%2Falephium-standalone/lists"}