Binary Installation

HitKeep compiles to a single binary with zero external dependencies.

Download

Download the latest release for your architecture from GitHub Releases.

# Example for Linux AMD64
wget https://github.com/pascalebeier/hitkeep/releases/latest/download/hitkeep-linux-amd64
chmod +x hitkeep-linux-amd64
mv hitkeep-linux-amd64 /usr/local/bin/hitkeep

Running with Systemd

For production Linux servers, we recommend using systemd to ensure HitKeep starts on boot and restarts on failure.

Security Note

Avoid passing sensitive secrets (like JWT_SECRET or SMTP passwords) via command-line flags. Flags are visible to other users on the system via process listings (ps aux). Use Environment Variables instead.

1. Create a dedicated user:

useradd -r -s /bin/false hitkeep
mkdir -p /var/lib/hitkeep/data
chown hitkeep:hitkeep /var/lib/hitkeep/data

2. Create /etc/systemd/system/hitkeep.service:

[Unit]
Description=HitKeep Analytics
After=network.target

[Service]
User=hitkeep
Group=hitkeep

# SENSITIVE CONFIGURATION (Environment Variables)
# Use Environment or EnvironmentFile to keep secrets out of process listings
Environment="HITKEEP_JWT_SECRET=change-this-to-a-long-random-string"
Environment="HITKEEP_MAIL_PASSWORD=your-smtp-password"

# GENERAL CONFIGURATION (Flags)
ExecStart=/usr/local/bin/hitkeep \
  -public-url=https://analytics.example.com \
  -db=/var/lib/hitkeep/data/hitkeep.db \
  -http=:8080

Restart=always
RestartSec=3

[Install]
WantedBy=multi-user.target

3. Enable and start:

systemctl daemon-reload
systemctl enable --now hitkeep