Help & Documentation

Getting Started

🌐 What is WebX11?

WebX11 is a self-hosted web platform where each user gets their own encrypted space. No server-side accounts — your session is encrypted in your browser using AES-256-GCM.

🔑 Creating an Account

Go to Register
Choose a username (3+ chars, letters/numbers/underscore/hyphen)
Enter your email (for recovery, stored encrypted)
Create a strong password (8+ characters)
Save the backup code — you'll need it to recover!

Your Space

📁 Your Space URL

After registration, your personal space lives at:

https://webx11.duckdns.org/spaces/[username]/

Upload any HTML, CSS, JS, images, or files — they're served publicly.

🏠 Custom Landing Page

By default visitors see a file listing. Create a custom landing:

Upload main.html to your space root
Visitors see it instead of the file listing

Note index.html is blocked — it's auto-renamed to main.html.

Dashboard Features

📊 What You Can Do

Upload & manage files (drag & drop)
Create folders and new files
Preview files in the browser
Built-in file editor
Copy, rename, delete files
View file/folder counts
WebDAV token for CLI uploads
Backup code for session restore
Delete your entire space

Account

🔄 Password Recovery

Lost access? Two ways to recover:

Option A: Use your backup code
Option B: Username + new password (email verification)

Important Backup codes are tied to your password — resetting invalidates the old code.

🔒 Security

Client-side encryption: AES-256-GCM in your browser
PBKDF2: 100,000 iterations for password hashing
No server storage: Password never leaves your device
Cookie sessions: Encrypted, expires in 1 year
Email encryption: Recovery email is encrypted too

WebDAV

🔌 File Upload via WebDAV

Upload files from the command line with curl:

curl -T myfile.html -H "X-WebDAV-Token: YOUR_TOKEN" https://webx11.duckdns.org/spaces/username/

Create folder: curl -X MKCOL -H "X-WebDAV-Token: TOKEN" https://.../username/mydir/

Delete file: curl -X DELETE -H "X-WebDAV-Token: TOKEN" https://.../username/file.html

Copy file: curl -X COPY -H "X-WebDAV-Token: TOKEN" -H "Destination: .../new.html" .../old.html

Move file: curl -X MOVE -H "X-WebDAV-Token: TOKEN" -H "Destination: .../new/" .../file.html

Supported: PUT, DELETE, MKCOL, COPY, MOVE

Get your token: Dashboard → "WebDAV Token" section

Troubleshooting

🔧 Common Issues

🕐 Session expired?

Use your backup code or go to Password Recovery.

📤 Can't upload?

Check file size (max 50MB). Try via dashboard.

🚫 Space not loading?

Ensure username is correct in the URL.

🔐 Wrong password on restore?

Backup codes are tied to the original password.

Tips

📄 Use main.html as landing page (not index.html)

💾 Keep your backup code safe — it's your only recovery key

🎨 Use the theme toggle to switch between light/dark modes

🔒 All files are served over HTTPS with automatic SSL