Volume Console Guide
This page is a complete guide to the Volume, the single entity of the Namirasoft NWS Volume Console. You will learn what a volume is, the problem it solves, how a volume connects to your storage, and every field you configure when you create one.
What Is a Volume?
A volume is a single storage location that Namirasoft NWS Volume manages for you. A volume can point to storage you already own on an external platform, such as object storage, a file share, or an SFTP server, or it can point to storage that Namirasoft hosts for you. In every case you work with the volume the same way, through one console and one API.
Each volume belongs to a workspace and is created in a region, and it can be linked to a log group that records its activity. Once a volume is ready, your applications and databases read and write to it directly, so storage is available wherever it is needed.
The Problem Volume Solves
Most teams keep files in more than one place. Some data sits in cloud object storage, some on file shares, some on SFTP servers, and some on connected drives. Managing each platform on its own is slow, and access works differently for each one.
Namirasoft NWS Volume brings these together:
- Storage spread across platforms : Connect the storage you already use across many providers and manage all of it from one place.
- Inconsistent access : Give applications and databases one consistent way to reach any volume, whatever it points to.
- Owned and hosted storage together : Keep using storage you already own, or create storage hosted by Namirasoft, side by side.
- Organization and visibility : Track every volume with clear names, descriptions, regions, categories, and tags.
How Namirasoft NWS Volume Manages a Volume
You create a volume by choosing a storage type, naming it, selecting a workspace and region, and filling the fields that the type requires. Types that connect to an external platform use a credential you store in the Namirasoft Credential app, so secrets stay in one secure place and can be reused across volumes. Types hosted by Namirasoft ask only for the capacity you need.
After you save, the volume moves through a short setup sequence, reported as a status that goes from Pending to In Progress and then Ready when the volume can be used. The sections below describe the general fields shared by every type, followed by the fields specific to each storage type.
Overview of Volume Fields and Options
Below is a detailed explanation of the fields available when creating or managing a Volume. Understanding these fields helps ensure your Volume is configured correctly for your requirements.
When you enter a sensitive value, such as a secret key, an API key, or a password, Namirasoft NWS Volume stores it in Namirasoft Secret, which encrypts it so it is never kept as plain text. To learn how Namirasoft Secret keeps your data safe, visit its website.
- ID (String) : This is a unique ID that Namirasoft NWS Volume assigns to the volume automatically once it is created. You do not set this yourself; it is used internally to reference the volume in the console, the API, and the CLI.
- User ID (Namirasoft Account’s ID) : This is the unique ID assigned to a user of the Namirasoft Account, which gives access to all Namirasoft apps. It ties the volume to a specific user for access control and history. It does not change how the storage behaves, but is used in the backend to manage permissions and ownership.
- Workspace ID (Namirasoft Workspace’s ID) : This refers to a workspace created in the Namirasoft Workspace app, which lets users group projects, teams, or environments. In Namirasoft NWS Volume the workspace name is displayed, not just the ID, and it links to the Workspace app where it shows the ID for that workspace. This keeps the volume tied to the correct environment and controls who can reach it.
- Region (Enum) : This is the location where Namirasoft NWS Volume stores the volume’s data. You choose it from the regions Namirasoft offers. Your applications and databases reach the volume over the internet from anywhere, so you pick the region that best fits where you want your data to live.
- Log Group (Namirasoft Log Group’s ID) : This identifies a log group in the Namirasoft Log app where Namirasoft NWS Volume keeps a record of the volume’s activity. When the volume is created, changed, or used, those events are written to this log group, so you can review them later for auditing and troubleshooting. Attaching a log group is optional.
- Name (String) : This is the name you give the volume to identify it in the console, the API, and the CLI, for example AppUploads or DailyBackups. A clear, descriptive name helps you recognize the volume among the others in your workspace.
- Type (Enum) : This is the storage type of the volume, which you pick from a list, for example AWS S3, SFTP, or a Namirasoft managed disk. The type decides where the data lives, and each type needs its own specific data and credentials to connect. To see the full list, view storage types.
- Description (String) : This is an optional note you write to describe what the volume is for, for example Daily database backups for the billing service. The description is for you and your team to read, and it does not change how the volume works.
- Meta (Object) : This holds the type specific settings of the volume, such as the connection details and options for the storage type you selected. Namirasoft NWS Volume fills it from the fields you complete, so you do not edit it directly.
- Status (Enum) : This shows the current state of the volume while Namirasoft NWS Volume sets it up and keeps it running. A volume begins at Pending, moves to In Progress as it is prepared, and reaches Ready when you can use it. It shows Modifying while changes are applied, and Failed if setup did not complete.
- Status Message (String) : This is a short message that explains the current status in plain words. It helps most when a volume needs attention, because it gives the reason behind a Failed or pending state.
- Created At (Timestamp) : This is the date and time when the volume was created. Namirasoft NWS Volume sets it automatically.
- Updated At (Timestamp) : This is the date and time when the volume was last changed. Namirasoft NWS Volume sets it automatically.
Storage Types and Their Fields
Namirasoft NWS Volume supports many storage types. Use the search box to find a type by name, or filter by category, then open a type to see the fields specific to it. The fields above apply to every type.
No storage types match your search.
Namirasoft Disk (Fixed Price)Namirasoft managed
This type creates a brand new storage volume that Namirasoft hosts for you on its own servers. Namirasoft sets aside a fixed amount of disk space and gives you a volume that is ready to use right away, with that space reserved and available whenever you need it. This option uses fixed pricing, and you can see the details on the Pricing page.
- Size (Integer) : Size is the amount of space you set aside for the volume, measured in gigabytes (GB). You type a number, for example 50 for 50 GB or 500 for half a terabyte. You choose the size that fits what you plan to store, and you can create a larger volume later whenever you need more room.
Namirasoft Disk (Flexible)Namirasoft managed
This type creates a brand new storage volume that Namirasoft hosts for you on its own servers. The volume grows to fit your data, so the space it uses expands as your files grow, up to a limit you set. You choose this when your storage needs change over time and you want the volume to scale with them. This option uses usage based pricing, and you can see the details on the Pricing page.
- Size (Integer) : Size is the upper limit you set for the volume, measured in gigabytes (GB). You type a number, for example 100 for 100 GB. Your files can grow up to this limit, so you set it high enough to give your data room to expand.
Namirasoft Bucket StorageNamirasoft managed
This type gives you object storage that Namirasoft creates and hosts for you, reached through the same tools you would use for Amazon S3. Object storage keeps your files as objects in a bucket, which suits backups, uploads from an application, and large collections of files. Namirasoft provides the access details you enter below when your bucket is set up, so you do not bring them from another provider.
- Provider (Enum) : This tells the system which service runs the bucket. You select the Namirasoft option, since Namirasoft hosts this bucket for you.
- Access Key ID (String) : This is the public part of the key pair that identifies your bucket, much like a username. Namirasoft provides it when your bucket storage is set up, and you enter it here.
- Secret Access Key (String) : This is the private part of the key pair that authorizes access, much like a password. Namirasoft provides it when your bucket storage is set up. You enter it here and keep it private.
- Region (Enum) : This is the location where Namirasoft stores the bucket. Namirasoft provides the region value with your bucket details, and you enter it here.
AWS S3Cloud object
This type connects a storage bucket you already have on Amazon S3, the cloud storage service from Amazon. Namirasoft NWS Volume does not create the bucket. It connects to the bucket you already own and reads and writes files in it for you, so your data stays in your own AWS account.
- Credential (Namirasoft Credential’s ID) : This is the AWS credential you saved in the Namirasoft Credential app, which holds your AWS access keys and lets Namirasoft NWS Volume sign in to your AWS account. You select it here from your saved credentials. How to create an AWS credential?
- Provider (String) : This is the S3 service your storage runs on, which you type in. You enter aws for Amazon S3. The same type also works with other S3 compatible services, so you type the matching name, such as Wasabi, Minio, or DigitalOcean, when your storage is on one of them.
- Region (String) : This is the region where your bucket was created, written as a short code such as us-east-1 for North Virginia or eu-central-1 for Frankfurt. You open your bucket in the AWS S3 console, read the region beside it, and type the same code here. It has to match the bucket exactly, otherwise the connection fails.
S3 CompatibleCloud object
This type connects a bucket on any storage service that follows the Amazon S3 standard but does not have its own entry in this list. Many providers offer S3 compatible storage, for example Wasabi, MinIO, and DigitalOcean Spaces. You connect with an access key pair from that provider.
- Provider (String) : This is the S3 compatible service your storage runs on, which you type in. You enter the name that matches your storage, for example Wasabi, Minio, or Ceph. When your provider is not one of the known names, you enter Other.
- Access Key ID (String) : This is the public part of your key pair, much like a username. Your provider shows it when you create an access key in their console. You copy it from there and enter it here. Where do I find my access keys?
- Secret Access Key (String) : This is the private part of your key pair, much like a password. Your provider usually shows it only once when you create the key, so you copy it then, paste it here, and keep it private. Where do I find my secret access key?
- Region (String) : This is the region where your bucket lives, written as a short code that your provider defines, for example us-east-1. You find it in your provider’s console next to the bucket and type the same value here. Where do I find my bucket region?
GCP Cloud Storage (OAuth)Cloud object
This type connects a bucket you already have in Google Cloud Storage, the object storage service from Google. You sign in with your Google account through OAuth, so Namirasoft NWS Volume can reach the bucket for you. The bucket stays in your own Google Cloud project.
- Project Number (Integer) : This is the unique number Google gives the project that owns your bucket, for example 415104041262. You open the Google Cloud console, look at the dashboard, and copy the number shown next to the project name into this field. Where do I find my Google Cloud project number?
- Credential (Namirasoft Credential’s ID) : This is the Google sign in you saved in the Namirasoft Credential app, which lets Namirasoft NWS Volume reach your bucket. You select it here from your saved credentials. How to get a Google Cloud Storage credential?
- Location (String) : This is where your bucket is stored, written as a Google region or multi region code, for example us-central1 or eu. You read it on the bucket’s page in the Google Cloud console and type the same value here. Where do I find my bucket location?
GCP Cloud Storage (Service Account)Cloud object
This type connects a bucket in Google Cloud Storage using a service account, which is a robot account made for servers and automation rather than a person signing in. You give Namirasoft NWS Volume a key file for that service account, and it reaches your bucket with no one logging in.
- Service Account File (String) : This is a small JSON key file that Google creates for a service account. You create the service account in the Google Cloud console, give it access to your bucket, download its JSON key, and upload that file here. How to get a Google service account file?
- Project Number (Integer) : This is the unique number Google gives the project that owns your bucket, for example 415104041262. You find it on the dashboard of the Google Cloud console, next to the project name, and enter it here. Where do I find my Google Cloud project number?
- Location (String) : This is where your bucket is stored, written as a Google region or multi region code, for example us-central1 or eu. You read it on the bucket’s page in the Google Cloud console and type the same value here. Where do I find my bucket location?
Azure Blob Storage (Key)Cloud object
This type connects a container in Azure Blob Storage, the object storage service from Microsoft Azure. It uses the simplest sign in: the storage account name plus one of its access keys.
- Storage Account (String) : This is the name of the Azure storage account that holds your data, for example mycompanydata. You find it at the top of the storage account page in the Azure portal, and you type that name here. Where do I find my Azure storage account?
- Account Key (String) : This is a long secret string that unlocks the storage account, much like a master password. You open the storage account in the Azure portal, go to Security plus networking and then Access keys, and copy key1 or key2. You paste it here and keep it private. Where do I find my Azure account key?
Azure Blob Storage (Certificate)Cloud object
This type connects Azure Blob Storage with a registered application and a client certificate. Your organization registers an app in Microsoft Entra ID, the Microsoft identity service, and adds a certificate to it, and Namirasoft NWS Volume signs in as that app.
- Tenant (String) : This is the id of your organization’s Microsoft Entra directory, a long code that you find on the Microsoft Entra ID overview page in the Azure portal. You enter it here. Where do I find my Microsoft Entra tenant id?
- Client ID (String) : This is the id of the application you registered in Microsoft Entra ID, also a long code. You find it on your app registration’s overview page in the Azure portal, and you enter it here. How to register an app in Microsoft Entra ID?
- Client Certificate Path (String) : This is the location of the certificate file on the machine that runs the connection, for example /etc/certs/azure.pem. You enter the full path so the connection can read the certificate. How to add a certificate to your Entra app?
- Client Certificate Password (String) : This is the password that protects the certificate file, if you set one when you created it. You enter that password here, or you leave it empty when the certificate has none.
- Send Certificate Chain (Boolean) : This setting decides whether the connection also sends the certificate’s full chain of trust during sign in. You turn it on when your Entra app requires the chain, and you leave it off otherwise.
Azure Blob Storage (User and Password)Cloud object
This type connects Azure Blob Storage with a registered application together with a username and password. Your organization registers an app in Microsoft Entra ID, and Namirasoft NWS Volume signs in with that app and a saved user credential.
- Tenant (String) : This is the id of your organization’s Microsoft Entra directory, a long code that you find on the Microsoft Entra ID overview page in the Azure portal. You enter it here. Where do I find my Microsoft Entra tenant id?
- Client ID (String) : This is the id of the application you registered in Microsoft Entra ID, also a long code. You find it on your app registration’s overview page in the Azure portal, and you enter it here. How to register an app in Microsoft Entra ID?
- Credential (Namirasoft Credential’s ID) : This is the username and password you saved in the Namirasoft Credential app, which Namirasoft NWS Volume uses to sign in. You select it here from your saved credentials. How to create a basic auth credential?
Oracle Object StorageCloud object
This type connects a bucket in Oracle Cloud Infrastructure Object Storage. The bucket stays in your own Oracle Cloud tenancy, and Namirasoft NWS Volume reaches it using details you read from the Oracle Cloud console.
- Provider (String) : This is the provider value for the connection, which you type in. For Oracle Cloud Object Storage you enter the standard Oracle value shown in the field help.
- Namespace (String) : This is a unique name Oracle gives your Object Storage, a short string of letters and numbers such as axh5sf3abc12. You open the Oracle Cloud console, go to Storage and then Object Storage, and read the namespace shown at the top, then enter it here. Where do I find my Oracle namespace?
- Compartment (String) : A compartment is the folder like area in Oracle Cloud that holds your bucket. You enter the name of the compartment your bucket lives in, which you find under Identity and Security and then Compartments in the Oracle Cloud console. Where do I find my Oracle compartment?
- Region (String) : This is the Oracle Cloud region where your bucket lives, written as a code such as us-ashburn-1 or eu-frankfurt-1. You read it from the region menu at the top right of the Oracle Cloud console and type the same code here. Where do I find my Oracle region?
Backblaze B2Cloud object
This type connects a bucket in Backblaze B2, a cloud storage service. The bucket stays in your own Backblaze account, and Namirasoft NWS Volume reaches it with an application key you create in Backblaze.
- Account ID (String) : This is the public part of your Backblaze application key, which Backblaze also calls the key id, a short string of letters and numbers. You sign in to Backblaze, open App Keys, create a key, and copy the key id shown there into this field. Where do I find my Backblaze key id?
- Application Key (String) : This is the secret part of the pair, much like a password. Backblaze shows it only once, right after you create the key, so you copy it immediately and paste it here. How to get your Backblaze application key?
- Hard Delete (Boolean) : This setting decides what happens when you delete a file. You turn it on to remove files permanently. You leave it off to keep earlier versions available, so you can recover them later.
QingstorCloud object
This type connects a bucket in QingStor object storage. The bucket stays in your own QingStor account, and you connect with an access key pair from the QingStor console.
- Access Key ID (String) : This is the public part of your key pair, much like a username. You create an API key in the QingStor console, and it shows the access key id. You copy it and enter it here. Where do I find my QingStor keys?
- Secret Access Key (String) : This is the private part of the pair, much like a password. QingStor shows it when you create the key, so you copy it then, paste it here, and keep it private. Where do I find my QingStor keys?
- Endpoint (String) : This is the web address of the QingStor service for your zone, for example https://s3.pek3b.qingstor.com. You take the endpoint that matches your zone from the QingStor documentation and enter it here. Where do I find my QingStor endpoint?
- Zone (String) : This is the QingStor data center where your bucket lives, written as a short code such as pek3b. You read it next to your bucket in the QingStor console and enter the same code here. Where do I find my QingStor zone?
Swift (OpenStack)Cloud object
This type connects container storage that runs on OpenStack Swift, the object storage part of OpenStack clouds. You choose it when your storage comes from an OpenStack based cloud, and you connect with the user details that cloud gives you.
- User (String) : This is the OpenStack Swift username for your account, which on some clouds looks like project:username. Your cloud provider gives you this value in your account details, and you enter it here. Where do I find my OpenStack username?
- Key (String) : This is the password or API key for that OpenStack user. Your cloud provider gives it to you, and you paste it here, keeping it private. Where do I find my OpenStack key?
- Auth URL (String) : This is the web address where OpenStack checks your sign in, for example https://auth.example.com/v3. Your cloud provider lists it in your account details, and you enter it here. Where do I find my OpenStack auth URL?
StorjCloud object
This type connects a bucket on Storj, a storage network that spreads your files across many computers for durability. The bucket stays in your own Storj account, and you connect with a single access grant that you create in Storj.
- Access Grant (String) : This is one long text string that bundles everything Namirasoft NWS Volume needs to reach your bucket: the location, the permissions, and the encryption key. You create it in the Storj console under Access, choose the bucket and the permissions, then copy the generated access grant and paste it here. How to get a Storj access grant?
Akamai NetStorageCloud object
This type connects storage on Akamai NetStorage, the storage that pairs with the Akamai content delivery network. You choose it when your files live on Akamai, and you connect with the upload account details from the Akamai Control Center.
- Host (String) : This is the web address of your NetStorage storage group, for example yourgroup-nsu.akamaihd.net. You find it in the Akamai Control Center on the storage group page, and you enter it here. Where do I find my NetStorage host?
- Account (String) : This is the upload account name that has access to the storage group. You create or find it under the storage group in the Akamai Control Center, and you enter that name here. Where do I find my NetStorage upload account?
- Secret (String) : This is the key tied to the upload account that signs each request, much like a password. You find or generate it for the upload account in the Akamai Control Center, then paste it here. How to get my NetStorage key?
Internet ArchiveCloud object
This type connects your items on the Internet Archive, the nonprofit digital library at archive.org. You choose it to manage items you store there, and you connect with the S3 like keys from your Internet Archive account.
- Access Key ID (String) : This is the public part of your Internet Archive key pair. You sign in at archive.org, open the S3 API keys page at archive.org/account/s3.php, and copy the access key shown there into this field. Where do I find my Internet Archive keys?
- Secret Access Key (String) : This is the private part of the pair, shown on the same S3 API keys page. You copy it and paste it here, keeping it private. Where do I find my Internet Archive keys?
- Item Derive (Boolean) : This setting decides whether the Internet Archive runs its derive process after you upload a file. The derive process builds extra versions, such as thumbnails or alternate formats. You turn it on to let those build automatically, or off to skip them.
Azure Files (Key)Cloud file
This type connects a file share in Azure Files, the file sharing service from Microsoft Azure that works like a shared network drive. It uses the simplest sign in: the storage account name plus one of its access keys. You choose this when you can get the storage account keys directly.
- Storage Account (String) : The storage account is the name of the Azure account that holds your share, for example mycompanydata. You find it at the top of the storage account page in the Azure portal, and you type that name here. Where do I find my Azure storage account?
- Account Key (String) : The account key is a long secret string that unlocks the storage account, much like a master password. You open the storage account in the Azure portal, go to Security plus networking and then Access keys, and copy key1 or key2. You paste it here and keep it private. Where do I find my Azure account key?
Azure Files (Connection String)Cloud file
This type connects a file share in Azure Files using a connection string, which is a single line of text that already holds the account name and key together. You choose this when you were given a connection string and prefer to paste one value instead of two.
- Connection String (String) : The connection string is one line that holds the account name and key together. It begins with DefaultEndpointsProtocol=https and then lists the AccountName and AccountKey values. You open the storage account in the Azure portal, go to Security plus networking and then Access keys, and copy the Connection string shown under key1 or key2. You paste it here. Where do I find my Azure connection string?
Azure Files (SAS)Cloud file
This type connects a file share in Azure Files using a shared access signature, called a SAS, which is a special link that grants limited, time bound access without sharing your account key. You choose this when you want access that can expire or stay restricted.
- SAS URL (String) : The SAS URL is a web address with a long token at the end that grants the access. You open the storage account in the Azure portal, go to Security plus networking and then Shared access signature, choose the permissions and the expiry, generate the SAS, and copy the file service SAS URL. You paste it here. How to get an Azure SAS URL?
Azure Files (User and Password)Cloud file
This type connects a file share in Azure Files with a registered application together with a username and password. Your organization registers an app in Microsoft Entra ID, and Namirasoft NWS Volume signs in with that app plus a saved user credential. You choose this when you sign in with a user account rather than a key or a certificate.
- Tenant (String) : The tenant is the id of the Microsoft Entra directory for your organization, a long code that you find on the Microsoft Entra ID overview page in the Azure portal, and you enter it here. Where do I find my Microsoft Entra tenant id?
- Client ID (String) : The client id is the id of the application you registered in Microsoft Entra ID, also a long code. You find it on the overview page of your app registration in the Azure portal, and you enter it here. How to register an app in Microsoft Entra ID?
- Credential (Namirasoft Credential’s ID) : A credential here holds the username and password that sign in to your Azure account. You save them once in the Namirasoft Credential app, then pick that saved credential here from a list, so you do not type the password on this page. How to create a basic auth credential?
Azure Files (Certificate)Cloud file
This type connects a file share in Azure Files with a registered application and a certificate instead of a key. Your organization registers an app in Microsoft Entra ID and adds a certificate to it, and Namirasoft NWS Volume signs in as that app. You choose this when your company requires certificate based sign in.
- Tenant (String) : The tenant is the id of the Microsoft Entra directory for your organization, a long code that you find on the Microsoft Entra ID overview page in the Azure portal, and you enter it here. Where do I find my Microsoft Entra tenant id?
- Client ID (String) : The client id is the id of the application you registered in Microsoft Entra ID, also a long code. You find it on the overview page of your app registration in the Azure portal, and you enter it here. How to register an app in Microsoft Entra ID?
- Client Certificate Path (String) : This is the location of the certificate file on the machine that runs the connection, for example /etc/certs/azure.pem. You enter the full path so the connection can read the certificate. How to add a certificate to your Entra app?
- Client Certificate Password (String) : This is the password that protects the certificate file, if you set one when you created it. You enter that password here, or you leave it empty when the certificate has none.
- Send Certificate Chain (Boolean) : This setting decides whether the connection also sends the full chain of trust for the certificate during sign in. You turn it on when your Entra app requires the chain, and you leave it off otherwise.
SFTPProtocol
This type connects a server over SFTP, which moves files securely over an SSH connection. You choose it for any server you can reach with SFTP, such as a Linux server or a managed file transfer service, and you sign in with either a password or a private key.
- Host (String) : The host is the address of the server, written as a domain name such as files.example.com or an IP address such as 203.0.113.10. Your server administrator or hosting provider gives you this, and you enter it here. Where do I find my SFTP host and port?
- Port (Integer) : The port is the door on the server that accepts SFTP connections, written as a number. You enter 22, the standard SFTP port, unless your administrator told you to use a different one.
- Credential (Namirasoft Credential’s ID) : A credential here holds the username and password for the server. You save them once in the Namirasoft Credential app, then pick that saved credential here, so you do not type the password on this page. You use this when the server signs you in with a password. How to create a basic auth credential?
- Key PEM (String) : A private key in PEM format is a block of text that starts with a line reading BEGIN OPENSSH PRIVATE KEY and ends with a matching END line, and it proves who you are without a password. You use it when the server is set up for key based sign in, and you paste the contents of your key file here. How to get an SSH private key?
- Key File (String) : Instead of pasting the key, you can point to a private key file that already sits on the machine running the connection, for example /home/user/.ssh/id_rsa. You enter the full path to that file here.
- Key File Password (String) : If your private key is protected by a passphrase, you enter that passphrase here so the key can be used. You leave it empty when the key has no passphrase.
FTPProtocol
This type connects a server over FTP, a widely supported file transfer method, with the option to add TLS encryption. You choose it for servers that use FTP, and you turn on TLS to protect the connection.
- Host (String) : The host is the address of the FTP server, written as a domain name such as ftp.example.com or an IP address such as 203.0.113.10. Your administrator or hosting provider gives you this, and you enter it here. Where do I find my FTP host and port?
- Port (Integer) : The port is the door on the server that accepts FTP connections, written as a number. You enter 21, the standard FTP port, unless your administrator told you to use a different one.
- Credential (Namirasoft Credential’s ID) : A credential here holds the username and password for the FTP server. You save them once in the Namirasoft Credential app, then pick that saved credential here. How to create a basic auth credential?
- TLS (Boolean) : This setting turns on implicit TLS, where the whole connection is encrypted from the start. You turn it on when your server expects FTP over TLS on a dedicated port, and you leave it off for plain FTP.
- Explicit TLS (Boolean) : This setting turns on explicit TLS, where the connection starts plain and then upgrades to encryption. You turn it on when your server supports FTPS on the normal FTP port, and you leave it off otherwise.
SMBProtocol
This type connects a shared folder over SMB, the protocol that Windows and Samba use for network file sharing. You choose it to reach a shared drive on a Windows server, a NAS device, or a Samba server on your network.
- Host (String) : The host is the address of the server that hosts the share, written as a name such as fileserver or an IP address such as 192.168.1.20. Your administrator gives you this, and you enter it here. Where do I find my SMB host and port?
- Port (Integer) : The port is the door on the server that accepts SMB connections, written as a number. You enter 445, the standard SMB port, unless your administrator told you to use a different one.
- Credential (Namirasoft Credential’s ID) : A credential here holds the username and password that open the share. You save them once in the Namirasoft Credential app, then pick that saved credential here. On a Windows domain the username often looks like DOMAIN\username. How to create a basic auth credential?
WebDAV (User and Password)Protocol
This type connects a WebDAV server, which shares files over the web, using a username and password. Many services, such as Nextcloud and ownCloud, offer a WebDAV address. You choose this when your WebDAV server signs you in with credentials.
- URL (String) : The URL is the WebDAV address of your server, for example https://cloud.example.com/remote.php/dav/files/username/. Your service shows this address in its settings or its WebDAV help page, and you paste it here. Where do I find my WebDAV URL?
- Vendor (Enum) : The vendor is the kind of WebDAV server you are connecting to, picked from a list, for example Nextcloud, ownCloud, or Other. You choose the one that matches your server so the connection behaves correctly, and you choose Other when you are not sure.
- Credential (Namirasoft Credential’s ID) : A credential here holds the username and password for the WebDAV server. You save them once in the Namirasoft Credential app, then pick that saved credential here. Some services ask you to create a separate app password instead of your main password. How to create a basic auth credential?
WebDAV (Bearer Token)Protocol
This type connects a WebDAV server using a bearer token instead of a username and password. A bearer token is a long string that the server issues to grant access. You choose this when your WebDAV server uses token based sign in.
- URL (String) : The URL is the WebDAV address of your server, for example https://cloud.example.com/remote.php/dav/files/username/. Your service shows this address in its settings or its WebDAV help page, and you paste it here. Where do I find my WebDAV URL?
- Vendor (Enum) : The vendor is the kind of WebDAV server you are connecting to, picked from a list, for example Nextcloud, ownCloud, or Other. You choose the one that matches your server, and you choose Other when you are not sure.
- Bearer Token (String) : The bearer token is a long string the server gives you to prove your access, used in place of a password. You generate or copy it from your WebDAV service, then paste it here and keep it private. How to get a bearer token?
HTTPProtocol
This type reads files that are published on a website over HTTP. It is read only, so you browse and download the files that are published there. You choose it to pull files from a public web address or a static file server.
- URL (String) : The URL is the web address of the folder that lists your files, for example https://example.com/files/. You enter the address whose page shows the files you want to read.
HDFSProtocol
This type connects a Hadoop Distributed File System, known as HDFS, which stores very large data sets across a cluster of machines. You choose it to reach data kept in a Hadoop cluster.
- Namenode (String) : The namenode is the main server that tracks where files live in the cluster, written as an address such as namenode.example.com:8020. Your Hadoop administrator gives you this address, and you enter it here. Where do I find my HDFS namenode address?
- Username (String) : The username is the Hadoop account that the connection acts as, which controls what it may read and write, for example hdfs or your own user name. Your administrator tells you which user to use, and you enter it here. Which Hadoop username should I use?
Google Drive (OAuth)Connected drive
This type connects a Google Drive account so you can work with the files in it. You sign in with your Google account through OAuth, which lets Namirasoft NWS Volume reach your Drive on your behalf without you sharing a password. The files stay in your own Google Drive.
- Credential (Namirasoft Credential’s ID) : A credential is the Google sign in that lets Namirasoft NWS Volume open your Drive. You create it once by signing in with your Google account in the Namirasoft Credential app, then pick that saved credential here from a list, so you never enter a Google password on this page. How to get a Google Drive token auth credential?
Google Drive (Service Account)Connected drive
This type connects Google Drive using a service account, which is a robot account meant for servers and automation rather than a person signing in. You give Namirasoft NWS Volume a key file for that service account, and it uses the file to reach the Drive on its own. You choose this for unattended or production use.
- Scope (Enum) : The scope sets how much access the service account has, picked from a list. You choose full access to read and write files, or read only when you want the connection to view files and leave them unchanged. You pick the one that matches what you need.
- Service Account File (String) : The service account file is a small JSON key file that Google creates for a service account. You create the service account in the Google Cloud console, share your Drive folder with the service account email address, download its JSON key, and upload that file here. How to get a Google service account file?
Google PhotosConnected drive
This type connects a Google Photos library so you can work with its photos and albums. You sign in with your Google account through OAuth, which lets Namirasoft NWS Volume reach your library on your behalf.
- Credential (Namirasoft Credential’s ID) : A credential is the Google sign in that lets Namirasoft NWS Volume open your photo library. You create it once by signing in with your Google account in the Namirasoft Credential app, then pick that saved credential here from a list. How to get a Google Photos token auth credential?
- Read Only (Boolean) : This setting keeps the connection focused on viewing. You turn it on so the connection reads and downloads your photos and leaves them unchanged. You leave it off to also let it upload new photos.
DropboxConnected drive
This type connects a Dropbox account so you can work with the files in it. You sign in with your Dropbox account through OAuth, which lets Namirasoft NWS Volume reach your Dropbox on your behalf.
- Credential (Namirasoft Credential’s ID) : A credential is the Dropbox sign in that lets Namirasoft NWS Volume open your Dropbox. You create it once by signing in with your Dropbox account in the Namirasoft Credential app, then pick that saved credential here from a list. How to get a Dropbox token auth credential?
OneDriveConnected drive
This type connects a Microsoft OneDrive account so you can work with the files in it. It works with both a personal OneDrive and the OneDrive that comes with a Microsoft 365 work or school account. You sign in through OAuth.
- Credential (Namirasoft Credential’s ID) : A credential is the Microsoft sign in that lets Namirasoft NWS Volume open your OneDrive. You create it once by signing in with your Microsoft account in the Namirasoft Credential app, then pick that saved credential here from a list. How to get a OneDrive token auth credential?
- Tenant (String) : The tenant tells the connection which Microsoft organization your account belongs to. For a personal OneDrive you leave it at the default. For a work or school account you enter your organization tenant id, a long code your IT team can give you or that you find on the Microsoft Entra ID overview page in the Azure portal. Where do I find my Microsoft Entra tenant id?
BoxConnected drive
This type connects a Box account so you can work with the files in it. You sign in with your Box account through OAuth, which lets Namirasoft NWS Volume reach your Box on your behalf.
- Credential (Namirasoft Credential’s ID) : A credential is the Box sign in that lets Namirasoft NWS Volume open your Box. You create it once by signing in with your Box account in the Namirasoft Credential app, then pick that saved credential here from a list. How to get a Box token auth credential?
iCloud DriveConnected drive
This type connects an iCloud Drive account so you can work with the files in it. You sign in with your Apple ID, the same account you use for other Apple services.
- Apple ID (String) : The Apple ID is the email address you use to sign in to Apple services, for example yourname@icloud.com. You enter that email address here.
- Password (String) : Because Apple protects accounts with two factor verification, you create an app specific password just for this connection rather than using your main password. You make one at appleid.apple.com under Sign in and Security, then paste it here. How to create an Apple app specific password?
pCloud (OAuth)Connected drive
This type connects a pCloud account so you can work with the files in it. You sign in with your pCloud account through OAuth, which lets Namirasoft NWS Volume reach your pCloud on your behalf.
- Credential (Namirasoft Credential’s ID) : A credential is the pCloud sign in that lets Namirasoft NWS Volume open your pCloud. You create it once by signing in with your pCloud account in the Namirasoft Credential app, then pick that saved credential here from a list. How to get a pCloud token auth credential?
pCloud (User and Password)Connected drive
This type connects a pCloud account using your username and password. You choose it when you prefer to sign in with your account details rather than through OAuth.
- Hostname (String) : pCloud keeps accounts in two regions, and the hostname tells the connection which one yours is in. You enter api.pcloud.com for an account created in the United States, or eapi.pcloud.com for an account created in Europe. You can check your region in your pCloud account settings. Where do I find my pCloud region?
- Credential (Namirasoft Credential’s ID) : A credential here holds the username and password for your pCloud account. You save them once in the Namirasoft Credential app, then pick that saved credential here from a list, so you do not type the password on this page. How to create a basic auth credential?
MegaConnected drive
This type connects a MEGA account so you can work with the files in it. You sign in with your MEGA email and password.
- Basic Auth (String) : This holds the email and password for your MEGA account. You enter your MEGA email address and its password here so the connection can open your account.
- Two Factor Code (String) : If you protect your MEGA account with two factor verification, you enter the current six digit code from your authenticator app here. You leave it empty for accounts that do not use two factor verification.
Proton DriveConnected drive
This type connects a Proton Drive account so you can work with the files in it. You sign in with your Proton email and password.
- Basic Auth (String) : This holds the email and password for your Proton account. You enter your Proton email address and its password here so the connection can open your account.
- Two Factor Code (String) : If you protect your Proton account with two factor verification, you enter the current six digit code from your authenticator app here. You leave it empty for accounts that do not use two factor verification.
Yandex DiskConnected drive
This type connects a Yandex Disk account so you can work with the files in it. You sign in with your Yandex account through OAuth, which lets Namirasoft NWS Volume reach your Yandex Disk on your behalf.
- Credential (Namirasoft Credential’s ID) : A credential is the Yandex sign in that lets Namirasoft NWS Volume open your Yandex Disk. You create it once by signing in with your Yandex account in the Namirasoft Credential app, then pick that saved credential here from a list. How to get a Yandex Disk token auth credential?
Zoho WorkDriveConnected drive
This type connects a Zoho WorkDrive account so you can work with the files in it. You sign in with your Zoho account through OAuth, which lets Namirasoft NWS Volume reach your WorkDrive on your behalf.
- Region (Enum) : Zoho keeps accounts in several regions, and the region tells the connection where yours lives. You pick the region that matches your account from the list, for example com for the United States, eu for Europe, or in for India. You can see your region in the web address you use to open Zoho. Where do I find my Zoho region?
- Credential (Namirasoft Credential’s ID) : A credential is the Zoho sign in that lets Namirasoft NWS Volume open your WorkDrive. You create it once by signing in with your Zoho account in the Namirasoft Credential app, then pick that saved credential here from a list. How to get a Zoho token auth credential?
JottacloudConnected drive
This type connects a Jottacloud account so you can work with the files in it. You sign in with your Jottacloud account through OAuth, which lets Namirasoft NWS Volume reach your Jottacloud on your behalf.
- Token URL (String) : The token URL is a personal sign in link that Jottacloud creates for you. You sign in at jottacloud.com, open the page that generates a personal login token, and copy the token URL it gives you into this field. Where do I find my Jottacloud login token?
- Credential (Namirasoft Credential’s ID) : A credential is the Jottacloud sign in that lets Namirasoft NWS Volume open your account. You create it once in the Namirasoft Credential app, then pick that saved credential here from a list. How to get a Jottacloud token auth credential?
HiDriveConnected drive
This type connects a HiDrive account, the cloud storage from Strato, so you can work with the files in it. You sign in with your HiDrive account through OAuth, which lets Namirasoft NWS Volume reach your HiDrive on your behalf.
- Scope Access (Enum) : The scope access sets how much the connection can do, picked from a list. You choose read write to view and change files, or read only to view and download files and leave them unchanged. You pick the one that matches what you need.
- Credential (Namirasoft Credential’s ID) : A credential is the HiDrive sign in that lets Namirasoft NWS Volume open your HiDrive. You create it once by signing in with your HiDrive account in the Namirasoft Credential app, then pick that saved credential here from a list. How to get a HiDrive token auth credential?
KoofrConnected drive
This type connects a Koofr account so you can work with the files in it. You sign in with an application password that you create in Koofr.
- Provider (Enum) : The provider tells the connection which Koofr based service you use, picked from a list. You choose Koofr for a standard Koofr account. Some other services run on Koofr technology, so you pick that name if your account is with one of them, or you choose the self hosted option for your own Koofr server.
- Endpoint (String) : The endpoint is the web address of your Koofr service. For a standard Koofr account you use https://app.koofr.net. You change it only when you connect to a different or self hosted Koofr server, and you enter that address here.
- Credential (Namirasoft Credential’s ID) : A credential here holds your Koofr email and an application password. You create the application password in your Koofr account under Preferences and then Password, save it with your email in the Namirasoft Credential app, then pick that saved credential here. How to create a basic auth credential?
Mail.ru CloudConnected drive
This type connects a Mail.ru Cloud account so you can work with the files in it. You sign in with your Mail.ru email and an application password that you create for the account.
- Credential (Namirasoft Credential’s ID) : A credential here holds your Mail.ru email and an application password. Mail.ru uses application passwords for outside connections, so you create one in your Mail.ru account security settings, save it with your email in the Namirasoft Credential app, then pick that saved credential here. How to create a basic auth credential?
OpenDriveConnected drive
This type connects an OpenDrive account so you can work with the files in it. You sign in with the email and password for your OpenDrive account.
- Credential (Namirasoft Credential’s ID) : A credential here holds the email and password for your OpenDrive account. You save them once in the Namirasoft Credential app, then pick that saved credential here from a list, so you do not type the password on this page. How to create a basic auth credential?
PikPakConnected drive
This type connects a PikPak account so you can work with the files in it. You sign in with the username and password for your PikPak account.
- Credential (Namirasoft Credential’s ID) : A credential here holds the username and password for your PikPak account. You save them once in the Namirasoft Credential app, then pick that saved credential here from a list, so you do not type the password on this page. How to create a basic auth credential?
Put.ioConnected drive
This type connects a Put.io account so you can work with the files in it. You sign in with your Put.io account through OAuth, which lets Namirasoft NWS Volume reach your Put.io on your behalf.
- Credential (Namirasoft Credential’s ID) : A credential is the Put.io sign in that lets Namirasoft NWS Volume open your Put.io. You create it once by signing in with your Put.io account in the Namirasoft Credential app, then pick that saved credential here from a list. How to get a Put.io token auth credential?
LinkboxConnected drive
This type connects a Linkbox account so you can work with the files in it. You sign in with your Linkbox account through OAuth, which lets Namirasoft NWS Volume reach your Linkbox on your behalf.
- Credential (Namirasoft Credential’s ID) : A credential is the Linkbox sign in that lets Namirasoft NWS Volume open your Linkbox. You create it once by signing in with your Linkbox account in the Namirasoft Credential app, then pick that saved credential here from a list. How to get a Linkbox token auth credential?
SeafileConnected drive
This type connects a library on a Seafile server, an open source file sharing platform that teams often run themselves. You sign in with your Seafile account and choose the library you want to work with.
- URL (String) : The URL is the web address of your Seafile server, for example https://seafile.example.com. Your administrator gives you this address, or you read it from the address bar when you open Seafile, and you enter it here. Where do I find my Seafile server URL?
- Basic Auth (String) : This holds the email and password you use to sign in to Seafile. You enter your Seafile email address and its password here.
- Two Factor Code (String) : If your Seafile account uses two factor verification, you enter the current six digit code from your authenticator app here. You leave it empty for accounts that do not use two factor verification.
- Library (String) : A library in Seafile is a top level folder that holds a set of files, much like a drive. You enter the name of the library you want to connect, which you see listed when you open Seafile. Where do I find my Seafile library name?
- Library Key (String) : If the library you chose is encrypted, you enter its password here so the connection can open it. You leave it empty for a library that is not encrypted.
GoFileConnected drive
This type connects a Gofile account so you can work with the files in it. You sign in with your Gofile account through OAuth, which lets Namirasoft NWS Volume reach your Gofile on your behalf.
- Credential (Namirasoft Credential’s ID) : A credential is the Gofile sign in that lets Namirasoft NWS Volume open your Gofile. You create it once by signing in with your Gofile account in the Namirasoft Credential app, then pick that saved credential here from a list. How to get a Gofile token auth credential?
Uloz.toConnected drive
This type connects an Uloz.to account so you can work with the files in it. You sign in with your Uloz.to account, and the connection uses a saved sign in together with your account details.
- Credential (Namirasoft Credential’s ID) : A credential is the Uloz.to sign in that lets Namirasoft NWS Volume open your account. You create it once in the Namirasoft Credential app, then pick that saved credential here from a list. How to get an Uloz.to token auth credential?
- Basic Auth (String) : This holds the username and password for your Uloz.to account. You enter your Uloz.to username and its password here.
FileLUConnected drive
This type connects a FileLU account so you can work with the files in it. You sign in with an API key from your FileLU account.
- Key (String) : The key is your FileLU API key, a string that lets the connection sign in to your account in place of a password. You sign in at filelu.com, open your account or API settings, and copy the key shown there, then paste it here. How to get your FileLU API key?
File FabricConnected drive
This type connects a Storage Made Easy File Fabric server, a platform that brings several storage services together behind one address. You sign in with your File Fabric account and reach the storage it manages.
- URL (String) : The URL is the web address of your File Fabric server, for example https://yourcompany.storagemadeeasy.com. Your administrator gives you this address, and you enter it here. Where do I find my File Fabric URL?
- Root Folder ID (String) : The root folder id tells the connection which folder to treat as the starting point. You leave it empty to start at the top of your File Fabric, or you enter the id of a specific folder, which you find in the File Fabric web interface, to start there instead. Where do I find my File Fabric folder id?
- Credential (Namirasoft Credential’s ID) : A credential is the File Fabric sign in that lets Namirasoft NWS Volume open your account. You create it once in the Namirasoft Credential app, then pick that saved credential here from a list. How to get a File Fabric token auth credential?
QuatrixConnected drive
This type connects a Quatrix account, a managed file transfer service from Maytech, so you can work with the files in it. You sign in with an API key and your account address.
- API Key (String) : An API key is a string that lets the connection sign in to your Quatrix account in place of a password. You sign in to Quatrix, open your profile or API settings, and copy the API key, then paste it here. How to get your Quatrix API key?
- Host (String) : The host is the web address of your Quatrix account, for example yourcompany.quatrix.it. You see it in the address bar when you open Quatrix, and you enter it here. Where do I find my Quatrix host?
1FichierConnected drive
This type connects a 1Fichier account so you can work with the files in it. You sign in with an API key from your 1Fichier account.
- API Key (String) : An API key is a string that lets the connection sign in to your account in place of a password. You sign in at 1fichier.com, open your account settings and then the API page, generate a key, and paste it here. How to get your 1Fichier API key?
SiaConnected drive
This type connects storage on Sia, a network that spreads your files across many independent hosts for privacy and durability. You connect to a Sia program, called a daemon, that you or your provider runs, and Namirasoft NWS Volume talks to it through its local interface.
- API URL (String) : The API URL is the web address where your Sia daemon listens for commands, usually http://127.0.0.1:9980 when the daemon runs on the same machine. You enter the address of your daemon here, or the address your provider gives you if they run Sia for you. Where do I find my Sia daemon address?
- API Password (String) : The API password protects your Sia daemon so that only you can control it. You find it in the data folder of the daemon in a file named apipassword, or your provider gives it to you. You paste it here and keep it private. Where do I find my Sia API password?
CloudinaryConnected drive
This type connects a Cloudinary account, a service for storing and delivering images and videos, so you can work with the media in it. You sign in with the three values Cloudinary shows on your dashboard.
- Cloud Name (String) : The cloud name is the unique name of your Cloudinary account, a short word such as my-company. You sign in at cloudinary.com, look at the Product Environment area on your dashboard, and copy the cloud name shown there into this field. Where do I find my Cloudinary cloud name?
- API Key (String) : The API key is the public part of your Cloudinary credentials, a number shown next to the cloud name on your dashboard. You copy it from there and enter it here.
- API Secret (String) : The API secret is the private part of your Cloudinary credentials, shown on the same dashboard. You copy it, paste it here, and keep it private. How to get your Cloudinary API key and secret?
ImageKitConnected drive
This type connects an ImageKit account, a service for storing, optimizing, and delivering images, so you can work with the media in it. You sign in with the endpoint and keys ImageKit shows in your dashboard.
- URL Endpoint (String) : The URL endpoint is the web address ImageKit serves your images from, for example https://ik.imagekit.io/your_id. You sign in at imagekit.io, open the URL endpoints section in the dashboard, and copy the endpoint into this field. Where do I find my ImageKit URL endpoint?
- Public Key (String) : The public key is the part of your ImageKit credentials that can be shared. You find it on the Developer and then API Keys page in your ImageKit dashboard, and you enter it here.
- Private Key (String) : The private key is the secret part of your ImageKit credentials, shown on the same API Keys page. You copy it, paste it here, and keep it private. How to get your ImageKit keys?
PixeldrainConnected drive
This type connects a Pixeldrain account, a simple file sharing service, so you can work with the files in it. You sign in with an API key from your Pixeldrain account.
- API Key (String) : An API key is a string that lets the connection sign in to your account in place of a password. You sign in at pixeldrain.com, open your account or API key page, copy the key shown there, and paste it here. How to get your Pixeldrain API key?