Federated_Computer/coredesktop
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Page: Configure
Pages
Configure Items Configure Home How CoreDesktop Works Installing Migrations Sandboxed AI Agents Sibling Projects Software and Settings Troubleshooting Update Hooks Updating
Clone
1
Configure
David Young edited this page 2026-10-26 16:01:09 -06:00
Table of Contents

Configure

Some of what CoreDesktop installs needs you to sign in or make a choice first. Run:

configure

It lists each item as done or to do. Choose a number to set one up, a to set up everything still to do, or q to quit. It's safe to run again: finished steps show as "already set up" and are skipped.

configure            # menu
configure core       # set up one item by name
configure --list     # show what's set up, and the item names

Federated Computer Core (configure core)

It asks for:

  • your Superpanel's address, e.g. https://superpanel.example.com
  • your Core email address
  • your name, as shown on email you send
  • your Core password, if Nextcloud, email or files still need setting up

Then it offers each of these in turn:

Step What it does
Superpanel Adds Superpanel to your applications
Tailscale Joins this computer to your Core's Tailscale network (headscale.<domain>). It prints a link to open and sign in.
Nextcloud Adds Nextcloud to GNOME Online Accounts, for calendar, contacts and files
Email Adds your Core email to GNOME Online Accounts
Files Mounts your Nextcloud files at /mnt/<domain>, shown as <domain> in the Files sidebar
Element Points Element at your Core's Matrix server, so you only need to choose "Sign in"

What you entered is saved in ~/.config/coredesktop/core.conf, so next time the answers are filled in for you.

Passwords

Your Core password is only used while configure runs. For Nextcloud and the files mount, configure creates a Nextcloud app password instead of storing your Core password. It shows in Nextcloud under Settings > Security as "CoreDesktop on ", where you can revoke it. Email uses your Core password, which GNOME keeps in its keyring.

Your Nextcloud files

The files are mounted with davfs2:

  • They're mounted each time you log in to the desktop, not at boot, and not for SSH-only logins.
  • If they aren't mounted, run mount /mnt/<domain>.
  • Mounting without sudo requires you to be in the network group. configure adds you, but the group only takes effect at your next login.

See Troubleshooting if the folder is empty.

AI agents

Item What it asks
configure claude Whether you pay with a Claude subscription or the Anthropic Console, then signs you in
configure opencode Which AI providers to sign in to. Pick models inside opencode with /models.
configure hermes Nous Portal, or another provider such as OpenRouter, OpenAI or Anthropic

See Sandboxed AI Agents for how the agents run.

Using CoreDesktop

Working on CoreDesktop