Skip to content

Latest commit

 

History

History
159 lines (120 loc) · 3.75 KB

INSTALL_LINUX.md

File metadata and controls

159 lines (120 loc) · 3.75 KB

Linux Installation Guide

This guide covers installing GlinrDock on Linux systems using various methods.

System Requirements

  • Linux kernel 3.10+ (RHEL/CentOS 7+, Ubuntu 16.04+, Debian 9+)
  • Docker Engine 20.10+
  • systemd (for service management)
  • 512MB RAM minimum, 2GB recommended
  • 1GB available disk space

Installation Methods

Method 1: Automated Script (Recommended)

Download and run the installation script:

curl -fsSL https://github.com/GLINCKER/glinrdock-release/releases/latest/download/install.sh | sudo bash

This script will:

  • Download the appropriate binary for your architecture
  • Install to /usr/local/bin/glinrdockd
  • Create systemd service unit
  • Generate initial configuration
  • Start the service

Method 2: Manual Binary Installation

  1. Download the binary:
# For x86_64
curl -LO https://github.com/GLINCKER/glinrdock-release/releases/latest/download/glinrdockd_linux_amd64.tar.gz

# For ARM64
curl -LO https://github.com/GLINCKER/glinrdock-release/releases/latest/download/glinrdockd_linux_arm64.tar.gz
  1. Verify the download:
curl -LO https://github.com/GLINCKER/glinrdock-release/releases/latest/download/SHA256SUMS
sha256sum -c SHA256SUMS --ignore-missing
  1. Extract and install:
tar -xzf glinrdockd_linux_*.tar.gz
sudo cp glinrdockd_linux_* /usr/local/bin/glinrdockd
sudo chmod +x /usr/local/bin/glinrdockd
  1. Create system user:
sudo useradd --system --shell /bin/false --home-dir /var/lib/glinrdock glinrdock
sudo mkdir -p /var/lib/glinrdock /etc/glinrdock
sudo chown glinrdock:glinrdock /var/lib/glinrdock
  1. Install systemd service:
curl -fsSL https://raw.githubusercontent.com/GLINCKER/glinrdock-release/main/deploy/systemd/glinrdockd.service | sudo tee /etc/systemd/system/glinrdockd.service
sudo systemctl daemon-reload

Method 3: Package Manager Installation

RPM-based systems (RHEL, CentOS, Fedora):

# Download RPM package
curl -LO https://github.com/GLINCKER/glinrdock-release/releases/latest/download/glinrdockd.rpm
sudo rpm -i glinrdockd.rpm

DEB-based systems (Ubuntu, Debian):

# Download DEB package
curl -LO https://github.com/GLINCKER/glinrdock-release/releases/latest/download/glinrdockd.deb
sudo dpkg -i glinrdockd.deb

Configuration

Initial Configuration

Create configuration file:

sudo tee /etc/glinrdock/config.toml << EOF
[server]
bind_addr = "127.0.0.1:8080"
data_dir = "/var/lib/glinrdock"

[auth]
admin_token = "$(openssl rand -hex 32)"

[docker]
socket_path = "/var/run/docker.sock"
EOF

Service Management

Start and enable the service:

sudo systemctl enable glinrdockd
sudo systemctl start glinrdockd

Check service status:

sudo systemctl status glinrdockd

View logs:

sudo journalctl -u glinrdockd -f

Verification

  1. Check service is running:
curl http://localhost:8080/v1/health
  1. Access web interface:

Firewall Configuration

If using firewall, allow access to GlinrDock:

UFW (Ubuntu):

sudo ufw allow 8080/tcp

firewalld (RHEL/CentOS):

sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload

Troubleshooting

  • Service fails to start: Check logs with journalctl -u glinrdockd
  • Permission denied errors: Verify user is in docker group
  • Port binding errors: Ensure port 8080 is available
  • Docker connection issues: Verify Docker daemon is running

See Troubleshooting Guide for more details.

Next Steps