Skip to main content
The first step in deploying Oxy is to provision a server where your Oxy instance will run.
The following deployment guides assume you will be using Ubuntu as your operating system and “ubuntu” as your username. While Oxy can work on other Linux distributions and usernames, the commands and paths may need to be adjusted accordingly.
1

Provision a Server

Provision a server (e.g., AWS EC2, Google Compute Engine) with your preferred OS (Ubuntu recommended).
For cloud deployments, we recommend using at least 2GB RAM and 1 CPU core. This will ensure smooth operation of Oxy and any additional services you may run.
2

Install Essential Packages

Once your server is up and running, install the essential packages:
sudo apt-get update -y
sudo apt-get install -y \
    git \
    curl \
    wget \
    unzip \
    tar \
    gcc \
    g++ \
    make \
    python3-pip \
    ufw \
    software-properties-common
These packages will provide you with the basic tools needed for the deployment.
3

Configure SSH Access

Ensure your server has proper SSH access configured for secure remote management.
# Create SSH directory if it doesn't exist
mkdir -p ~/.ssh
chmod 700 ~/.ssh

# Set proper permissions for SSH files
touch ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys
You should set up your own SSH key for secure access to your server. Add your public key to the ~/.ssh/authorized_keys file to enable password-less authentication:
# On your local machine, generate a key if you don't have one
# ssh-keygen -t ed25519 -C "your-email@example.com"

# Then add your public key to the server's authorized_keys file
# Either manually append your public key or use ssh-copy-id:
# ssh-copy-id user@your-server-ip
4

Configure Basic Firewall

Set up a basic firewall to allow only necessary traffic:
# Allow SSH access
sudo ufw allow 22/tcp

# Enable the firewall
sudo ufw --force enable
You’ll configure additional ports in later steps.
Once your machine is set up with the essential components, proceed to the next step to install the Oxy CLI.
⌘I