Help & Documentation

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

1. Go to Register
2. Choose a username (3+ characters, letters, numbers, underscore, hyphen)
3. Enter your email (for recovery only, stored encrypted)
4. Create a strong password (8+ characters)
5. Save the backup code shown after registration - you'll need it to recover your session!

Your Space URL

After registration, your personal space is at:

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

Upload any HTML, CSS, JS, images, or files here. They will be served publicly.

Custom Landing Page

By default, visitors see a file listing. To create a custom landing page:

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

Note: index.html and index.htm are blocked. If you try to upload them (via dashboard or WebDAV), they will be automatically renamed to main.html/main.htm.

Dashboard Features

The dashboard lets you:

• Upload and manage files (drag & drop supported)
• Create folders and new files
• Preview files directly in the browser
• Edit files with the built-in editor
• Copy, rename, and delete files
• View file/folder counts
• Access your WebDAV token for command-line uploads
• Get a backup code to restore your session
• Delete your entire space

Password Recovery

If you lose access to your account:

1. Go to Password Recovery
2. Option A: Paste your backup code
3. Option B: Enter username + new password (requires email verification)

Important: Backup codes are tied to your password. If you reset your password, update your saved backup!

File Upload (WebDAV)

Upload files via the dashboard or use curl with WebDAV:

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

More examples:

• Create a folder: curl -X MKCOL -H "X-WebDAV-Token: YOUR_TOKEN" https://webx11.duckdns.org/spaces/username/mydir/
• Delete a file: curl -X DELETE -H "X-WebDAV-Token: YOUR_TOKEN" https://webx11.duckdns.org/spaces/username/file.html
• Copy a file: curl -X COPY -H "X-WebDAV-Token: YOUR_TOKEN" -H "Destination: /spaces/username/newfile.html" https://webx11.duckdns.org/spaces/username/oldfile.html
• Move a file: curl -X MOVE -H "X-WebDAV-Token: YOUR_TOKEN" -H "Destination: /spaces/username/newfolder/file.html" https://webx11.duckdns.org/spaces/username/file.html

Supported operations: PUT, DELETE, MKCOL, COPY, MOVE

Get your token: Open the Dashboard, expand the "WebDAV Token" section in the sidebar, and copy the token.

Security

• Client-side encryption: Session data encrypted in browser using AES-256-GCM
• PBKDF2 key derivation: 100,000 iterations for password hashing
• No server storage: Your password never leaves your device
• Cookie-based sessions: Encrypted session cookie expires in 1 year
• Email encryption: Recovery email is also encrypted

Troubleshooting

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 URL.

Wrong password on backup restore? The backup was created with a different password - you need the original password.

Tips

• Use main.html as your landing page (not index.html)
• Keep your backup code safe - it's the only way to recover your session
• Use the theme toggle (🎨) to switch between light/dark modes
• Files are served over HTTPS with automatic SSL

ChatStudio - AI Code Editor

ChatStudio is an AI-powered code editor built into WebX11. Write, preview, and deploy websites directly from your browser.

• Code Editor: Full syntax highlighting for HTML, CSS, JavaScript
• AI Assistant: Powered by Ollama. Write code, debug, explain, translate
• Live Preview: See your changes instantly with built-in preview
• Modules: Specialized AI modes for different tasks
• Save & Deploy: Save directly to your space, instantly live

Open ChatStudio →

ChatStudio Modules

Switch between specialized AI modes using commands or the sidebar:

• /help - Show module help
• /module [name] - Switch module
• /search [query] - Web search
• /fetch [url] - Fetch URL content
• /explain [code] - Explain code
• /summarize - Summarize text
• /plan [goal] - Create a plan
• /status - Check Ollama status
• /test - Run connection test
• /list - List available models

Your WebX11 Space

Every user gets a personal web space with:

• Your URL: https://webx11.duckdns.org/spaces/[username]/
• ChatStudio: /spaces/chatstudio/main.html - AI code editor
• SearX Search: https://searxing.duckdns.org - Privacy search
• Dashboard: /spaces/dashboard.html - Manage files
• WebDAV: Upload via command line or apps

Upload main.html to make your landing page live instantly!