Help:Cloud VPS Instances
(Redirected from Help:Instances)
This page contains information on how to set up a Cloud VPS instance.
What is a Cloud VPS instance?
An instance is a virtual machine (VM). Every instance belongs to a Cloud VPS project.
Difference between a Cloud VPS project and an instance
Why create a Cloud VPS instance?
Cloud VPS is a flexible option for those who need it. It is equivalent to having your own server(s).
Before requesting a Cloud VPS instance, we recommend you consider using Toolforge instead. Toolforge has many of the same features as Cloud VPS, and Toolforge users do not have to manage the full virtual environment. Toolforge users also have access to toolsdb, wiki replicas, and a number of other services.
See Cloud VPS vs Toolforge to help decide which service is right for you.
Who can create a Cloud VPS instance?
Project admins (sometimes written projectadmins). You must be a Project admin in a project to create and manage its instances.
What are the responsibilities of project admins?
Project admins must subscribe to the cloud-announce and cloud mailing lists and follow the maintenance or communication actions requested by the WMCS Admins. Failure to respond may result in unexpected loss of data or service interruptions.
Project admins should delete unused instances and notify other admins when a project is no longer active. See Cloud VPS instance lifecycle for more details.
Requesting Project admin rights
To create instances, individuals must have project admin rights on the specific project they want to have instances created for. The following people can grant Project admin rights:
Contacting admins
Project admins and members of the Cloud admin group can be contacted through the 'email a user' function or through their talk page on Wikitech. Please note: Many members of the Wikitech community are volunteers who may not check their email or talk pages regularly. You may need to check with more than one admin before you receive a response.
Project access rights
Learn more about Cloud services user roles and rights.
Before you create a Cloud VPS instance
Create a Cloud VPS instance
  1. Log in to​.
  2. Use the dropdown at top to select the project you want to work on.
  3. Click Compute/Instances in the sidebar.
  4. Click the Launch instance button.
  5. Choose the parameters you want and launch the instance.
  6. Add instance information.
  7. Click Submit.
  8. ⭐Voila!⭐
Instance information
Add the following information to your instance:
Information typeAction
Instance DetailsThe name, zone, and count of your instanceThe name will also be your hostname. Name your instance using the following format project-instance, e.g, the project name is myproject; the instance is coolbot; the instance name is myproject-coolbot
Instance SourceThe version of the operating system(Debian Stretch, Debian Buster, etc). Also known as a base image.
Instance FlavorContains a range of possible instance types indicating RAM, number of CPUs, and Hard Drive space.Your most likely choice will be at the top of the list of system images available. See current flavors in following chart.
Security GroupsContains a list of security groupsAt minimum, the default security group should be selected.*
Server GroupsContains a list of server groupsServer groups allow you to define logical groups of instances with advanced scheduling features. Note: avoid using the affinity server group policy. See the linked help page for why.
* If the Project admin for the project has not created any additional security groups, besides the default group, you will only see the default security group listed.
Instance Sizes and Flavors
Cloud VPS sizes*
g3.cores1.ram2.disk2012 GB20 GB0 GBYes
g3.cores2.ram4.disk2024 GB20 GB0 GBYes
g3.cores4.ram8.disk2048 GB20 GB0 GBYes
g3.cores8.ram16.disk20816 GB20 GB0 GBYes
g3.cores16.ram16.disk201616 GB20 GB0 GBYes
g2.cores8.ram36.disk20836 GB20 GB0 GBYes
* Current as of April 2021
Manage a Cloud VPS instances
After you set your configurations and click Submit, it will take some time before the instance is ready. You will know your instance is ready when a new row appears in the instances list.
The following 4 areas are displayed:
Overviewgeneral description
Logshow console output
Action Loglist OpenStack operations, such as instance creation
Puppet Configurationset up the instance with available Puppet roles
Puppet Configuration for Cloud VPS instances
Cloud VPS uses Puppet to manage instance configurations.
A list of puppet classes can be found on
If you are a sudo user for the project, you can run sudo puppet agent -tv or wait until puppet runs on your instance.
When the puppet run finishes, you can log into it with SSH.
Setting up a test MediaWiki Server
See MediaWiki-Vagrant in Cloud VPS for more information.
Increase quotas for projects
Quotas are the usage limits for projects. Quotas refer to one or more of CPU, RAM, disk storage, number of VM instances and/or floating IPs. The default quota for a new project allows up to 8 instances.
Projects can have their quota increased following the instructions on the "Cloud-VPS (Quota-requests)" Phabricator task.
The Cloud VPS Instance lifecycle
Instances are allocated resources (storage, RAM, CPU, power). Over time, these resources need to be used or reclaimed. WMCS admins periodically check projects and instances to ensure they are being used by active projects. Instances will be removed for projects that have been determined inactive.
Process for removing Cloud VPS instances
  1. Notice will be sent to cloud via cloud-announce at least 2 weeks before any expected action is taken. Emergencies may require more immediate intervention.
  2. If possible, instances will be suspended or shut down for at least 2 weeks (a total of a month) before further unsolicited actions are taken to allow the tenant to notice.
  3. Inactive projects (those without instances or any responsive users) will be removed (along with their quota)
Backups of Cloud VPS instances
No backups will be kept by Wikimedia Cloud Services.
Local backups
You can backup your server by copying the files you are interested to save on your local machine. OF course, this is not an automated process and you will need to store the data you are saving. Also, be mindful that backups may be very big and so you will be transferring a lot of data, which among other things will take a long time.
If you want to backup your root disk on your VPS server to a local directory named backup you can do the following:
rsync -aXvz --stats --info=progress2 --rsync-path="sudo /usr/bin/rsync" --exclude-from=./excludes.txt <server>:/ backup/`
The paths listed in the file excludes.txt will be ignored. This gist contains a common list of excluded paths that you usually do not need to backup since they are temporary files, cache, backups and other system files.
Communication and support
We communicate and provide support through several primary channels. Please reach out with questions and to join the conversation.
Communicate with us
ConnectBest for
Phabricator Workboard#Cloud-ServicesTask tracking and bug reporting
IRC Channel#wikimedia-cloud connectGeneral discussion and support
Mailing Listcloud@Information about ongoing initiatives, general discussion and support
Announcement emailscloud-announce@Information about critical changes (all messages mirrored to cloud@)
News wiki pageNewsInformation about major near-term plans
BlogClouds & UnicornsLearning more details about some of our work
See Also
Last edited on 16 July 2021, at 14:04
Content is available under CC BY-SA 3.0 unless otherwise noted.
Privacy policy
Terms of Use
HomeRandomLog inSettingsDonateAbout WikitechDisclaimers