Skip to content

Installing EpixNet

Quick Start

Prerequisites

  • Python 3.8 or higher
  • Git (for cloning the repository)
  • Basic development tools (compiler, etc.)

Installation Steps

  1. Clone the repository:
git clone https://github.com/EpixZone/EpixNet.git
cd EpixNet
  1. Create a virtual environment:
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. Install dependencies:
python3 -m pip install -r requirements.txt
  1. Run EpixNet:
python3 epixnet.py
  1. Access the dashboard:

Open your browser and navigate to: http://127.0.0.1:42222/

System Dependencies

Ubuntu/Debian

sudo apt update
sudo apt install git pkg-config libffi-dev python3-pip python3-venv python3-dev build-essential libtool

Fedora/CentOS/RHEL

# Fedora
sudo dnf install git python3-pip python3-wheel python3-devel gcc

# CentOS/RHEL
sudo yum install epel-release
sudo yum install git python3 python3-wheel python3-devel gcc

openSUSE

sudo zypper install python3-pip python3-setuptools python3-wheel python3-devel gcc

Arch Linux

sudo pacman -S git python-pip base-devel

macOS

# Install Xcode command line tools
xcode-select --install

# Install Python 3 via Homebrew (recommended)
brew install python3

Android (Termux)

# Install Termux from F-Droid or Google Play
pkg update
pkg install python automake git binutils libtool

# For older Android versions, you may also need:
pkg install openssl-tool libcrypt clang

# Optional: Install Tor for enhanced privacy
pkg install tor

Docker Installation

# Clone the repository
git clone https://github.com/EpixZone/EpixNet.git
cd EpixNet

# Run with separate Tor container
docker compose up -d epixnet

# Or run with integrated Tor
docker compose up -d epixnet-tor

Manual Docker Build

# Build standard image
docker build -t epixnet:latest . -f docker/Dockerfile

# Build with integrated Tor
docker build -t epixnet:latest . -f docker/tor.Dockerfile

# Run the container
docker run --rm -it \
  -v /path/to/data:/app/data \
  -p 42222:42222 \
  -p 42223:42223 \
  -p 10042:10042 \
  epixnet:latest

Note: Replace /path/to/data with your desired data directory. This directory will contain your sites and private keys.

Automated Setup Script

# Use the provided setup script
./start-venv.sh

This script automatically:

  • Creates a Python virtual environment
  • Installs all dependencies
  • Starts EpixNet

Windows Installation

Prerequisites

  1. Install Python 3.8+ from python.org
  2. Install Git from git-scm.com
  3. Install Visual Studio Build Tools (for compiling dependencies)

Installation Steps

# Clone the repository
git clone https://github.com/EpixZone/EpixNet.git
cd EpixNet

# Create virtual environment
python -m venv venv
venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Run EpixNet
python epixnet.py

With Tor Support

# Install Tor Browser or standalone Tor
# Run EpixNet with Tor proxy
python epixnet.py --tor_proxy 127.0.0.1:9150 --tor_controller 127.0.0.1:9151

# For full Tor anonymity
python epixnet.py --tor_proxy 127.0.0.1:9150 --tor_controller 127.0.0.1:9151 --tor always

Configuration

Command Line Options

# Basic usage
python3 epixnet.py

# Custom port
python3 epixnet.py --ui_port 42222

# Enable Tor
python3 epixnet.py --tor always

# Offline mode
python3 epixnet.py --offline

# Custom data directory
python3 epixnet.py --data_dir /path/to/data

# Debug mode
python3 epixnet.py --debug

Configuration File

EpixNet creates an epixnet.conf file in your data directory where you can set persistent configuration options.