Desktop Application

A desktop application built using Koneksi API services.

Installers: Windows and MacOs

Login & Authentication

  1. Open the app.

  2. Enter your email and password.

  3. Click the “Log In” button on the screen.

  1. If you have 2FA enabled, you will be redirected to the MFA verification screen.

  1. Enter the code from your authenticator app.

Password Reset

  1. Click "Forgot Password?" on the login screen.

  1. Enter your email and click "Send Reset Code."

  2. Check your email for the reset code.

  1. On the "Create New Password" screen, enter the reset code.

  2. Enter a new password (8+ characters, 1 uppercase, 1 number, 1 special character: @#$%^&*()-+).

  3. Confirm the password and click "Reset Password."

Change Password

  1. Go to 'Settings' Page

  2. Enter Current Password

    • Input your existing password to verify your identity.

  3. Enter New Password

    • Create a new password that follows the requirements listed below.

  4. Confirm New Password

    • Re-enter the new password to ensure it matches.

    • Password Requirements

    • Be at least 8 characters long

    • Include at least one uppercase letter (A–Z)

    • Include at least one lowercase letter (a–z)

    • Include at least one number (0–9)

    • Include at least one special character (e.g., !@#$%^&*)

If the new password fail to meet requirements, one of the password requirements highlight into red.

If the new password and confirmation do not match, an error message will be shown.

Multi Factor Authentication

  1. Go to the 'Settings' page

  2. Under 'Account Security', hit the toggle to turn on the Two-Factor authentication

  1. Follow the MFA Setup instructions that pops up on the screen.

  1. Once MFA is setup, enter the Verification Code and click on the 'Verify' button to proceed.

  1. Once MFA is verified, you will see a confirmation message on your screen.

Dashboard

This screen offers real-time insights and quick access to critical functions.

Key Features:

  • Storage usage and backup progress visualized through pie charts and progress bars.

  • Intuitive quick-access buttons for core functionalities.

Backups Explorer

This screen is where users are able to search, manage, and retrieve backed-up files efficiently.

Key Features:

  • Folder tree view with file icons indicating backup status.

  • File metadata display, version history navigation, and preview/download options.

  • Bulk download functionality for folders.

  • Has drag and drop feature for easier uploading.

Uploading Files

  • To upload a file, click the 'Upload' button and select 'File'.

    • There are two options to upload files:

      • Drag and Drop the files to the system

      • Click the [Select files] button to open the 'System File Picker'

        • Select the preferred file and click [Open] button to start uploading

  • Click the [Upload file] button

Previewing a File

  • Each files uploaded have an action item on the rightmost side of it.

  • Click on the 'Preview' button and a file preview will then appear on your screen

  • Different previews will display for different file types.

Creating a new folder

  1. Click the [New Folder] button

  2. Enter folder name

  3. Click [Create] button

  4. Created folder will be added to the My Backup list

Uploading a Folder

  • To upload a folder, click the 'Upload' button and select 'Folder'.

    • Select the preferred folder and click [Open] button to start uploading

Searching Files and Folders

  • Click [Search] field and input valid value

    • Typing in the search field supports autosuggest based on the input.

  • Click [Search] field and input invalid value

File Sharing

  1. File Sharing via Password

    1. Only Koneksi-registered users can open password-protected files.

    2. Anyone without an account will be restricted from access, even with the correct password.

  2. File Sharing via Link with Expiration

    1. You can now generate shareable file links that expire after a set time.

    2. Anyone with the link can access the file until it expires.

    3. Once expired, users will see a message letting them know the link is no longer available.

  3. File Sharing via Email

    1. Files can be sent directly to Koneksi-registered email addresses only.

    2. This ensures only verified users receive and open shared files.

  4. File Encryption

    • When uploading, you’ll now see an “Encrypt File” toggle option.

    • Turning it on will prompt you to set a passphrase that will be required to access the file later.

    • Only users who enter the correct passphrase can view or download the encrypted file.

    • Encrypted uploads are currently limited to 50MB per file.

Other actions you can do with files and folders

  1. Download: User should be able to download the file to local machine

  2. Rename: User should be able to update the existing name in the list

  3. Move: User should be able to move the file to the desired folder

  4. Delete: User should be able to delete the existing file/folder in the list

  5. View Chunks: User should be able to view the individual chunks that make up a file on IPFS, shown in a tree structure using the file’s content identifier (CID)

Realtime backups (Development in Progress)

Enabling Realtime Backups

  1. Open the desktop app and click on the "Settings" tab from the sidebar

  2. Select a Backup Location

  1. A "Confirm Real-Time Backup" window will appear, showing the target directory, number of files, total size, and available storage. Ensure you have enough storage space as indicated by the confirmation message.

  1. Click the "Confirm" button to start the initial backup. Once confirmed, any future changes in the selected directory will be backed up automatically.

Disabling Realtime Backups

  1. Select the option to clear the current backup location

  1. A "Clear Backup Location" window will appear, informing you that this action will stop the real-time backup, remove the path from settings, and require a new location to resume backups. It will also confirm that existing backup files won’t be deleted.

  2. Click the "Clear Backup Location" button to proceed, or select "Cancel" to keep the current settings.

Recovery Management (Development in Progress)

This screen facilitates full or selective data recovery with user-defined configurations.

Key Features:

  • Calendar-based recovery point selection.

  • Customizable recovery destination paths.

  • Real-time status updates and retry mechanisms for failed requests.

Warnings & Notifications (Development in Progress)

This screen provides clear communication on warnings and system alerts for proactive decision-making.

Key Features:

  • Search and filter functionality for enhanced usability.

  • Detailed notification pop-ups with root cause analysis.

  • Graphical representation of warning trends.

API Key Management

This screen is where users allows users (typically Admins or Developers) to manage Service Accounts used for automation, integrations, or server-to-server communication.

  1. Create New API Key by clicking on the '+ New API Key' button.

  1. Add API Key name and select permissions on the Create New API Key form

  1. Once an API Key is generated, a Client ID and Secret Key will be generated. These keys acts as access credentials for service account users.

  1. Save the keys in a secured location.

You can user this Keys to interact with Koneksi API services programatically, here's the documentation.

Settings

This screen allows users to enable 2FA and change their password.

Key Features:

  • Change user password option and account security

PreviousStandard User GuidesNextWeb Application

Last updated