Skip to main content

Connecting Koofr

This guide walks you through connecting a Koofr storage destination to Pluton.

Prerequisites​

Before connecting Koofr, you need:

  1. A Koofr account - Sign up here
  2. An app password generated from your Koofr account settings

Getting Your Credentials​

Step 1: Create a Koofr Account​

  1. Go to Koofr and sign up for an account
  2. Verify your email address and log in

Step 2: Generate an App Password​

  1. Log into the Koofr web application
  2. Go to Preferences (click your profile icon → Preferences)
  3. Navigate to the Password section (or go directly to app/admin/preferences/password)
  4. Under App Passwords, enter a name for the password (e.g., "Pluton Backups")
  5. Click Generate
  6. Important: Copy the generated app password immediately — it is shown only once

Connecting to Pluton​

Pluton Koofr

Step 1: Add Storage​

  1. In Pluton, navigate to Storages
  2. Click Add Storage button
  3. Select Koofr from the provider list

Step 2: Configure Connection​

Fill in the required fields:

  • Storage Name: A friendly name (e.g., "Koofr Backups")
  • Storage Provider: Choose your storage provider:
  • Username: Your Koofr account email address
  • App Password: The app password you generated in Step 2

Step 3: Advanced Options (Optional)​

Additional settings available:

  • API Endpoint: The Koofr API endpoint to use. Only needed when using the Custom storage provider
  • Mount ID: The mount ID of the mount to use. If omitted, the primary mount is used. Useful when you have connected external services (like Dropbox or Amazon Drive) to your Koofr account
  • Set Modification Time: Whether the backend supports setting modification time (enabled by default). Set to false if you use a mount ID that points to a Dropbox or Amazon Drive backend, as those do not fully support modification times

Step 4: Test and Save​

  1. Click Test Connection to verify credentials
  2. If successful, click Save
  3. Your Koofr storage is now ready for backup plans

Common Issues​

Invalid App Password: Make sure you are using an app password, not your regular Koofr login password. App passwords are generated in the Preferences → Password section.

Wrong Username: The username should be your Koofr email address (the one you use to log in).

Password Shown Only Once: If you lost your app password, you cannot recover it. Delete the old app password in Koofr Preferences and generate a new one.

Mount ID Issues: When using a Mount ID to access connected external services (e.g., Dropbox connected through Koofr), some features like modification time may not work. Disable Set Modification Time in advanced options for these mounts.

Digi Storage Connection: If using Digi Storage, select the Digi Storage provider option — do not use Custom with a manual endpoint.

Best Practices​

  • Generate a dedicated app password for Pluton — avoid reusing passwords across services
  • Use a descriptive name when generating the app password so you can identify it later in Koofr Preferences
  • Koofr offers 10 GB of free storage — consider upgrading for larger backup needs
  • When connecting external storage services through Koofr's mount feature, test thoroughly to ensure compatibility
  • Use the primary mount (leave Mount ID empty) for the simplest setup
  • Regularly review your app passwords in Koofr Preferences and remove any that are no longer in use