ulver2812 / aws-s3-backup

This app allows you to use AWS (Amazon Web Services) S3 as backup system for desktop environments. 🚀

Backup on AWS S3 ? Never been so easy!

Introduction

This app allows you to use AWS (Amazon Web Services) S3 as backup system for desktop environments. Like Dropbox or Google Drive app you can backup your important data on AWS S3. This desktop app allows you to configure 3 different types of backup job (One time, recurring, live) to backup your data in an S3 bucket.

• One time: the backup job will be executed only one time as programmed.
• Recurring: the backup job will be executed periodically as programmed.
• Live: any time a file associated with the backup job changes it will be transferred to the S3 bucket.

This is a cross platform app, built with Electron, so you can use it on Windows, Mac and Linux.

Requirement

This app use the AWS CLI "sync" command, this mean that you must install the AWS CLI in order to use this app.

You can find the AWS CLI installer here: Download AWS CLI

APP Settings

After installation go to settings page and configure the AWS credentials.

In order to use the app you must set an "AWS access key ID", an "AWS secret access key" and an "AWS Region" that you can create through the IAM service in the AWS console. The IAM user needs a programmatic access account with a correct read/write S3 policy attached (e.g AmazonS3FullAccess) and CloudWatch Metrics (e.g CloudWatchReadOnlyAccess). You can use any IAM S3 policy that grant access to the buckets that you want to use with the app. Here an example policy: IAM S3 example policy

Wiki

A complete and detailed documentation can be found here: https://github.com/ulver2812/aws-s3-backup/wiki

Windows executable (portable and installer)

Download here

Changelog

Check changelog

Getting Started

Clone this repository locally :

git clone https://github.com/ulver2812/aws-s3-backup.git

Install dependencies with npm :

npm install

To build for development

• in a terminal window -> npm start

This start a local development environment with hot reload

You can activate/deactivate "Developer Tools" by commenting or not win.webContents.openDevTools(); in main.ts.

To build for production

• in a windows terminal window -> npm electron:windows
• in a mac terminal window -> npm electron:mac
• in a linux terminal window -> npm electron:linux

You will find the app build files in the "app-builds" directory.

Don't forget to deactivate the "Developer Tools" by commenting win.webContents.openDevTools(); in main.ts.

Included Commands

Command	Description
npm run ng:serve:web	Execute the app in the browser
npm run build	Build the app. Your built files are in the /dist folder.
npm run build:prod	Build the app with Angular aot. Your built files are in the /dist folder.
npm run electron:local	Builds your application and start electron
npm run electron:linux	Builds your application and creates an app consumable on linux system
npm run electron:windows	On a Windows OS, builds your application and creates an app consumable in windows 32/64 bit systems
npm run electron:mac	On a MAC OS, builds your application and generates a .app file of your application that can be run on Mac

aws-s3-backup's Issues

Error with build, missing binary?

Tried to download and install this today, got this error message:

Error output:
node-pre-gyp WARN Using request for node-pre-gyp https download
node-pre-gyp WARN Tried to download(404): https://fsevents-binaries.s3-us-west-2.amazonaws.com/v1.2.7/fse-v1.2.7-electron-v2.0-darwin-x64.tar.gz
node-pre-gyp WARN Pre-built binaries not found for [email protected] and [email protected] (electron-v2.0 ABI, unknown) (falling back to source compile with node-gyp)
node-pre-gyp WARN Pre-built binaries not installable for [email protected] and [email protected] (electron-v2.0 ABI, unknown) (falling back to source compile with node-gyp)
node-pre-gyp WARN Hit error Connection closed while downloading tarball file
rm: ./Release/.deps/Release/obj.target/fse/fsevents.o.d.raw: No such file or directory
make: *** [Release/obj.target/fse/fsevents.o] Error 1
gyp ERR! build error

I'm guessing some binary is missing from S3?

Feature request - Setting to enable complete messages

Now the app only records fatal errors that occur during the backup process, it can be useful to have complete log messages as messages confirming the backup of the files, etc.

Feature Request - Add ability to bundle settings for organization deployment

Hi! I really love the work done here! Is it possible to bundle the AWS settings inside the app for automated distribution ? This would allow to not disclose the AWS credentials and may be useful foe many case scenarios (organization deployment ...) Thank you for looking into this!

Feature Request - Improving app update process

Improving app update process with progress bar (updated app download status) and new update available notification for user.

Add AWS S3 class storage during new job creation

Give the possibility to select an AWS S3 class storage during new job creation.

Storage classes reported here:

https://aws.amazon.com/s3/storage-classes/?nc1=h_ls

Feature request - Files and folder exclusion from backup job

It may be helpful to exclude files or folders from the backup job.

For example, if you have 100 files in a path and you want to backup 99 of them instead of selecting them all except the unwanted, you can just exclude the unwanted file and backup all the others.

S3 compatible service support

I am using minio as my private object storage server. If you could add support for S3 compatible server, that would be wonderfull.

Thanks