Regibox Faq

More FAQ on the regify homepage.

Technical FAQ

I have problems, can I do some debugging?

Yes, please take a look at the regibox trouble shooting pages.

I experience lag and slowness with many files?

First, please note that regibox Manager is designed for personal use by end users. Therefore, it is able to handle the amount of data and regiboxes that is usually produced by humans. In our tests, regibox manager is capable of handling up to 800 regiboxes and folders with up to 4000 files in a single folder with no issues. If you have more, consider the following tips:

• Run on up to date hardware. Add more CPU if you experience high loads and more RAM if you see it is not enough.
• Use SSD or NVMe drives whenever possible.
• Linux systems seem faster than Windows systems.
• From our experience, real hardware runs regibox Manager much faster than virtualized systems, especially virtualized Windows seems slow.
• Shard your data which means to avoid thousands of files in a single folder. Instead, place files in suitable folder structures.
  • Consider folders for years or years-month or participant names or customer names etc.
  • If nothing works, consider other structure information like the first letter of the filename (eg subfolders from A-Z) or purpose folders.
• Decide to delete files and folders no longer in use or outdated.
• Clean up the recovery folder from time to time to free the space for deleted files and folders.
• Avoid repeated writings of thousands of files.
  • Do not write and update incomplete files to regibox folders. Instead, copy the final version to regibox folders.
  • Do not use regibox for files in permanent change. This will produce a lot of versions. Instead, copy the final version to regibox folders.
• If you already have very much files in single folders, maybe activate bigBoxMode = 1 in [common] section of your regibox Manager boxGui.ini configuration file (only available from regibox Manager V3.0.0).
  • This will disable the file display in regibox Manager. You can no longer see and handle files from regibox Manager but the synchronization is still working.
  • It prevents freezing in regibox manager in order to allow you solving other tasks like register/unregister regiboxes or even delete regiboxes.
• Finally, consider buying and using regiboxd (the commandline version of regibox, running as a service/daemon).
  • It is used on the command line, not offering any GUI.
  • It is able to handle up to 25.000 regiboxes (we tested!) and much more files within adequate time (given enough CPU and RAM) (tested with 0.5 Mio files on Linux).
  • Allows automation for creation of regiboxes, sending invitations and cleanup tasks by scripting in your preferred scripting language (eg Python, PHP, Bash etc).
  • Available for Windows and Linux.
  • Contact regify sales for further information.

Is it possible to move the regibox root folder?

Yes, there is a way to change the location. Follow this guide:

1. Stop regibox manager (right click on the ToolTray icon and close the program).
2. Move the whole regibox root folder to the new location (incl. all subfolders). Do not copy, please move the folder and files.
3. Edit the regibox.ini:
   1. Note: With regibox Manager V2, there is an additional lib/ sub-folder (here in parenthesis).
   2. The file is located in
      • Windows: %APPDATA%\regify\regibox\(lib\)regibox.ini
      • Linux: ~/.regify/regibox/(lib/)regibox.ini
      • Mac OSX: ~/.regify/regibox/(lib/)regibox.ini
   3. Change the "boxRoot" entry to point to the new root. The path needs to end on backslash (Windows) or slash (Linux, OSX).
4. Restart regibox manager.

There are a few limitations for the location of the new regibox root folder. Please respect.

• Do not point to a location where the user does not have full read/write/delete access permissions.
• We do not recommend using a network share as regibox may become slow and syncronization may be not reliable. If you do so, please activate network mode in regibox manager settings.
• regibox only accepts one regibox root folder. You cannot run multiple instances of regibox to get more root folders.
• Multiple regibox managers from one or more computers must never point to the same network share!

Is it possible to run regibox as a Windows service?

There is a daemon/service version available as SDK (Software Development Kit). It's named regiboxd and is available for Linux and Windows (x64). It allows the unattended use of regibox including API for automated processing. This is not to be confused with a desktop version of regibox. It does not offer GUI. Please contact support(at)regify.com for getting access to this SDK.

If you like to run the regular regibox GUI version, there is no serviced option available. You may consider software like AlwaysUp, but we have no experience with it and can't support you on this. It may be needed to make sure that no second instance is ran at any time in the same user context. Eg for running regibox manager to handle the configuration, the service would have to become stopped previously. For sure, you may need to test this carefully before production!

If you are willing to auto-login a session on your Server, please note that if Windows starts to the Desktop directly, it normally also auto-starts the regibox Manager by default. At least, the setup already adds it to the users auto-start during installation. If this fails for you, you may want to run regibox manager by yourself on Server startup together with the comand-line switch -m for a minimized start.

By the way, you can find the possible command-line options by running regibox manager executable using -h (for help).

How to execute a silent regibox setup?

Simply call the setup with the /silent 2 switch (Windows only):

regibox-1.3.2-4433.exe /silent 2

How to create a logfile for the installation process?

You can call the regibox setup file with the /logfile switch (Windows only):

regibox-1.3.2-4433.exe /logfile

This will create a file "Logfile_[ProductName]_MSI.txt" in your system %TEMP% folder. You can also combine this with the /silentex switch, if you like to get more information about the silent installation.

