2020-08-23 08:53:03 +02:00
# Upgrade or uninstall
## Upgrading
2020-08-28 10:13:46 +02:00
### Note for users upgrading from Version 2 to Version 3
To upgrade from Version 2.x to Version 3.x you should be able to simply follow the _Upgrading with pypi_ instructions below. However the safest procedure is:
1. save a copy of your `config.yaml` file somewhere safe
2. run `pip uninstall ephemetoot`
3. run `pip install ephemetoot`
4. do a test run with `ephemetoot --test`
2020-08-26 13:57:13 +02:00
### Upgrading with pypi
2020-08-28 10:13:46 +02:00
To upgrade to a new version, the easiest way is to use pip to download the latest version from pypi (remembering that for your machine you may need to substitute `pip` for `pip3` ):
2020-08-26 13:57:13 +02:00
```shell
2020-08-28 10:13:46 +02:00
pip3 install --upgrade ephemetoot
2020-08-26 13:57:13 +02:00
```
2020-08-23 08:53:03 +02:00
### Upgrading with git
To upgrade to a new version using git, run the following from inside the `ephemetoot` directory:
```shell
git fetch --tags
2020-08-26 13:57:13 +02:00
git checkout [latest-tagname]
2020-08-28 10:13:46 +02:00
pip3 install .
2020-08-23 08:53:03 +02:00
```
### Upgrading with a ZIP file
2020-08-26 13:57:13 +02:00
To upgrade without using git or pypi:
2020-08-23 08:53:03 +02:00
* put your config file somewhere safe
* download and unzip the zip file into your `ephemetoot` directory over the top of your existing installation
* move your config file back in to the ephemetoot directory
* run `pip install .` from within the directory
## Uninstalling
Uninstall using pip:
```shell
2020-08-28 10:13:46 +02:00
pip3 uninstall ephemetoot
2020-08-23 08:53:03 +02:00
```
If you scheduled a `launchd` job on MacOS using `--schedule` , you will also need to unload and remove the scheduling file:
```shell
launchctl unload ~/Library/LaunchAgents/ephemetoot.scheduler.plist
rm ~/Library/LaunchAgents/ephemetoot.scheduler.plist
```
---
2020-08-26 13:57:13 +02:00
* [Home ](/ )
2020-08-23 08:53:03 +02:00
* [Installation ](./install.md )
2020-08-26 13:57:13 +02:00
* [Options ](./options.md )
* [Contributing ](./contributing.md )