The Codabox SyncTool is a synchronization tool that allows you to collect files from Codabox via a safe connection and save them locally.
★ Your usage of this application is subject to the terms of the agreement that your company has entered into with Codabox for the use of Codabox products (CODA/SODA/CARO/VOILA/…) |
INSTALLATION OR UPDATE |
Follow the instructions below to download the software, for Windows or Mac.Then follow the instructions on 'Add a connection'.
Admin rights: You must have local administrator rights to install the SyncTool on your device (if you have any doubts about this, contact your IT administrator).
IMPORTANT: Automatic file synchronization The computer on which you installed the Codabox SyncTool must be powered on. If this is not the case, the automatic file synchronization cannot happen. |

Download and install the Codabox syncTool for Windows
- Click this link and download the 'Codabox-SyncTool-1.3.0.Setup.exe' file.
Preferred browsers: Chrome & Firefox. - Double click the .exe file.
The application will install.
After installation, the software launches automatically.

Download and install the Codabox SyncTool for Mac
- Click this link and wait for the download to complete.
- Go to your downloads and unzip the file.
- Move the Codabox-SyncTool.app file from your 'Downloads' to your 'Applications'.

- Click the Codabox-SyncTool.app file in your 'Applications'.
The application will install.
After installation, the software launches automatically.

New version update

The software takes on the language of your Operating System. If necessary, you can change the language (after installation) via the settings.
OPENING AND CLOSING OF THE SOFTWARE |
Opening the software
You can open the software via
| ||
| ![]() | ![]() |
Closing the software
You can close the software via:
- the menu: Actions > Quit application
- the system tray of the Windows taskbar: right-click on the icon of the Codabox SyncTool and select 'Quit application'
You can also minimize the software to continue to run in the background and automatically download files when new ones are available. This can be done by clicking the 'x' at the top right of the application. Once minimized, you can open the application again by clicking on the icon in the system tray.
The menus
CONFIGURATION |
Add a connection: Run as Application or Run as Windows Task

- Click the Add new connection button in the main window.
- Choose how you want the connection to work: this depends on whether you have installed the SyncTool on a server or a personal device:
Run as Application Run as Windows Task Best for which device? SyncTool installed on a personal desktop SyncTool installed on a server Who can create the connection? Any logged-in user Only Admin user
Note: you will need to close the application, right-click the icon and choose Run as Administrator, before you set up the new connection. This is a once-only action.
How does the connection and synchronization work? The connection will be dependent on the logged-in user. The connection will start and synchronize when the user logs in.
Important: The connection will NOT run when the user is logged out.The connection will run and synchronize continuously in the background, independent from any active user sessions.
Important: The connection will NOT run if the device is switched off.
If the Synctool is installed on a personal device that will be switched off regularly, it is not a good idea to run a connection as a Windows Task!
- Choose the type of connection that applies to your situation:

- Are you completing the activation through MyCodabox? Then maintain the selected option 'Activation code' and click Next.
In the next screen, enter the activation code: via email you received instructions to generate this code in MyCodabox via Administration > SyncTool connections. - Did you not arrive on this page via MyCodabox and do/did you already have a SyncTool configured with username and password? Then choose the option 'Username/Password' and click Next.
In the next screen, enter the username and password you received from our helpdesk in the past. If you no longer have these details, please contact helpdesk@codabox.com.
★ Note: if you have chosen the execution type 'Run as Windows Task', the connection cannot be made with a username/password but requires an activation code.
- Choose the folder in which you want to download the files.

- Click Next. The saved connection will appear in the main window:

Edit a connection

In case you made a mistake entering the details, or you want to change the destination folder for the downloads, you can click the Edit connection icon (next to the connection you want to change).
A window will appear with the data already entered, so that you can easily adjust it. When you're done, click Confirm.
Delete a connection


ATTENTION! The files you already downloaded locally will not be deleted if you remove the connection in the Codabox SyncTool. If you also want to remove them, you will have to do it manually on your computer. |
Download files

Once the connection is established, the Codabox SyncTool will check every 2 hours if new files are available, and also download them in the specified folder.
You can also check and download files at any time, if they are available on the server. Click the Download files icon.
Browse the download folder


Consult logs: in case of synchronization issues

More info about file delivery in our article 'Where are all Codabox files delivered via the synchronization app?'
![]() | Questions or issues? Please contact Helpdesk, we will be happy to assist you! |






