Skip to main content

List and delete hosts

  • Hosts register themselves, so there’s no command to add one.
  • To delete a host, delete its rigs first. You can also delete it from Hosts in the sidebar.
  • If you delete only the host record, the machine registers again on its next amika-hostd up.

Take a host offline

Run amika-hostd down on the machine. It stops the daemon and its VMs, and keeps their disks. The next amika-hostd up starts the daemon but not the rigs. Start them with amika rig start.

Rigs on a host that is gone

Deleting a rig needs its host to answer. If the host is offline, the delete fails and the web UI offers Remove from Amika only. That removes Amika’s record of the rig, but leaves anything running on the machine for you to clean up. The HTTP API does the same with DELETE /api/v0beta1/rigs/{id}?forget=true.

Update the daemon

Run the installer again, then restart the daemon. The installer keeps your config and secrets:
up installs anything the new release needs, such as a newer amikad. amika-hostd down stops the host’s VM rigs too. Start them again with amika rig start.

Uninstall the daemon

On the host, run the installer with --uninstall:
The uninstaller:
  1. Shows what it found and asks you to confirm.
  2. Asks whether to remove the config, state, and keychain secrets.
  3. Stops the daemon and deletes the host’s Lume rigs.
  4. Asks you to type a phrase before it deletes each of these:
    • The macOS images: remove macos images.
    • The macOS restore image: remove macos restore image.
    • smolvm: remove smolvm.
  5. Deletes amika-hostd, its files, and anything you said yes to.
It leaves Lume, since other tools may use it, and tells you where it is. No flag deletes smolvm, the macOS images, or the macOS restore image.
Uninstalling changes nothing in Amika. The host stays registered and its API key still works. Delete the host with amika host delete, and revoke the key under Settings → API Keys.

Installer options

Put flags after sh -s --, for example curl -fsSL .../install-amika-hostd.sh | sh -s -- --dry-run.
  • AMIKA_INSTALL_DIR sets where the amika-hostd command goes (default /usr/local/bin).
  • AMIKA_HOSTD_HOME sets where the daemon’s files go.