Non-Root Installation

For development environments or when you don’t have root access, you can install Haloy in user mode.

Prerequisites

Docker installed
Your user must be in the docker group

Installation

Install to your user directory:

curl -fsSL https://raw.githubusercontent.com/haloydev/haloy/main/scripts/install-haloyadm.sh | bash
curl -fsSL https://raw.githubusercontent.com/haloydev/haloy/main/scripts/install-haloyadm.sh | bash

Configure Docker Access

Add your user to the docker group (required for non-root Docker access):

sudo usermod -aG docker $(whoami)
sudo usermod -aG docker $(whoami)

Log out and back in, or run:

newgrp docker
newgrp docker

Test Docker access:

docker ps
docker ps

Initialize in Local Mode

Initialize Haloy with the --local-install flag:

haloyadm init --local-install
haloyadm init --local-install

Directory Structure

User Installation:

~/.config/haloy/         # Configuration
~/.local/share/haloy/    # Data
~/.config/haloy/         # Configuration
~/.local/share/haloy/    # Data

User vs System Installation

Aspect	User Installation	System Installation
Config directory	`~/.config/haloy/`	`/etc/haloy/`
Data directory	`~/.local/share/haloy/`	`/var/lib/haloy/`
Permissions	User permissions	Root permissions
Use case	Development, testing	Production

Security Notice

Adding your user to the docker group gives root-equivalent access to the system, as the Docker daemon runs with root privileges. Only do this for trusted users in secure environments.