Initial Host Setup

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# Log in as root (or use sudo for each command)

# Create your user
adduser your-username
usermod -aG sudo your-username

# Update the system
apt update && apt upgrade -y

# Install essential packages
apt install -y curl wget git vim htop net-tools ufw rsync

1
2

sudo usermod -aG docker your-username
# Log out and back in for this to take effect

1
2

docker --version
docker compose version

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# On your local machine, generate SSH key if you don't have one
ssh-keygen -t ed25519 -C "your-email@example.com"

# Copy your public key to the server
ssh-copy-id your-username@server-ip

# On the server, disable password authentication (optional but recommended)
sudo vim /etc/ssh/sshd_config
# Set: PasswordAuthentication no
sudo systemctl restart ssh

1
2
3
4
5
6
7
8

# Configure UFW firewall
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow ssh
sudo ufw enable

# Update system hostname (optional)
sudo hostnamectl set-hostname your-hostname

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# Clone to your preferred location
cd /opt
sudo mkdir infrastructure
sudo chown your-username:your-username infrastructure
cd infrastructure

# Clone the repository
git clone https://github.com/your-username/your-repo.git .

# Or if using SSH keys
git clone git@github.com:your-username/your-repo.git .

1
2
3
4
5
6
7

# Run the repository initialization
./init.sh

# This sets up:
# - Git hooks
# - Basic repository configuration
# - Development environment preparation

1
2
3
4
5
6

# Create storage directories
sudo mkdir -p /data/{tier1,tier2,tier3}
sudo chown -R your-username:your-username /data

# Setup tiers for your node (example for icarus)
.scripts/ops/setup-tiers icarus /data/tier1 /data/tier2 /data/tier3

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# Copy environment template (if exists)
cp .env.example .env

# Edit with your settings
vim .env

# Set required variables like:
# DOMAIN=your-domain.com
# NODE=your-node-name
# TELEGRAM_BOT_TOKEN=your-bot-token

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# Navigate to your node directory
cd icarus  # or daedalus/helios

# Start with the root services first
cd root
docker compose up -d

# Check if everything started correctly
docker compose ps
docker compose logs

# Then start other services as needed
cd ../arr  # example service
docker compose up -d

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# Check all containers are running
docker ps

# Check system resources
df -h
free -h
docker system df

# Test network connectivity
ping -c 4 8.8.8.8

# Check logs for any errors
docker compose logs | grep -i error

1
2
3

# Make sure you're in the docker group
sudo usermod -aG docker $USER
# Log out and back in

1
2
3
4

# Check what's using the port
sudo ss -tulpn | grep :80
# Stop the conflicting service
sudo systemctl stop apache2  # example

1
2
3
4
5

# Check disk usage
df -h
# Clean up if needed
docker system prune -f
sudo apt autoremove -y

1
2
3
4
5
6

# Check firewall
sudo ufw status
# Check if service is actually running
docker compose ps
# Check service logs
docker compose logs service-name