> ## Documentation Index
> Fetch the complete documentation index at: https://docs.emailbison.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Overview
The EmailBison team provides executables for uploading Microsoft accounts to EmailBison on Windows, macOS, and Linux .
The latest version of the tool can be downloaded here:
The executable for Windows
The binary for macOS
The binary for Linux
Your browser could block this download. Right click on one of the cards and click `Save as` or `Save link as`.
## Using the tool
In the zip file you downloaded, you will find instructions on using the tool in `how_to_use.txt`.
Alternatively, you can watch a walkthrough of using the tool in action:
## Issues and FAQs
### Common Issues When Launching
This is a common macOS issue depending on how your mac is set up.
To fix this, follow [these short steps from Apple](https://support.apple.com/en-ca/guide/mac-help/mh40616/mac)
This is a common issue with macOS GateKeeper quarantining files downloaded from unknown sources.
To fix this, enter the following in your terminal:
```bash theme={null}
xattr -c path/to/emailbison_bulk_uploader
```
Where `path/to/emailbison_bulk_uploader` is the path to the EmailBison tool.
This is a common issue due to default settings on Micsorosft SmartScreen.
To fix this, click on `More info` -> `Run anyway`.
Microsoft blocks .exe files downloaded from the internet
To fix this, right click the program, click on `properties`, towards the end, there's a **Security:** label with an `Unblock` checkbox, check it and press `OK`.
### Common Issues While Using the Script
Most set-up issues are self-reporting and the issue will be shown in your terminal.
Common issues include:
* Not having config.txt in the same place as the program.
* Not populating config.txt.
* Providing the wrong URL or wrong credentials in config.txt.
* Your CSV headers are not "name, email, password".
* Manual Resolution:
1. Refer to [this help article](https://help.bisonsphere.com/en/articles/205-microsoft-need-admin-approval) to resolve this manually.
* Automatic resolution:
1. For each different tenant in the CSV, include 1 account with the "Cloud Applications Admin" role.
2. include a "use\_as\_admin" column, mark the row this account is in as true.
3. The bulk uploader will now login to the admin marked accounts first, and attempt to accept permissions tenant-wide.
4. The rest of the accounts will work now that the permissions are granted.
### Advanced Usage
The walkthrough above is enough for most use-cases.
However, the bulk uploader tool can be fine-tuned to specific needs with flags.
Flags are arguments you pass in the command line, you can watch the following video for a quickstart.
#### Flags available
These are the flags available. You can use the flag `--help` to see these flags in your terminal.
| Flag | Type | Description | Default | Example |
| ----------------------- | ------- | ------------------------------------------------------------------------------------------------------------------ | ------------------------- | ------------------------------------------- |
| non-interactive | boolean | Disable all prompts and inputs. Still outputs info to the terminal. `--csv-file` flag required with this flag | false | `--non-interactive` |
| browsers | integer | How many browsers to spawn concurrently | **6**, min: 1, max: 16 | `--browsers 4` |
| no-headless | boolean | spawns visible browsers. Use `--browsers 1` with this flag | false | `--no-headless` |
| timeout | integer | How long, in seconds, before treating the email as a fail and moving on. Useful to change on very slow connections | **75**, min: 30, max: 180 | `--timeout 180` |
| tag | string | What to tag this batch of emails (will create tag if it doesn't exist) | "" | `--tag "batch 1"` |
| skip-connected-accounts | boolean | If account exists on EmailBison, and is in a "connected" state, skip it. | false | `--skip-connected-accounts` |
| config-file | string | Use a custom config file, you can also provide the path if in another directory | "config.txt" | `--config-file "../configs/workspace4.txt"` |
| csv-file | string | A path to the csv file to use, to skip the file picker prompt. | "" | `--csv-file "../files/accounts.csv"` |
| throttle | boolean | Use recommended throttling to avoid issues of the script signing in to accounts too fast | false | `--throttle` |
| driver | string | The technology that controls the browsers. Either "rod" or "chromedp" | "rod" | `--driver rod` |