Any information about usage in Docker or other containers?

We do not support usage in Docker environment. Neither for the regibox Manager nor the regiboxd solution.

We've heard that there are issues with file system events if the root is on the host. They do not come through to the container reliable (source, source). So this is not supported. We suggest to keep both regibox(d) and the root folder on a non-docker environment. Please do not try network mode, as this is only working for a limited number of regiboxes and files/folders. The network mode might be removed in future versions.

What ports and domains do I need to whitelist?

Please note that we recommend to NOT restrict outgoing internet access to regify software. If regify settles parts of the infrastructure to new IP addresses or changes the SSL cert vendor, you very likely will have hard to find issues.

Anyway, the following connectivity is needed:

1. Port 443 TCP to the connected regify provider.
2. Port 443 TCP websockets to the connected regify provider.
3. Port 443 and 80 to regify infrastructure (eg for updates).
   • You can find all domains by entering your (sub)provider domain to this tool.
   • If your users sync content from regibox users of other regify (sub)providers, you will also have to allow their (sub)providers domains.

regibox Manager to regiboxd migration

Sometimes we are asked about the best way of migration from regibox Manager to regiboxd. The way with the least effort is to stop regibox Manager and assign a regiboxd session to the existing database.

How to migrate

Please note that the path described here only works if you migrate within the same major versions of regibox Manager and regiboxd. The path is described for regibox Manager version 2.1.0 on Windows.

1. Stop regibox Manager (Tray icon, Exit).
2. Uninstall regibox Manager using System control or the uninstall option from Windows start menu.
   • Please note that this will not delete the configuration or any data inside of regibox root folder.
3. Determine regibox configuration folder:
   • Typically this is %APPDATA%\regify\regibox\lib\.
   • Note the full path!
4. Rename config files. Use file explorer and go to the regibox configuration folder. In there:
   • Ensure there are no files with extension .sqlite-shm or .sqlite-wal! If you find such, another regibox manager or regiboxd is running on this folder! This is a source of massive errors. Please stop and uninstall any other regibox Managers and regiboxd services.
   • Rename regibox.ini to regiboxd.ini.
   • Rename regibox.sqlite to regiboxd.sqlite.
5. This is the best moment to make backups.
   • We suggest you to make a backup of the regibox root folder and the complete folder with regibox configuration.
6. Download and install regiboxd with standard configuration.
   • IMPORTANT: The installation tool adds the regibox tools to your PATH environment. So you can run the tools from any location in the command shell.
   • IMPORTANT: You can find the regiboxd documentation online.
7. Open a CMD prompt using Administrator permissions.
8. Type the following to register a new instance to the existing regibox Manager configuration:
   • The used path for -c is the one gathered above for regibox configuration folder.

   regiboxd -c "C:\Users\regify\AppData\Roaming\regify\regibox\lib" -i "instance-1" -d "Migration instance of regiboxd"

9. Get a list of the services for validation using

   regiboxd -L

10. Verify the correct functionality using

    regiboxctl -c "C:\Users\regify\AppData\Roaming\regify\regibox\lib" -J "{'op':'getBoxInfo'}" -p

11. You're finished

We strongly suggest you to verify synchronization now. Place some test file into one of the regiboxes and verify synchronization on the other members of this regibox.

Some useful regiboxd call examples

Turn on local copy for all files and folders of given regibox uid:

   regiboxctl -c "C:\Users\regify\AppData\Roaming\regify\regibox" -J "{'op':'localOnOff', 'uid':'srp79f915967u3doyd8o7orfikjyn5d8', 'filePart':,'isOn':1}"

Turn debugging on and off:

   regiboxctl -c "C:\Users\regify\AppData\Roaming\regify\regibox" -J "{'op':'diagnostics'}"

Stop and remove regiboxd service named "instance-1":

   regiboxd -u "instance-1"

You can find more examples in the regiboxd manual.

Automation rules

These rules help you to avoid issues if you are creating files and folders automatically into regibox.

1. Do not use any folder inside of regibox root folder for temporary work
   • All disk activity below the regibox root folder is observed and every file/folder you create triggers regibox activity with a lot of work.
   • Compile your temporary files outside of regibox root folder.
2. Do not store partial file contents in regibox folders
   • Sync may start even if your file is not completed. Receivers will get incomplete files.
   • Complete your files at some temporary place and only copy the final version to regibox.
   • If you create incomplete files, it may create multiple versions.
   • If a receiver deletes incomplete files, it may also delete your final file then in reversal (due to delayed sync).
   • If you want the receivers to process partial files, use some timestamp or increasing ID to generate unique filenames.
3. Do not delete content until receivers had a chance to process your files.
   • Give other regibox managers time to sync your files.
   • If you delete to early (for example in seconds), it might happen that the receivers never get the files at all.
4. Clean-up unused data
   • Even deleted files stay in "recovery" folders.
   • Use regiboxd function emptyRecovery to cleanup this space every now and then for your regiboxes.
   • See regiboxd manual for an example.
5. Delete unused regiboxes
   • If you no longer need regiboxes or their content, delete them instead of only unsubscribing.

-