Garland Enterprises · Help
Deck OS Support
Deck OS is one shared home screen for your household: lists, chores, calendar, family chat, photos and a friendly assistant. It runs on your own computer, and everyone opens it from their phone's web browser.
Deck OS is launching soon.
What you need
- A Linux PC (Ubuntu 22.04+, Debian 12+, Fedora, Mint or similar) with Python 3.10 or newer and about 1 GB free. Or any computer that runs Docker (Windows and Mac work this way).
- Phones, tablets and computers on your home Wi-Fi open it in their web browser. There's no app to download.
- Optional: Home Assistant (to control lights and devices) and Ollama (a free AI that runs on your computer; 8 GB of RAM or more is best).
Install
On a Linux PC
Unpack your download and run the installer. It installs into your home folder and doesn't ask for a password.
tar xzf deckos-1.0.0-linux.tar.gz && cd deckos-1.0.0-linux && ./install.sh
When it finishes, it shows the address to open, usually http://localhost:8765/setup. If something is missing (like Python's "venv"), it prints the exact command that fixes it.
With Docker
tar xzf deckos-1.0.0-docker.tar.gz && cd deckos-1.0.0-docker && docker compose up -d
Open http://localhost:8765/setup. Your 6-digit setup code is in docker compose logs deckos.
First-run setup (about 5 minutes)
- License agreement. Read it and tick "I agree".
- Admin account. Your name, a username and a password (8 or more characters). Setting up from a phone or another computer? It also asks for the setup code.
- Household. Your name, your assistant's name and your town (for the weather).
- Home Assistant (optional). Paste its address and token, or tap Skip.
- Local AI (optional). If Ollama is installed, Deck OS finds it.
- Extras (optional). A GIPHY key for GIFs, and an email server so people can reset passwords.
- License. Paste your key, or start the 14-day free trial.
- Done. You'll see five things to try first.
To get it on everyone's phone, open http://<your computer's address>:8765, sign in, and tap Share → Add to Home Screen. Invite family from More → Everyone.
Your license key
- Where to paste it: tap License on the bottom banner, or go to
/static/license.html. Keys start withDECK1. - Trial: every new install gets 14 days free.
- Renewing: each renewal comes with a new key. Paste it in the same place. Every key keeps working for 7 days past your paid-through date, so a late renewal doesn't interrupt anything.
- If it runs out: Deck OS turns read-only. You can still see everything but can't add or change things. Nothing is deleted. Add a key and it all works again.
- The key check works offline. Deck OS doesn't send your household's data to us.
Updating
Deck OS doesn't update itself. When a new version comes out:
- Linux: unpack the new download and run
./update.shfrom the new folder. Your data isn't touched. Something seems off?./update.sh --undoputs the old version back. - Docker: unpack the new bundle and run
docker compose up -d --build. Your data stays.
Common fixes
"Port 8765 is already in use"
Something else is using that port. Install on another one: ./install.sh --port 8780, then open http://localhost:8780/setup.
My phone can't open it
Make sure the phone is on the same Wi-Fi as the computer, then use the computer's address the installer showed (like http://192.168.1.20:8765), not "localhost". If it still won't load, check that the computer's firewall allows port 8765.
Setup asks for a code I don't have
You only need it when you set up from a phone or another computer. Linux: run journalctl --user -u deckos and look for "setup code". Docker: run docker compose logs deckos. Or just finish setup on the computer itself at http://localhost:8765/setup.
Someone forgot their password
Tap Forgot password? on the sign-in screen and type your name. Deck OS sends a sign-in request to your own phone if you're signed in there. A reset link by email only works if an email server was added in setup step 6. No phone or email? The screen shows a code to read to the admin so they can let you in. If you printed a recovery code from your Profile, you can sign in with that. Admin locked out with none of these? Email us.
Everything turned read-only
Your trial or key ran out. Nothing is lost. Paste a current key on the License page and it all works again.
The assistant won't chat
Chat needs the free local AI (Ollama) or Home Assistant's Assist. Install Ollama from ollama.com, then run ollama pull qwen3:4b. With Docker: docker compose --profile ai up -d, then docker compose exec ollama ollama pull qwen3:4b. Lists, timers and "remember this" work without it.
No device or light controls
Those need Home Assistant. Without it the device screens stay hidden. You can connect it any time.
It stopped when I logged out (Linux)
Run loginctl enable-linger $USER once so it keeps running. To restart it: systemctl --user restart deckos (Docker: docker compose restart deckos).
Backups
Open the License page and tap Download a backup (.zip). It always works, even when Deck OS is read-only. Updates and uninstalling keep your data; only ./uninstall.sh --purge deletes it.
Still stuck? Email us.
We reply by email. It helps if you include:
- Linux installer or Docker
- Your Deck OS version (it's in the download's file name, like 1.0.0)
- What you tried and what happened
- The exact error message, or a screenshot
Please don't send your password or your full license key.
Email support@garlandenterprises.co