Guide & support
Help
A plain-language guide to chats, Pocket, contacts, safety, and running your own instance.
What this app is
Wizard Skin is a focused, self-hosted messenger. You control who can join, where files live, and whether messages use end-to-end or server-managed encryption.
- Chats support replies, media, voice notes, location, GIFs, calls, and optional AI writing tools.
- Pocket keeps private notes and files ready to share into a conversation.
- Contacts are private and one-way. Saving someone does not publish a follow relationship.
- Announcements keep members informed without introducing a feed.
Basic stack (non-technical version)
- Server app: Python + Flask powers pages, logins, and APIs.
- Database: PostgreSQL stores accounts, contacts, conversations, Pocket metadata, announcements, and settings.
- Real-time layer: WebSockets (Socket.IO) deliver live chat updates.
- Web front end: Server-rendered templates, Bootstrap, Alpine.js, and classic JavaScript provide the responsive UI.
- Storage: uploads can be kept on local disk or object storage (S3/R2-compatible).
What you need to run it
- A server (cloud VM, VPS, or home lab) that can run Python apps 24/7.
- A PostgreSQL database reachable by the app server.
- A domain + HTTPS certificate for secure sign-in and browser features.
- Optional services: Redis (background jobs), object storage (media), and push keys (notifications).
No managed "Wizard Skin cloud" is required—the instance owner runs and controls the service.
Install Wizard Skin as an app
Wizard Skin is an installable web app. Install it, open it from the app icon, then enable push from a user tap so message alerts can reach you.
- iPhone/iPad: Tap Share → Add to Home Screen. Some browsers support this from the Share menu. After adding it, open Wizard Skin from the Home Screen icon.
- Android: Android browsers may show an Install prompt. If you do not see it, use the browser menu and choose Install app / Add to Home screen.
- Desktop: Use the address-bar install icon when available, or open the browser menu and choose Install.
Push is limited to messages, calls, announcements, and important account alerts. Wizard Skin does not send ads.