Release Notes and Announcements
- Image Release Notes
- Announcements
Product Introduction
- Overview
- Basic Concepts
- Strengths
- Scenarios
- Use Limits
- Region and Network Connectivity
- Product Comparison
- User Guide
Billing
Getting Started
- One-Click Application Creation Using Lighthouse
- Quick Instance Creation
User Guide
- Instances
- Cloud Disks
- Images
- Firewall
- Private Network Interconnection
- Data Backup and Restoration Using Snapshots
- Cloud Access Management
- OPS and Monitoring
- File Transfer
- Online Migration
Use Cases
- Website Building
- Development Environment Building
- Cloud Storage System Building
- E-commerce Platform Building
- Personal Live Streaming Room Building
- FTP Service Building
- SSL Certificate Installation
Ops Guide
- Installing Cloudbase-Init on Windows
Troubleshooting
API Documentation
- History
- Introduction
- API Category
- Making API Requests
- Image APIs
- Firewall APIs
- Snapshot APIs
- Key APIs
- Instance APIs
- CCN APIs
- Cloud Disk APIs
- Other APIs
- Scene APIs
- Package APIs
- Quota APIs
- Region APIs
- Data Types
- Error Codes
FAQs
Agreements
- Privacy Policy
- Data Processing And Security Agreement
Contact Us

Installing Cloudbase-Init on Windows

Download

Focus Mode

Font Size

Last updated: 2026-07-06 16:08:20

Scenarios
This document describes how to install Cloudbase-Init on the Windows Server 2012 R2 64-bit operating system.
Preparing the Software
The following table describes the software required for installing Cloudbase-Init.
Software
Download Link
Description
CloudbaseInitSetup_X_X_XX_xXX.msi
Download the corresponding Cloudbase-Init installation package according to the bits of the operating systems actually used:
Stable version: Use this edition of the installation package. For Windows 64-bit operating systems, click here to obtain it.
Beta version: For details, see the Cloudbase-Init official website.
Used to install Cloudbase-Init.
TencentCloudRun.ps1
Click here to obtain.
-
localscripts.py
Click here to obtain.
Used to ensure that Cloudbase-Init can start normally.
Operation Steps
Installing Cloudbase-Init
1. Refer to Connecting to a Windows Instance Using VNC to log in to the Lighthouse instance.
2. On the desktop, double-click the Cloudbase-Init installation package.
3. In the dialog box, click Run to enter the Cloudbase-Init setup wizard, as shown below:
﻿
4. Click Next.
5. Check I accept the terms in the License Agreement and click Next for the following two operations.
6. On the Configuration options page, set Serial port for logging to COM1, select Run Cloudbase-Init service as LocalSystem and click Next, as shown below:
﻿
7. Click Install to install Cloudbase-Init.
8. When the installation is completed, click Finish to close the Cloudbase-Init installation page. The following figure shows the interface:
Note:
When closing the Cloudbase-Init setup wizard, do not check any checkbox or run Sysprep.
﻿
Modifying the Cloudbase-Init configuration file
1. Open the cloudbase-init.conf configuration file.
The default path of the cloudbase-init.conf configuration file is: C:\\Program Files\\Cloudbase Solutions\\Cloudbase-Init\\conf
2. Replace the cloudbase-init.conf configuration file with the following:
[DEFAULT]
username=Administrator
groups=Administrators
inject_user_password=true
config_drive_raw_hhd=true
config_drive_cdrom=true
config_drive_vfat=true
bsdtar_path=C:\\Program Files\\Cloudbase Solutions\\Cloudbase-Init\\bin\\bsdtar.exe
mtools_path=C:\\Program Files\\Cloudbase Solutions\\Cloudbase-Init\\bin\\
﻿
san_policy=OnlineAll
﻿
metadata_services=cloudbaseinit.metadata.services.configdrive.ConfigDriveService,cloudbaseinit.metadata.services.ec2service.EC2Service
#,cloudbaseinit.metadata.services.httpservice.HttpService
#,cloudbaseinit.metadata.services.maasservice.MaaSHttpService
﻿
metadata_base_url=http://169.254.0.23/
ec2_metadata_base_url=http://169.254.0.23/
﻿
retry_count=2
retry_count_interval=5
﻿
plugins=cloudbaseinit.plugins.windows.extendvolumes.ExtendVolumesPlugin,cloudbaseinit.plugins.common.networkconfig.NetworkConfigPlugin,cloudbaseinit.plugins.common.sethostname.SetHostNamePlugin,cloudbaseinit.plugins.common.setuserpassword.SetUserPasswordPlugin,cloudbaseinit.plugins.common.localscripts.LocalScriptsPlugin,cloudbaseinit.plugins.common.userdata.UserDataPlugin
verbose=true
debug=true
logdir=C:\\Program Files\\Cloudbase Solutions\\Cloudbase-Init\\log\\
logfile=cloudbase-init.log
default_log_levels=comtypes=INFO,suds=INFO,iso8601=WARN,requests=WARN
#logging_serial_port_settings=COM1,115200,N,8
mtu_use_dhcp_config=true
ntp_use_dhcp_config=true
first_logon_behaviour=no
netbios_host_name_compatibility=false
allow_reboot=true
activate_windows=true
kms_host="kms.tencentyun.com"
local_scripts_path=C:\\Program Files\\Cloudbase Solutions\\Cloudbase-Init\\LocalScripts\\
﻿
C:\\powershell
PS C:\\Set-ExecutionPolicy Unrestricted
﻿
volumes_to_extend=1,2
3. Copy the TencentCloudRun.ps1 script to C:\\Program Files\\Cloudbase Solutions\\Cloudbase-Init\\LocalScripts.
4. Right-click the TencentCloudRun.ps1 script, select Properties, and check for its executable permission in the pop-up window, as shown below:
﻿
If an Unblock option is present, select Unblock and click OK to exit. 
If the Unblock option is not present, skip this step.
5. Replace the localscripts.py file under the C:\\Program Files\\Cloudbase Solutions\\Cloudbase-Init\\Python\\Lib\\site-packages\\cloudbaseinit\\plugins\\common path with the localscripts.py file from the preparation software.
Subsequent Operation Steps
You can refer to How do I check whether the Cloudbase-Init service inside a Windows instance is working properly to check whether Cloudbase-Init is running properly.
﻿

Help and Support

Was this page helpful?

You can also Contact sales or Submit a Ticket for help.

Help us improve! Rate your documentation experience in 5 mins.

Feedback

tencent cloud

Tencent Cloud Lighthouse

Installing Cloudbase-Init on Windows

Scenarios

Preparing the Software

Operation Steps

Installing Cloudbase-Init

Modifying the Cloudbase-Init configuration file

Subsequent Operation Steps

Help and Support

Software	Download Link	Description
CloudbaseInitSetup_X_X_XX_xXX.msi	Download the corresponding Cloudbase-Init installation package according to the bits of the operating systems actually used: Stable version: Use this edition of the installation package. For Windows 64-bit operating systems, click here to obtain it. Beta version: For details, see the Cloudbase-Init official website.	Used to install Cloudbase-Init.
TencentCloudRun.ps1	Click here to obtain.	-
localscripts.py	Click here to obtain.	Used to ensure that Cloudbase-Init can start normally.