Skip to main content

Quickstart Guide

Get rolling fast. This page covers the minimal path from zero to a running server.

Prerequisites​

  • A Linux box with sudo access
  • Docker (installed by make deploy if not present)
  • Python 3 (installed by make deploy if not present)
  • An internet connection (to pull Docker images)

Production Install​

git clone https://github.com/LongHaulC2/LongHaulC2
cd LongHaulC2

sudo make deploy

That's it. The Makefile installs all apt dependencies, sets up Docker containers (MySQL, Redis, Neo4j), builds the cross-compilation image, installs services, and starts everything.

# Verify services are running
sudo systemctl status longhaulc2-server
sudo systemctl status longhaulc2-web

Default credentials: longhaul / P@ssw0rd1!

Change the defaults in production:

sudo make deploy INIT_API_USER=operator INIT_API_PASS=<strong_pass> \
MYSQL_ROOT_PASSWORD=<strong_pass> REDIS_PASSWORD=<strong_pass> \
NEO4J_PASSWORD=<strong_pass> JWT_SECRET_KEY=<strong_secret>

Access the UI: http://<server>:8083

API + Swagger: http://<server>:45045/doc

Dev Install​

For local development with live reloads:

git clone https://github.com/LongHaulC2/LongHaulC2
cd LongHaulC2

make dev_install
source venv/bin/activate

# Run the server (terminal 1)
PYTHONPATH=. python -m server.main

# Run the client (terminal 2)
PYTHONPATH=. python -m client.main

What Got Installed?​

See install_reference (created by make deploy) for a full list of everything that was touched on your system: apt packages, directories, systemd units, Docker containers, and the workspace path.

Next Steps​