Skip to content

Prerequisites for Self-Hosted Projects

Before using Orixen, you need to install and configure the following tools:

Tool Version Purpose
AWS CLI v2+ AWS authentication and resource management
Terraform v1.0+ Infrastructure as Code deployment

1. AWS CLI Setup

The AWS CLI is required to authenticate with your AWS account and manage resources.

1.1 Install AWS CLI

Follow the instructions at Installing the AWS CLI for your operating system.

Verify the installation:

aws --version

1.2 Create an IAM User

You'll need to create an IAM user with programmatic access in the AWS Console. Watch the video below for a step-by-step guide.

Important: Make sure to attach the necessary policies. In the example below, we attach the "AdministratorAccess" policy for simplicity, but in a production environment, you should follow the principle of least privilege.

1.3 Configure AWS Credentials

After creating your IAM user, configure the AWS CLI with your access keys:

Run the following command and enter your credentials when prompted:

aws configure

You'll be asked for:

  • AWS Access Key ID: Your IAM user access key
  • AWS Secret Access Key: Your IAM user secret key
  • Default region name: e.g., us-east-1
  • Default output format: json (recommended)

Verify your configuration:

aws sts get-caller-identity

2. Terraform Setup

Follow instructions at Install Terraform for your operating system.

Verify the installation:

terraform --version

3. Other Tools

You will also need: - an AI Agent CLI installed to interact with Orixen. You can use any that you like: Claude Code, Codex, Copilot, Gemini, etc. - an IDE to write code such as VSCode, Cursor, VIM, etc.