In the following guide, we will cover all the necessary steps to set up an Arweave gateway.
A Unix OS (Debian 11 preferable)
Docker and Docker Compose LTS
There are several million transactions on the Arweave chain. In order to effectively serve content on the gateway you'll need a decent sized computer. The ideal specs for a Gateway should have the following:
16GB RAM (ideally 32GB RAM)
~4TB of SSD storage available
Intel i5 / AMD FX or greater, +4 vCPUs should be more than enough, these are typically Intel Xeon CPUs.
Add Docker’s official GPG key:
Import Docker GPG key used for signing Docker packages.
Add the Docker repository to Debian 10
Add Docker repository which contain the latest stable releases of Docker CE.
This installation will add docker group to the system without any users. Add your user account to the group to run docker commands as non-privileged user.
Check docker and compose version
Log out and log back in so that your group membership is re-evaluated.
Clone gateway repo
Configure the gateway
First, let's copy the .env
Optionally add your own Arweave Node (miner)
Build and run Vartex
Make sure you build your docker image every time the .env file is modified in order to apply the new settings.
While developing you can specify a range of blocks you wish to sync, the range starts from the most recent known block from the cached hash_list down X amount of blocks specified with DEVELOPMENT_SYNC_LENGTH.
You can test if the server and the GraphQL queries are working properly by navigating to.
This webpage should look similar to.
You can now access any content hosted on the Arweave network, for example the file we've just deployed
mytextfile.txt using Arweave's txID:
Stopping the gateway
You can safely stop the gateway by running: