Setup Guide

File/Folder Sharing using Form based Authentication


Make sure NirvaShare is installed in any of your cloud platforms or on-premise environment. In case if you do not have one, please check HERE for more options.

File sharing using Form-Based Authentication

Once the installation and basic configuration are done, the next step is to browse the storage file/folder and share it with users. In this tutorial, we will create a Share for a folder with simple Form-based authentication.

  • Click on the Storage tab on the left side menu.
  • Your storage files will be listed here, browse through any file or folder, and select Share by right clicking on it.
  •  This will bring up existing shares if any. There can be one or more Shares for File/Folder with different access rights.
  • Let us create a new one, click on Create New Share.
  • Provide necessary details under the Basic Info.
  • Edit on Start-Up Message if you want this message to appear when the user opens the Share. For example disclaimer message.
  • Click on the Permission tab.
  • Enable access for Can Delete, Can Upload, Can Create Folder and Can Download.
  • Email Alerts can be left blank as email is not configured yet.
  • on Authentication tab, select Form Based Authentication. Click on New to create a new login profile.
  • Please note that login profiles can be reused across multiple Shares.
  • Provide a Credentialssave it and thereby select the newly created authentication profile for the this Share.
  • Click on Create Share and this share is ready to be shared with users.

The new share that we just created against a file/folder can be shared to your users.

  • Right click on the newly created share and select Copy URL, this is the URL to be shared to your users. Alternatively, you can also email it from here, provided email settings are configured.
  • To test, please open the copied URL in a new private incognito browser window. This is needed because, both admin and user facing applications are running in same IP, but however during production deployment, this will not be a problem because we will be using proper domain name and and SSL.
  • Once the link is opened, it will prompt you for a username and password.
  • Provide the credentials as per the login profile. After logging in, you can perform operations such as upload, download, delete, etc on files depending on the access given.
  • To view all available shares, go to left side tab Shares.

The FREE edition supports Form, Basic and OTP based authentications. For integrating with external identity providers, and other advanced feature such as document copy protection, digital signature, etc you will have to upgrade to paid edition or make a request for trial key at HERE.

SSL and Domain name

So far, we were able to test using non-SSL, but before going to production, it is required to setup a SSL certificate and a domain name. NirvaShare requires two domains, one for administration console app and the other for user facing share service app. It would be better to have two sub domains like below.


For a proper certificate, there are multiple ways to get this done, you can try any one of the below way.

  • Obtain CA certificate for your domain from external authority.
  • Use certbot with LetsEncrypt for free certificate.

You may have to point your domain name to this IP address. To configure the certificate, you can google or refer external documentation on how to configure SSL in Ubuntu using Nginx or Apache.

Alternatively, you can also check a free app Nginx Proxy Manager for docker, which is cool app to configure free SSL with domain name in couple of minutes.

Other option is to use load balancer. Depending on the cloud platform, you can configure load balancer to have domain and SSL certificates. Refer to respective cloud platform documentation for more details.

Further any help or support needed in configuration, please contact us at HERE, we will be happy to assist you.


In this document, we discussed on how to install and configure NirvaShare to use a simple FORM based authentication. For production deployment, as mentioned this has to be fronted with SSL with proper domain name. The free version supports all storage types and authentications such as Form, Basic and OTP based. For advanced authentications using SAML and to hook with your existing Active Directory, AWS SSO, etc requires edition upgrade or a trial key. For more details on Advanced documentation, Trial key, Support, pricing, etc please contact at Click Here

7 thoughts on “Setup Guide”

    1. Hi Alex,

      It’s there as part of the roadmap and should be available in one of the upcoming release, will keep you posted.


    2. Hi Alex,

      A quick test from our team showed Backblaze works fine with NirvaShare. Here are the storage details.

      Storage Type: S3 compatible
      Storage Access Key:
      Storage Secret Key:
      Endpoint URL:
      Bind region name to endpoint url: Unchecked

      If you face any issues or have more questions, please reach out to us


    1. Hi Chris, At present this functionality don’t exists, but PM may consider in future and timeline not defined yet.

  1. Hi,

    can I attach multiple storages (buckets) to the single instance? I mean, I don’t want to create subfolders at one bucket for users but I want to create one bucket for one users everytime and make it accessible for this one user only.

    1. Hi Dezider,

      Yes possible, everytime you create a new bucket, a new share have to be crated and reuse the same login profile. Instead of sharing the share URL to the user, you can share a URL based on login profile. Goto Login Profiles tab, select the login profile and copy URL or email. This URL can open multiple shares (buckets) for users.

      Hope that answers your query.


Leave a Comment

Your email address will not be published.