You’ve deployed your Ubuntu Workspaces instances and want to manage them centrally. Landscape SaaS is an ideal solution, as it’s fully cloud-based and included with your Ubuntu Pro subscription.
1. Create your Ubuntu Pro account for Landscape SaaS
Sign up for Landscape SaaS by visiting Signup - Landscape.
You can log in using your Ubuntu One account. If you don’t have one, select “I don’t have an Ubuntu One account” and fill in the required details.
You’ll receive a confirmation email to validate your address. Once validated, you’ll be redirected to the Landscape portal.
2. Open Landscape SaaS:
Once your account is set up, you can access Landscape SaaS at: https://landscape.canonical.com/
3. Enable the Landscape client in your machines
In the top-left panel of the Landscape portal, select “You can register new computers by following these instructions”. It will show you the following steps that are used to install the Landscape client and register your machines with your account.
Note: You can also view your account number in the top-right corner of the Landscape portal, under your account name.
1. Open the terminal
On the machine you want to register, open a terminal window. Make sure you have the machine’s password, as you’ll need it for sudo commands.
2. Update repositories
Ensure that your repositories are up-to-date by running:
sudo apt-get update
3. Install the Landscape Client
Install the Landscape client using:
sudo apt-get install landscape-client -y
4. Register the machine
Register the machine with the following command, replacing “My Ubuntu Workspaces” with the name or title you’d like for this machine (e.g., “Dev Workstation”):
sudo landscape-config --computer-title “My Ubuntu Workspaces” --account-name <>
During registration, you’ll be prompted to answer a few questions, including the registration key for automatic enrollment, proxy configuration, and user/group settings for script execution. You can leave most settings as default unless you have specific requirements.
This step can also be scripted into a single command if you need to rely on automation. For more information and other use cases, please refer to the official documentation about installing the Landscape client.
4. Accept the new machine on Landscape
Once the machine is registered, go back to the Landscape portal, and you’ll be able to accept the new machine for management as shown below:
Open the alert link to view the details of all machines that are pending approval:
Select accept to enroll the machines, and they will be shown on the main page:
You can select the “Computers” tab to see the list of all enrolled machines.
(Optional) Enable script execution
If you need to run arbitrary scripts across multiple managed instances, and you didn’t enable this feature during the machine registration, you can enable it manually by running the following command on each instance:
sudo landscape-config --include-manager-plugins=ScriptExecution --script-users=root,landscape,nobody
sudo service landscape-client restart
Final Notes
For more advanced use cases and automation, please consult the official Landscape documentation. If you have any questions, feel free to reach out on our contact page.