Skip to content

Latest commit

 

History

History
76 lines (45 loc) · 3.45 KB

README.md

File metadata and controls

76 lines (45 loc) · 3.45 KB

OneDrive Backup Plugin

Automatically upload OctoPrint backups to OneDrive when they are created.

Installation

Install the plugin via the bundled Plugin Manager or manually using this URL:

https://github.com/cp2004/OctoPrint-OneDrive-Backup/releases/latest/download/release.zip

Warning: This plugin requires Python 3.7 or newer to install. To find out more about upgrading your OctoPrint install to use Python 3, you can take a look at this post

Warning 2: Don't try installing this plugin from the source code on GitHub, since it has a separate build step for the frontend code. If you are insterested in installing from source to contribute, please see the contributing guidelines

Configuration

Once the plugin is installed and loaded, you can set it up to connect to your Microsoft account.

Adding your account

Add account

Select 'Add account' to generate a login code. Head to the URL linked to login with your account, entering the code generated and logging in with your Microsoft account. Grant OctoPrint OneDrive Backup access to your files.

Once this is done, return the plugin, and it should show your account name & a success message.

Login done

Configuring the backup upload

Select Folder

You can then configure the folder to save backups to. Select 'Change Folder' and then you should be able to navigate through your OneDrive folders to find somewhere for backups to be saved.

Backup upload progress

Maybe give it a test after configuring it - head to the backup & restore tab and create a backup. Upload progress will be shown in a notification in the UI.

Important Security Notice

Please be aware that this plugin stores its tokens for accessing your Microsoft account in OctoPrint's configuration folder, as expected. As a result, if your OctoPrint install (or the server it is running on) is compromised, your files in OneDrive are at risk.

It is not recommended to use this plugin on OctoPrint installs accessible directly from the internet, or multi-user installs where you may not trust every user.

The author of this plugin is not responsible for any damage caused as a result of using this plugin.

Contributing

Please see the contributing guidelines for more information.

Sponsors

As well as 2 others supporting me regularly through GitHub Sponsors!

Supporting my efforts

GitHub Sponsors

I created this project in my spare time, and do my best to support the community with issues and help using it. If you have found this useful or enjoyed using it then please consider supporting it's development! ❤️. You can sponsor monthly or one time, for any amount you choose.

Check out my other plugins

You can see all of my published OctoPrint plugins on the OctoPrint Plugin Repository! Or, if you're feeling nosy and want to see what else I'm working on, check out my GitHub profile.

☁️