- Mac OS 🍎
- Docker 🐳
In order to maintain your configuration (credentials, etc.) it is necessary that you follow the upgrade instructions below. Otherwise, you will need to reconfigure your crul installation after upgrading.
Step 1: Download latest crul version
crul-vx.x.x.tar.gz of the crul version you wish to install onto the same machine as current crul. The latest version of crul can be downloaded from the Account page.
Step 2: Backup crul
Optional but highly recommended
Make a copy of the current crul installation.
Step 3: Expand TGZ into existing crul
In a CLI, navigate the directory containing the
Run the following command to expand the
crul-vlatest.tar.gz file and upgrade crul. State (scheduled queries, secrets, etc.) will be maintained.
osascript -e 'quit app "crul"' \
&& tar -xzf crul-vlatest.tar.gz -C /Applications \
&& rm -rf ~/Desktop/crul.app \
&& mv /Applications/crul.app/ ~/Desktop/
Step 4: Open the crul application
Open the crul application located in the
~/Desktop/ directory. It will prompt itself to move to the
/Applications, once confirmed, crul will restart with the update applied.
If crul becomes stuck during initialization or exits suddenly, try restarting crul.
If you have a more complex directory structure, the above CLI command is described below
osascript -e 'quit app "crul"'
Close any running instance of crul.
tar -xzf crul-vlatest.tar.gz -C /Applications
Untar the latest crul version into the existing app, this will overwrite files that have changed, while leaving configurations untouched.
rm -rf ~/Desktop/crul.app
Remove any stale copies of crul from the
mv /Applications/crul.app/ ~/Desktop/
Move the crul application to
Desktop. Due to Mac OS security requirements, a downloaded application must move itself into
Applications to run, so this will move crul out so we can move it back into
To preserve state between upgrades, ensure you either running the
docker run command from the same directory each time, or have replaced the default
$(pwd) path with an absolute path.
See the installation instructions for more.
Step 1: Download the latest crul version
crul-docker-vx.x.x.tar.gz of the crul version you wish to install onto the same machine as current crul. The latest version of crul can be downloaded from the Account page.
Step 2: Load and run the upgraded image
Follow the installation instructions to load the upgraded image and run using the same command.
To preserve state