Depending on your platform, CloudBees CD/RO installers may allow you to install CloudBees CD/RO and its components as a root (Administrator on Windows), sudo, or non-root user.
User requirements for installation
The following tables displays which user permissions can be used to install CloudBees CD/RO.
| Platform | Server, web, and repository | 64-Bit agent-only | CloudBees Analytics |
|---|---|---|---|
Windows |
Administrator only |
Administrator only |
Administrator only |
Linux |
Root, sudo, or non-root |
Root, sudo, or non-root |
Root, sudo, or non-root |
Linux ARM |
N/A |
Root, sudo, or non-root |
N/A |
macOS |
N/A |
Root, sudo, or non-root |
N/A |
| For production environments, CloudBees recommends installing all CloudBees CD/RO components on separate machines. |
Windows services user permissions
For CloudBees CD/RO Windows installations, all CloudBees CD/RO components, including agents and CloudBees Analytics, must be installed by an Administrator system user. This allows the CloudBees CD/RO services to start automatically when the machine boots.
During CloudBees CD/RO and CloudBees Analytics installation, you will be asked to provide a system user to run the CloudBees CD/RO server, web, and repository services. CloudBees recommends to use a non-Administrator system user to run these services. This limits the effect to the underlying operating system should CloudBees CD/RO or CloudBees Analytics services become compromised.
Additionally, you will be asked during installation if you want to use the same user for the CloudBees CD/RO agent as the servers. For security purposes, CloudBees strongly recommends using separate system users for the CloudBees CD/RO servers and agents. This helps limit the effect to the servers should a CloudBees CD/RO agent become compromised.
| Before installing CloudBees CD/RO agents, CloudBees strongly recommends reviewing Agent security recommendations. |
Linux services user permissions
For CloudBees CD/RO Linux installations, you are able to run the installer as a root, sudo, or non-root user. CloudBees recommends running the installer as a root or sudo user, which allows CloudBees CD/RO services to start automatically when the machine boots.
| If you choose to run any of these components as a non-root user, these services will not start automatically when the machine boots. For information on how to reconfigure them to start automatically for non-root installations, refer to Configure autostart for non-root/non-sudo Linux installations. |
During CloudBees CD/RO and CloudBees Analytics installation, you will be asked to provide a system user to run the CloudBees CD/RO server, web, and repository services. CloudBees recommends to use a non-root/non-sudo user to run these services. This limits the effect to the underlying operating system should CloudBees CD/RO or CloudBees Analytics services become compromised.
Additionally, you will be asked during installation if you want to use the same user for the CloudBees CD/RO agent as the servers. For security purposes, CloudBees strongly recommends using separate system users for the CloudBees CD/RO servers and agents. This helps limit the effect to the servers should a CloudBees CD/RO agent become compromised.
| Before installing CloudBees CD/RO agents, CloudBees strongly recommends reviewing Agent security recommendations. |
Linux ARM services user permissions
Only agent installers are currently available for Linux ARM platforms, and you may perform root, sudo, or non-root installations. CloudBees recommends running the installer as a root or sudo user, which allows the CloudBees CD/RO agent to start automatically when the machine boots.
During installation, you will be asked to provide a system user to run the CloudBees CD/RO agent services. CloudBees recommends to use a non-root/non-sudo user to run these services. This limits the effect to the underlying operating system should the CloudBees CD/RO agent become compromised.
| Before installing CloudBees CD/RO agents, CloudBees strongly recommends reviewing Agent security recommendations. |
macOS services user permissions
Only agent installers are currently available for macOS platforms, and you may perform root, sudo, or non-root installations. CloudBees recommends running the installer as a root or sudo user, which allows the CloudBees CD/RO agent to start automatically when the machine boots.
During installation, you will be asked to provide a system user to run the CloudBees CD/RO agent services. CloudBees recommends to use a non-root/non-sudo user to run these services. This limits the effect to the underlying operating system should the CloudBees CD/RO agent become compromised.
| Before installing CloudBees CD/RO agents, CloudBees strongly recommends reviewing Agent security recommendations. |