Password Recovery Guide

Password Recovery System

This guide provides detailed instructions for resetting your Hawiyat platform password. The process is designed to be secure while maintaining ease of use for system administrators.

Security Considerations

Before proceeding with the password reset process, ensure:

You have root/sudo access to the server
Your SSH connection is secure
The server's firewall rules are properly configured
No unauthorized users have access to the terminal session

Reset Process

Follow these detailed steps to recover access to your Hawiyat dashboard:

Server Access

Connect to your VPS using SSH:

ssh username@your-server-ip

Verify your connection is secure:

# Check current SSH session details
who am i
# Verify you're using an encrypted connection
echo $SSH_CONNECTION

Ensure you're using a secure terminal and trusted network connection before proceeding.

Locate Hawiyat Container

List all running containers to identify the Hawiyat instance:

docker ps --format "table {{.ID}}\t{{.Names}}\t{{.Status}}\t{{.Ports}}"

Verify the container status:

# Get detailed container information
docker inspect <container-id> | grep -i status

The container ID is a unique identifier. Look for a container with "hawiyat" in its name or image.

Execute Password Reset

Access the container and initiate the reset process:

docker exec -it <container-id> bash -c "pnpm run reset-password"

Verify the command execution:

# Check command exit status
echo $?

If you encounter any errors, ensure:

The container is running
You have the correct permissions
The pnpm command is available in the container

Secure Your New Credentials

A new random password will be generated and displayed. It will look similar to:

New password: xxxxxx-xxxxx-xxxxx-xxxxx

Important security steps:

Copy the password immediately
Store it securely (password manager recommended)
Don't share it over unsecured channels
Change it after first login

The generated password is temporary. Change it immediately after logging in for security purposes.

Access Verification

Navigate to your Hawiyat dashboard:

https://your-domain-or-ip:3000

Username: Your existing username
Password: The newly generated password

Verify access to all necessary features:

Dashboard functionality
Container management
User settings
System configurations

Post-Reset Security Measures

After successfully resetting your password:

Change Default Password
- Navigate to Settings > Security
- Choose a strong, unique password
- Enable two-factor authentication if available
Audit System Access
- Check access logs
- Review active sessions
- Terminate unknown sessions
Update Security Settings
- Review permission settings
- Check API access tokens
- Update security policies if needed

For additional security measures or troubleshooting, visit our security documentation or contact support.

Troubleshooting

If you encounter issues during the reset process:

Container Access Issues
- Verify container is running: docker ps
- Check container logs: docker logs <container-id>
- Ensure proper permissions: docker exec -it <container-id> whoami
Command Execution Errors
- Verify pnpm installation: docker exec <container-id> pnpm -v
- Check for error logs: docker exec <container-id> cat /var/log/hawiyat.log
- Ensure proper network connectivity
Login Problems
- Clear browser cache and cookies
- Try incognito/private browsing mode
- Check for CAPS LOCK or keyboard layout issues

If problems persist, consider:

Checking system resources
Reviewing container health
Consulting server logs
Contacting technical support

Password Recovery Guide

On this page