EmperorOS Installation Guide

⚠️ WARNING: This is a manual installation guide. You are expected to know basic Linux commands. Improper use can break your system. Proceed at your own risk.

Step 1: Replacing `/etc/os-release`

Make a backup of your current os-release file before replacing it.

# Backup old os-release
sudo cp /etc/os-release /etc/os-release.bak

# Replace with EmperorOS version
sudo sh -c "curl -fsSL https://raw.githubusercontent.com/EmperorOS/EmperorOS/main/os-release > /etc/os-release"

Step 2: Installing `emperorutils`

emperorutils is a list of utilities for EmperorOS.

# Clone the emperorutils repository
git clone https://github.com/emperoros/emperorutils

# Install utilities
sudo ./install.sh

Step 3: Installing `epkg`

epkg is the EmperorOS package manager.

# Clone the epkg repository
git clone https://github.com/emperoros/epkg

# Move the binary to system-wide location
cd epkg
sudo mv ./epkg /usr/bin/epkg

Step 4: Setting up the epkg repository

The repository must be at /opt/epkg-repo for epkg to work.

# Clone EmperorOS package repository
sudo git clone https://github.com/emperoros/epkg-repo /opt/epkg-repo

Step 5: Reboot

sudo reboot

Step 6: Verify epkg

# List installed packages
epkg list

Additional Notes

Install packages using: sudo epkg add PACKAGE_NAME
Always run epkg as root when installing system-wide.
The repository is local — you can edit .emake scripts for custom builds.
Update installed packages after repository changes: sudo epkg update

Prev Next