Files
Libation/docs/installation/mac.md
2025-12-16 13:06:44 +05:30

43 lines
1.7 KiB
Markdown

# Install on MacOS
This walkthrough should get you up and running with Libation on your Mac.
> [!WARNING] Supports macOS 13 (Ventura) and above
### Install Libation
- Download the file from the latest release and extract it.
- Apple Silicon (M1, M2, ...): `Libation.x.x.x-macOS-chardonnay-`**arm64**`.dmg`
- Intel: `Libation.x.x.x-macOS-chardonnay-`**x64**`.dmg`
- Mount the dmg and open the disk folder (should open automatically). Drag-drop the Libation app into your Applications folder.
![macOS-drag-drop-install](../images/macOS-drag-drop-install.png)
- Go to your applications folder and double-click Libation to start it. The first time you run Libation, you'll be asked if you want to run this program downloaded from the internet. Click "Open".
![macOS-libation-first-run](../images/macOS-libation-first-run.png)
## Running Hangover
Libation comes with a recovery app called Hangover. You can start it by running this command:
```bash
open /Applications/Libation.app --args hangover
```
## Running LibationCli
Libation comes with a command-line interface. Unfortunately, due to the way apps are sandboxed on mac, its use is somewhat limited. To open a new sandboxed terminal in LibationCli's directory, run the following command:
```Console
open /Applications/Libation.app --args cli
```
To use LibationCli from an unsandboxed terminal, you must disable gatekeeper again and run the program directly at `/Applications/Libation.app/Contents/MacOS/LibationCli`
Then use `./LibationCli` to execute a command.
## Get Libation Running on Mac
<video src="https://user-images.githubusercontent.com/37587114/219271379-a922e4e1-48a0-48e4-bd81-48aa1226a4f5.mp4" controls></video>