Uninstall Intentic
Take Intentic off a computer the way you remove any program, or with one command in a terminal. Both show what they found first, and ask before they remove anything.
On this page(6 sections)
Two ways to start
- Windows Settings. Open Apps, find Intentic in the list and choose Uninstall. Intentic's uninstaller opens on a page with the two choices below.
- A terminal, on any system. Run one command on the computer you want to clean up:
curl -fsSL https://intentic.dev/uninstall | shirm https://intentic.dev/uninstall | iexThe command uses the ic already on the computer, whether you installed it or the desktop app carries it. It downloads ic only when there is none, then runs ic uninstall, which does the rest. Where ic is installed, ic uninstall on its own is the same thing. Running it twice is safe: the second run finds what is left and removes only that.
On a Windows PC, run it in PowerShell rather than inside a WSL distro. Removing everything from the Windows side also removes Intentic from the PC's WSL distros.
On Linux, removing the desktop app's package (sudo apt remove intentic, sudo dnf remove intentic, or your software center) removes the app alone. A package cannot reach into your home folder, where your sandboxes, the machine agent and folder sync live, so it says so and points you to the command above. Run it as yourself, not as root: it removes the app's package too, so it can be the only step. An AppImage has no uninstaller, and the same command removes it with the rest.
The two choices
First it lists what it found: the sandboxes and runners and the space they use, saved passwords, the Intentic engine, the machine agent and the folders it syncs, the desktop app, and the caches. Then it asks one question with two answers, and the first one is already selected:
- Remove everything. Nothing of Intentic stays on this computer.
- Keep my sandboxes. The sandboxes stay and keep running, and so does what runs them. Only the desktop app, folder sync and the caches go.
| On this computer | Remove everything | Keep my sandboxes |
|---|---|---|
| Sandboxes and runners, with their files | Deleted | Stay, and keep running |
| Saved passwords, in the keyring on this computer | Deleted | Stay |
| The Intentic engine (Windows) | Removed | Stays |
| The machine agent, intentic-machine | Removed | Stays |
| Folder sync | Stopped and removed | Stopped and removed |
| ic, the command-line tool | Removed | Stays |
| The desktop app | Removed | Removed |
| Caches | Deleted | Deleted |
| Intentic's other files and logs | Deleted | Stay |
Removing everything deletes the sandboxes for good, including any you removed in the last 7 days that could still have been restored. So when there are sandboxes, pressing Enter is not enough: the terminal asks you to type how many there are, and the Windows uninstaller asks you to confirm. Until you do, nothing has been deleted.
Keeping your sandboxes keeps everything they need to run: the engine they run on, the machine agent that starts them when you sign in and keeps them connected, ic, and the keyring their agents use. To take the rest off later, run the uninstall again and choose Remove everything.
If you also run your own containers on the Intentic engine (connected to a WSL distro with ic engine wsl), the engine stays even when you remove everything, and the summary says how to remove it yourself.
What always stays
These are either yours or shared with other programs on the computer, and an uninstall cannot tell what else depends on them. The summary at the end lists the ones this computer has.
- Docker Desktop. Other containers and tools may use it. If nothing else needs it, uninstall it from Windows Settings like any other program.
- WSL and its Windows features. Other Linux distros may live there, and turning the features off needs a restart. Intentic's own distro, the engine, is removed with everything else.
- Your membership of the
dockergroup on Linux. Your owndockercommands may rely on it.sudo gpasswd -d $USER dockerremoves it. - The files in the folders you synced. Uninstalling stops the syncing and leaves the files where they are. After Remove everything, the copy on this computer is the only one left.
~/intentic/local. The folder the desktop app opens when you have not picked one. What you saved there is yours.
An uninstall only touches the computer it runs on. Sandboxes Intentic hosts for you, your account, and servers you connected for deployments are left as they are.
Flags
Add them to ic uninstall, or after the one-liner. In PowerShell, | iex cannot pass flags, so run the script as a scriptblock and spell them -DryRun, -KeepSandboxes, -Yes, -DeleteData and -Confirm <n>:
# See what would go, and change nothing.
curl -fsSL https://intentic.dev/uninstall | sh -s -- --dry-run
# With ic installed, the same command without the download.
ic uninstall --dry-run& ([scriptblock]::Create((irm https://intentic.dev/uninstall))) -DryRun| Flag | What it does |
|---|---|
--dry-run | Lists what it found and what each choice would remove, and removes nothing. It also says the number --confirm needs. |
--keep-sandboxes | Picks Keep my sandboxes without the question. On a terminal it still asks yes or no, unless you add --yes. |
--yes | Answers the question without asking it. With sandboxes or saved passwords on the computer it keeps them, as Keep my sandboxes does. With neither, it removes everything. |
--delete-data --confirm <n> | Picks Remove everything, sandboxes and saved passwords included. <n> is the number of sandboxes and runners on the computer, counting removed ones that could still be restored. A different number stops the run before anything changes. With saved passwords and no sandboxes, --delete-data --yes does the same. |
Unattended
A run nobody answers never deletes a sandbox or a saved password unless you name the deletion. That covers --yes, a terminal-less run, and a silent uninstall from Windows (the uninstaller's /S, as software-management tools run it). Each of these keeps the data and does what Keep my sandboxes does. To delete it unattended, say so with --delete-data, and give the count:
# Keep the sandboxes and saved passwords. Remove the app, folder sync and the caches.
ic uninstall --keep-sandboxes --yes
# Delete everything, data included. 3 is how many sandboxes and runners --dry-run counted.
ic uninstall --delete-data --confirm 3A run with no terminal and none of these flags stops before it changes anything, and names the flag that would answer. It ends with 0 when it finished or you said no, 1 when a step failed or nobody was there to answer (the last lines say which step and what to do), and 2 when the command line itself was wrong.
One sandbox, or a server
To take a single sandbox off a computer and keep Intentic, use remove. It lists the sandboxes and removes the one you pick, and ic sandbox restore <name> brings it back within 7 days:
curl -fsSL https://intentic.dev/remove | shA server you connected for deployments is not touched by uninstalling Intentic from your own computer. On the server, run:
curl -fsSL https://intentic.dev/cleanup-host | sudo shIt runs ic machine remove, which lists what Intentic put on the server and asks once. Then it removes the deployed services and their volumes (databases included), /opt/intentic, the SSH tunnel connector and the service user. It keeps Docker Engine, the SSH server and the cloudflared program. It cannot reach your Cloudflare account, so remove the server on the Infrastructure page too and apply: that deletes its tunnels and DNS records.
Related pages
- Your own machine: what the machine agent, folder sync and a runner do while they are installed.
- Docker setup: the containers and volumes a sandbox is made of, which Remove everything deletes.
- Troubleshooting: when the problem is a sandbox that stopped answering, not Intentic itself.