Uninstall Guide¶

Complete instructions for removing GlinrDock from your system.

Before Uninstalling¶

Backup Your Data (Optional)¶

If you want to preserve your projects and configurations:

Linux Installation:

sudo tar czf glinrdock-backup-$(date +%Y%m%d).tar.gz -C /var/lib/glinrdock .

Docker Installation:

docker run --rm -v glinrdock_data:/data -v $(pwd):/backup alpine tar czf /backup/glinrdock-backup-$(date +%Y%m%d).tar.gz -C /data .

Export Projects¶

Use the web interface to export your Docker Compose files: 1. Go to each project 2. Click Export → Docker Compose 3. Save the files for future use

Uninstall Methods¶

Method 1: Automated Uninstall Script¶

Download and run the uninstall script:

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

This will remove: - GlinrDock binary - systemd service - Configuration files - Data directory - System user account

Method 2: Manual Uninstall (Linux)¶

1. Stop the service:

   sudo systemctl stop glinrdockd
   sudo systemctl disable glinrdockd
   

2. Remove systemd service:

   sudo rm -f /etc/systemd/system/glinrdockd.service
   sudo systemctl daemon-reload
   

3. Remove binary:

   sudo rm -f /usr/local/bin/glinrdockd
   

4. Remove configuration and data:

   sudo rm -rf /etc/glinrdock
   sudo rm -rf /var/lib/glinrdock
   

5. Remove system user (optional):

   sudo userdel glinrdock
   

6. Remove logs (optional):

   sudo journalctl --vacuum-time=1d
   

Method 3: Docker Uninstall¶

Docker Compose:

# Stop and remove containers
docker-compose down

# Remove volumes (WARNING: This deletes all data)
docker-compose down -v

# Remove downloaded files
rm docker-compose.yml

Manual Docker:

# Stop and remove container
docker stop glinrdock
docker rm glinrdock

# Remove volume (WARNING: This deletes all data)
docker volume rm glinrdock_data

# Remove image (optional)
docker rmi ghcr.io/glincker/glinrdock:latest

Method 4: Package Manager Uninstall¶

RPM-based systems:

sudo rpm -e glinrdockd

DEB-based systems:

sudo dpkg -r glinrdockd

Clean Up Remaining Files¶

After uninstalling, you may want to remove additional files:

Log Files¶

# systemd logs
sudo journalctl --vacuum-time=1d

# Application logs (if any)
sudo rm -rf /var/log/glinrdock

Firewall Rules¶

# UFW
sudo ufw delete allow 8080/tcp

# firewalld
sudo firewall-cmd --permanent --remove-port=8080/tcp
sudo firewall-cmd --reload

Docker Networks (Docker installation)¶

# List networks
docker network ls | grep glinrdock

# Remove custom networks
docker network rm glinrdock_default

Verification¶

Ensure GlinrDock is completely removed:

1. Check process:

   ps aux | grep glinrdock
   

2. Check ports:

   netstat -tlnp | grep 8080
   

3. Check systemd services:

   systemctl list-units | grep glinrdock
   

4. Check Docker containers:

   docker ps -a | grep glinrdock
   

Troubleshooting Uninstall¶

Service Won't Stop¶

# Force kill the process
sudo pkill -f glinrdockd

# Force stop systemd service
sudo systemctl kill glinrdockd

Permission Denied Errors¶

# Some files may be owned by the glinrdock user
sudo rm -rf /var/lib/glinrdock
sudo rm -rf /etc/glinrdock

Docker Container Won't Remove¶

# Force remove container
docker rm -f glinrdock

# Force remove volume
docker volume rm -f glinrdock_data

Partial Package Removal¶

# Force remove package (RPM)
sudo rpm -e --noscripts glinrdockd

# Force remove package (DEB)
sudo dpkg -r --force-remove-reinstreq glinrdockd

Reinstallation¶

If you want to reinstall GlinrDock later:

1. Follow installation guide: Linux or Docker
2. Restore backup (if created):

   # Linux
   sudo tar xzf glinrdock-backup-*.tar.gz -C /var/lib/glinrdock
   
   # Docker
   docker run --rm -v glinrdock_data:/data -v $(pwd):/backup alpine tar xzf /backup/glinrdock-backup-*.tar.gz -C /data
   

Support¶

If you encounter issues during uninstall: - Check our Troubleshooting Guide - Report issues at GitHub Issues

Feedback¶

We're sorry to see you go! If you have feedback about GlinrDock, please share it in our GitHub Discussions.