ar io

status: active - Linux Installation Instructions

source

system requirements (minimum)

4 core CPU
4 GB Ram
500 GB storage (SSD recommended)
Stable 50 Mbps internet connection
a domain like (register here )

required packages

Update your software:
```
sudo apt update
sudo apt upgrade   
```

Enable your firewall and open necessary ports:

sudo ufw enable

# Optional: If using SSH, allow port 22 
sudo ufw allow 22

# Allow ports 80 and 443 for HTTP and HTTPS
sudo ufw allow 80
sudo ufw allow 443

Install nginx:
```
sudo apt install nginx -y
```
Install git:
```
sudo apt install git -y
```
Install Docker:
```
sudo apt install docker-compose -y
```
Install Certbot:
```
sudo apt install certbot -y
```
Install ssh (optional, for remote access to your Linux machine):
```
sudo apt install openssh-server -y
sudo systemctl enable ssh
```

Install Yarn:

curl -sSL https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -

echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list

sudo apt-get update -y

sudo apt-get install yarn -y

Install NVM (Node Version Manager):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc

Install Node.js:
```
nvm install 18.8.0
```
Install build tools
```
sudo apt install build-essential 
```
Install SQLite:
```
sudo apt install sqlite3 -y
```

install the node

Clone the ar-io-node repository and navigate into it:

cd $HOME
git clone -b main https://github.com/ar-io/ar-io-node
cd ar-io-node

Create an environment file:

nano .env

Paste the following content into the new file:

GRAPHQL_HOST=arweave.net
GRAPHQL_PORT=443
START_HEIGHT=0
RUN_OBSERVER=true
ARNS_ROOT_HOST=<your-domain>
AR_IO_WALLET=<your-public-wallet-address>
OBSERVER_WALLET=<hot-wallet-public-address>

Replace:

<your-domain> with the domain address (ex dieuts.top not www.dieuts.top);

Create a file named <Observer-Wallet-Address>.json, replacing "<Observer-Wallet-Address>" with the public address of the wallet. This should match your OBSERVER_WALLET environmental variable. The file is filled with private key of your OBSERVER_WALLET and must be saved in the wallets directory in the root of the repository.

Build the Docker container:

sudo docker-compose up -d --build

Check the logs for errors:

sudo docker-compose logs -f --tail=0

set up networking

config DNS

Value: your VPS IP

Create SSL (HTTPS) Certificates for Your Domain:

sudo certbot certonly --manual --preferred-challenges dns --email <your-email-address> -d <your-domain>.com -d '*.<your-domain>.com'

Replace <your-domain>.com with your domain (ex dieuts.top)

Configure nginx

create the configuration file:

# remove default file
sudo rm /etc/nginx/sites-available/default

# create configuration file for your domain, replace <your-domain>.com with your domain
sudo nano /etc/nginx/sites-available/<your-domain>.com.conf

Paste the following configuration (replace <your-domain>.com when necessary). Save then exit:

# Force redirects from HTTP to HTTPS
server {
    listen 80;
    listen [::]:80;
    server_name <your-domain>.com *.<your-domain>.com;

    location / {
        return 301 https://$host$request_uri;
    }
}

# Forward traffic to your node and provide SSL certificates
server {
    listen 443 ssl;
    listen [::]:443 ssl;
    server_name <your-domain>.com *.<your-domain>.com;

    ssl_certificate /etc/letsencrypt/live/<your-domain>.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/<your-domain>.com/privkey.pem;

    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_http_version 1.1;
    }
}

create a symbolic link (replace <your-domain>.com when necessary)

sudo ln -s /etc/nginx/sites-available/<your-domain>.com.conf /etc/nginx/sites-enabled/<your-domain>.com.conf

Test the configuration

sudo nginx -t

If there are no errors, restart nginx:

sudo service nginx restart

Your node should now be running and connected to the internet. Test it by entering https://<your-domain>/3lyxgbgEvqNSvJrTX2J7CfRychUD5KClFhhVLyTPNCQ in your browser.

join the AR.IO testnet

check your work

https://gateways.<your-domain>.com

Last updated 1 year ago

Was this helpful?