Installing CosLogin Browser on Ubuntu System

Overview

This article describes the complete process of installing CosLogin Browser on Ubuntu 24.04 Desktop. CosLogin Browser is a dedicated tool for logging into Tencent Cloud Object Storage (COS). After installation, you can conveniently manage bucket resources through a graphical interface. We use the ubuntu-24.04-desktop-amd64 virtual machine already deployed in VMware Workstation Pro as an example to help you quickly complete environment preparation and software installation.

Prerequisites

Before starting the installation, ensure the following conditions are met:

• You have installed Ubuntu 24.04 Desktop via VMware Workstation Pro, and the system can log in normally and connect to the network.
• The current logged-in user has sudo privileges to execute commands requiring administrator rights.
• (Optional) If you plan to transfer the installation package remotely, ensure that the Ubuntu system is configured with a network and accessible to other hosts on the LAN.

Install SSH Service (for file transfer)

If you want to upload the installation package from another computer to Ubuntu using tools like scp or sftp, please install and start the OpenSSH service first. If you plan to download directly using a browser within Ubuntu, you can skip this step.

1. Open a terminal and run the following command to install openssh-server:

   sudo apt update
   sudo apt install openssh-server -y

2. Start the SSH service and enable it to start at boot (recommended):

   sudo systemctl start ssh
   sudo systemctl enable ssh

3. Check the SSH service status to confirm it is running normally:

   sudo systemctl status ssh

The status showing active (running) indicates successful startup.

4. (Optional) If a system firewall is enabled, you need to allow port 22:

   sudo ufw allow ssh

After installation, you can use the following command to view the local IP address for remote connection:

ip addr show

Obtain CosLogin Browser Installation Package

You can choose any of the following methods to obtain the installation file CosLogin_Browser-0.0.1-linux-amd64.deb based on your actual environment.

Method 1: Upload via SFTP/SCP (for transfer from other computers)

Assuming the installation package has been downloaded on your local Windows or macOS host, and Ubuntu's IP address is 192.168.1.100, username is ubuntu, the upload steps are as follows:

• Use the scp command (execute in Mac/Linux terminal or Windows PowerShell):

  scp CosLogin_Browser-0.0.1-linux-amd64.deb ubuntu@192.168.1.100:~/

• Or use a graphical SFTP client (such as FileZilla, WinSCP) to connect to Ubuntu and drag the deb package to the target directory (e.g., /home/ubuntu/).

After uploading, navigate to the directory in the Ubuntu terminal to see the file.

Method 2: Download directly within Ubuntu

1. Open a browser in the Ubuntu desktop environment and visit the official website of CosLogin Browser.
2. Find the Linux installation package download link, select the .deb file suitable for the amd64 architecture, and download it. Usually, the file is saved in the ~/Downloads directory.
3. In the terminal, navigate to the download directory:

   cd ~/Downloads

Install CosLogin Browser

After confirming that the CosLogin_Browser-0.0.1-linux-amd64.deb file exists in the current directory, run the following commands to install.

1. (Recommended) Update the package list and fix any potential dependency issues:

   sudo apt update

2. Use apt to install the local deb package:

   sudo apt install ./CosLogin_Browser-0.0.1-linux-amd64.deb

During the installation, the necessary dependencies will be automatically resolved and installed.

3. If a dependency error occurs during installation, run the following command to try to fix it, and then re-execute the installation:

   sudo apt --fix-broken install

Note: Do not use dpkg -i to install directly, because dpkg does not automatically handle dependencies, which can easily lead to missing component errors. apt install ./package_name is the recommended installation method.

Launch CosLogin Browser

After installation, you can launch the application via the desktop environment or terminal.

• Graphical launch: Click the "Applications" menu at the bottom left of the screen, enter "CosLogin" or "Browser" in the search box, find the CosLogin Browser icon and click it to run. If it does not appear immediately, try logging out and logging back in.
• Terminal launch: Enter the following command in the terminal and press Enter (the specific command depends on the executable file name generated after installation):

  coslogin-browser

If the command cannot be found, check under /usr/bin or /opt for a related executable file, or see the properties of the shortcut in the application menu.

Verify Installation

1. After the application starts successfully, the interface should display the login page, and you can normally enter Tencent Cloud account information for authentication.
2. Run the following command in the terminal to view the installed CosLogin Browser package information:

   dpkg -l | grep coslogin

If the output contains coslogin-browser and its version number 0.0.1, the installation is successful.

Common Issues and Troubleshooting

Installation dependency error

• Symptom: After running sudo apt install ./CosLogin_Browser-0.0.1-linux-amd64.deb, the terminal shows unmet dependencies.
• Solution: Run sequentially:

  sudo apt update
  sudo apt --fix-broken install

Then re-run the installation command. If the issue persists, check whether the system has enabled the universe software source (usually enabled by default).

SSH connection refused

• Symptom: When using scp or sftp remotely, it shows Connection refused.
• Check items:
• Whether the SSH service on Ubuntu is started: sudo systemctl status ssh
• Whether the firewall is blocking: sudo ufw status, if not allowed, run sudo ufw allow ssh
• Whether the virtual machine network mode is set to bridged or NAT (ensure the host can ping Ubuntu's IP)

Cannot find coslogin-browser command in terminal

• Symptom: Entering coslogin-browser shows command not found.
• Solution: Use dpkg -L coslogin-browser to view all files installed by the package, search for an executable file path named coslogin or browser, then launch it using the full path, or add that path to the PATH environment variable. In most cases, launching from the application menu will work.

Icon not showing after installation

• Symptom: CosLogin Browser cannot be found in the application menu.
• Solution: Run the following command to refresh the desktop database, or log out and log back in:

  sudo update-desktop-database

Result Check

At this point, you have successfully installed CosLogin Browser on the Ubuntu 24.04 system. After launching the application, log in using your Tencent Cloud API key or account credentials to start managing your COS resources. If you encounter any login or usage issues, refer to the product's subsequent help documentation or contact technical support.