Related versions: v19 and newer, BIMcloud as a Service
Addresses
Domain names or IP addresses
Before installing any server products, consider how the server(s) will be accessed by clients (Archicad, BIMx) and other servers (BIMcloud). Plan for a long-term solution to avoid any unnecessary work. If there is a chance of having communication over the Internet, make sure you have the needed setup. Depending the type of the BIMcloud's usage the following address types can be used:
| Type of use |
from 2020.2 |
| Mixed (internal, external) |
FQDN and/or fixed public IP address |
| Only internal |
FQDN and/or fixed private IP address |
| Only external |
FQDN and/or fixed public IP address |
Addresses for previous BIMcloud versions
| Type of use |
v19, v20, v21 |
| Mixed (internal, external) |
FQDN and/or fixed public IP address |
| Only internal |
FQDN and/or fixed private IP address |
| Only external |
FQDN and/or fixed public IP address |
How to identify the address of the computer
Your local IT should be able to answer all of these questions. The following hints can help to cover the basics: DNS name, host name
- Mac
- System Preferences > Sharing > Computer name
- Windows
- This PC > Right click > Properties > Full computer name
Public IP
- Perform a Google search for "public IP address". It will return your public IP address.
Private IP
- Mac:
- System Preferences > Network
- or give the ifconfig command in Terminal
- Windows:
- Control Panel > Network and sharing center > Click on the text next to Connections > Details
- or give the ipconfig command in the Command Prompt
NOTE:
- IPv6 is not supported; always use IPv4 addresses.
- If IP addresses are used, make sure that they are static.
- 127.0.0.1 is a special loopback IP of the localhost. It means "this computer". You can use it to open the BIMcloud Manager on the computer where the server is installed, but you should not use it to share projects in Archicad, or to pair BIMcloud servers
- From version 19 it is possible to use different addresses to access BIMcloud, it can be set up in the BIMcloud Manager/Server Connection settings.
Mixed internal and external use Scenario: The server is accessed from both the local area network and over the Internet. From version 19, fixed public IP is required and FQDN is recommended for the computer that runs BIMcloud.
Only internal use Scenario: The server is accessed only from the local area network. In this case, you can use either the FQDN of the computer or the fixed private IP.
Only external use Scenario: A typical example is a computer hosted in the cloud (Microsoft Azure, Amazon, Google etc.) which is thus always accessed over the Internet. In this case, use either the FQDN of the computer or its fixed public IP address.
Format of URLs
To access the BIMcloud Manager, open a web browser and type the combined address and port into the browser's address bar. For the default port numbers see the "
Ports" section. Examples of the address format:
http://server.company.com:port http://IPaddress:port Use the same format from Archicad as well. From version 19 more addresses can be added in the BIMcloud Manager Connection settings.
Ports
The GRAPHISOFT server products use the following default ports. Open these ports on all related firewalls and forward them in the router's settings if necessary for public access over the Internet.
- On the server side you will need to open the incoming ports
- On the client (Archicad) side you will need to open the outgoing ports
WARNING: If there are more than one BIMcloud Basic installed on the same computer, make sure to set up different ports for the different versions. The default ports used by BIMcloud:
| Application |
from 2020.2 |
| BIMcloud Manager |
22000 |
| BIMcloud Server |
22001 |
| BIMcloud Delta Cache * |
9921 |
NOTE: * As the BIMcloud Delta Cache is a local caching service, there is no need to open this port on external firewalls only on the host computer.
Ports for previous BIMcloud versions
| Application |
v19 |
v20 |
v21 |
| BIMcloud Manager |
19000 |
20000 |
21000 |
| BIMcloud Server |
19001 |
20001 |
21001 |
| BIMcloud Delta Cache * |
9921 |
9921 |
9921 |
Protocols and encryption
BIMcloud components are web-servers communicating over the standard HTTP protocol with Archicad and BIMx. If you have an HTTP Forward Proxy setup in your office, make sure to configure it to allow Teamwork related communication through. To encrypt the network traffic, the following alternatives are available:
- Use HTTPS to secure the communication. For this you will need a Reverse Proxy on the server side that will perform the SSL encryption between Archicad and the server
- Use VPN, which will encrypt the communication
Bandwidth recommendations
Related versions: BIMcloud v19 and newer, BIMcloud as a Service The proper operation of Teamwork requires high-speed network connections. Although the amount of Teamwork traffic is kept as low as possible, during a joining process all Archicad users have to download the whole project and the affected libraries from BIMcloud, which can generate a large amount of network traffic. Theoretically BIMcloud can work on very low bandwidth networks but more patience is needed when working with Teamwork over a low bandwidth connection. See our bandwidth recommendation based on project sizes below:
| Project size |
Bandwidth (upload/download) |
Upload / Download speed |
| 100 - 300 MB |
10/10 Mbps |
~1 MB per second |
| 300 MB - 2 GB |
100/100 Mbps |
~12 MB per second |
| 2+ GB |
1/1 Gbps |
~125 MB per second |
NOTE:
- The Project size refers to the size of the project database and not the PLN file that was shared. Project database are generally 4-5 times larger than PLN files.
- The Bandwidth values are NOT refering to the theoretical maximum, they are representing the actual measured bandwidth per Archicad user in a general situation - when everyone is working at the office. Therefore for example if 10 users would like to download 10 different projects with 100-300 MB in size at the same time, then they would need at least a 100/100 Mbps connection to have an acceptable download speed.
- At the server side both upload and download speed must be high
Latency recommendation
Related versions: BIMcloud v19 and newer, BIMcloud as a Service The higher the latency, the slower the round-trip between the server and the client computer. Slow round-trips vastly effect operations that require many packet exchanges between the client and server for example Send&Receive operations. If the latency is high, it can impair Teamwork performance even if the bandwidth itself is high.
- Good: 1-15 ms
- Average: 15-50 ms
- Acceptable: 50-100 ms
- Poor: 100+ ms (serious performance issues might arise)
Noemi Balogh
NOTE:
Mixed internal and external use Scenario: The server is accessed from both the local area network and over the Internet. From version 19, fixed public IP is required and FQDN is recommended for the computer that runs BIMcloud. Only internal use Scenario: The server is accessed only from the local area network. In this case, you can use either the FQDN of the computer or the fixed private IP. Only external use Scenario: A typical example is a computer hosted in the cloud (Microsoft Azure, Amazon, Google etc.) which is thus always accessed over the Internet. In this case, use either the FQDN of the computer or its fixed public IP address.
WARNING: If there are more than one BIMcloud Basic installed on the same computer, make sure to set up different ports for the different versions. The default ports used by BIMcloud:
