Attach your own computer

Three sources to choose from

“Add a space” offers three sources. They differ in where you can reach them from and whether other people can join.

Attach to cloud

1. On the computer you want to reach

   Sign in to Mirasim. In a window on this computer, click the space name at the top of the sidebar › Space settings › Remote access, and turn on “Attach to cloud”. “Add a space” › “Your own computer” has the same switch.

2. Confirm

   While the computer sleeps or Mirasim is closed, it shows as offline.

3. Reach it from anywhere

   On another computer or the phone, signed in to the same account, it is in the space list as “My computer” and opens in its own window.

Turn the switch off at any time and the computer shows as offline; its space and members stay, and come back when you turn it on again. On a computer that will not attach, the switch says why: not signed in, the account's limit of attached computers reached, or attaching not enabled for the account.

A Linux server without a desktop

On a server without a desktop, one command installs Mirasim, signs in and attaches it. SSH into the server and run it in the server’s own terminal (not on your laptop or in a team space):

curl -fsSL https://mirasim.ai/install.sh | sh

1. Install

   Installs the stable Mirasim command-line build, adding tar and xz with the system’s package manager if they are missing.

2. Sign in

   Email and a one-time code, typed at the same terminal. Use the account you sign in with on your other devices.

3. Run as a service

   With systemd it keeps running after you leave SSH and comes back after a reboot. Without systemd it runs as a background process; after a reboot, run the command again.

4. Attach to cloud

   Sign in to the same account on your desktop or phone and the server is in the list, ready to share with members like any other computer.

# run again: upgrade in place, the sign-in is kept
curl -fsSL https://mirasim.ai/install.sh | sh
# install and sign in, attach later
curl -fsSL https://mirasim.ai/install.sh | sh -s -- --no-attach
# is it attached?
mirasim ui-cli --port 4939 machines attach status
# detach, remove the service and the files (keeps ~/.mirasim)
curl -fsSL https://mirasim.ai/install.sh | sh -s -- --uninstall

Sharing it with members

Once attached, “Share with members…” under the switch opens this computer's Space settings › Members, which work exactly as in a team space (chapter 11); the people you add see it as “<your name>’s computer” in their space list.

• Members can pick the models you share with “Share with members”, billed to that key, and use space credit once you turn it on (chapter 11). The sign-ins on this computer stay for you and your admins.
• You, and admins you appoint, get the same settings as at the computer itself, including its sign-ins and keys.

Sharing the desktop (macOS)

Under “Attach to cloud” is a second switch, “Share desktop”. With it on, anyone who can reach this computer can see its screen through “Remote desktop” on the tool rail at the right of the window, and control it with their keyboard and mouse.

1. Turn on Share desktop and confirm

   They see everything on the screen, including your windows, chats and notifications.

2. Grant Screen Recording

   So they can see the screen.

3. Grant Accessibility

   So their keyboard and mouse work.

Sharing starts once both permissions are on.

Removing a computer from the list

To remove an offline computer of yours for good: space menu › All spaces › Manage spaces, click its row to open its Space settings, and under General › Danger zone choose “Delete space”. Its members and space balance are erased and cannot be restored. If “Attach to cloud” is still on at that computer, it reappears the next time it comes online, so turn the switch off there first.