If you are looking to migrate to UpCloud or want to use your own media, get started quickly using Storage Import. The Storage Import service allows you to easily import installation media or even entire virtual machine images.<\/p>\n\n\n\n

Migrate servers from on-premise or any other cloud quickly and easily by simply creating new storage out of your server image and deploying it to a cloud server.<\/p>\n\n\n\n

Test hosting on UpCloud!<\/a><\/div>\n<\/div>\n\n\n\n

How Storage Import Works<\/h2>\n\n\n\n
Storage Import creates a new installation media or server storage out of any system or server image available online by fetching the requested file and uploading it onto a new storage device. It can be useful for migrating existing server images from on-premise hosting or from other cloud providers.<\/p>\n\n\n\n
Storage Import is also handy for using custom installation media if your favourite Linux distribution is not yet available as a public template or ready-made install disk.<\/p>\n\n\n\n
Supported file types:<\/p>\n\n\n\n
\n
RAW storage images<\/li>\n\n\n\n
IMG storage images<\/li>\n\n\n\n
ISO archive files<\/li>\n\n\n\n
GZIP compressed files<\/li>\n\n\n\n
XZ compressed files<\/li>\n<\/ul>\n\n\n\n
The target storage needs to be free and not in operation, either;<\/p>\n\n\n\n
\n
detached from any cloud server<\/li>\n\n\n\n
if attached, the cloud server needs to be shutdown<\/li>\n\n\n\n
not in a maintenance state<\/li>\n<\/ul>\n\n\n\n
Note that the system image or installation media you wish to upload needs to be made available for download for Storage Import to be able to retrieve it. The process supports the use of HTTPS and Basic Auth for secure upload.<\/p>\n\n\n\n
Uploading data using Storage Import<\/h2>\n\n\n\n
Storage Import is done directly to a new storage device which can be created in the Storage menu of any cloud server. The process requires the server to shut down during the upload. Therefore, you can opt to deploy a new temporary cloud server to facilitate the importing instead of shutting down any of your existing servers.<\/p>\n\n\n\n
It\u2019s also possible to use Storage Import via your UpCloud API<\/a>.<\/p>\n\n\n\n
Get started by going to the Storage<\/em> tab in your cloud server settings and scrolling down to the Storage<\/em> list. Below the storage devices, you\u2019ll find buttons to create new and attach existing storage.<\/p>\n\n\n\n
$\"Storage$ <\/figure>\n\n\n\n
Click the Add from URL<\/em> button to get started.<\/p>\n\n\n\n
\n
Enter the URL where your target file is located. Include any credentials at the beginning of the URL if your file is password protected. E.g. https:\/\/username:password@<\/span>example.com\/files\/system.img<\/li>\n\n\n\n
Set the label for the new storage device with something recognisable.<\/li>\n\n\n\n
Select the storage device size to be the same or larger than your target file.<\/li>\n\n\n\n
Choose the device type, either MaxIOPS or HDD.<\/li>\n\n\n\n
Depending on the type of file you are about to upload, you might wish to already select a different storage controller. VirtIO is the default and provides the best performance but older storage images may require you to use IDE for compatibility. You can also choose CDROM if you are uploading an installation ISO.<\/li>\n<\/ul>\n\n\n\n
$\"Storage$ <\/figure>\n\n\n\n
Once done, click the Add storage device<\/em> button to begin the upload.<\/p>\n\n\n\n
$\"Storage$ <\/figure>\n\n\n\n
Then kick back and relax while we do the rest!<\/p>\n\n\n\n
Setting password protection using Basic Auth<\/h2>\n\n\n\n
We recommend using Basic Auth password protection when preparing files and images for import. This needs to be done on the webserver that is hosting your files and the steps will differ depending on the operating system and web server in use. Here we\u2019ve outlined some of the options you have for setting password protection on files and folders on your web server.<\/p>\n\n\n\n
Start by installing Apache2 utils. The utils package includes a password generator tool which we\u2019ll be using to encode the credentials.<\/p>\n\n\n\n
sudo apt install apache2-utils<\/pre>\n\n\n\n
Afterwards, continue below with the instructions applicable to your web server.<\/p>\n\n\n\n
Apache2<\/h3>\n\n\n\n
Generate a password file using the `htpasswd<\/tt> command as shown below. Replace the username<\/span> with whatever you want to use. On running the command, you will be asked to set the password, and enter it twice when prompted.<\/p>\n\n\n\n`
sudo htpasswd -c \/etc\/apache2\/.htpasswd username<\/span><\/pre>\n\n\n\nNew password:\nRe-type new password:\nAdding password for user username<\/pre>\n\n\n\nNext, edit your site configuration. The file name will differ depending on your set up but it\u2019s generally stored in \/etc\/apache2\/sites-available\/<\/tt> and ends in .conf<\/tt> file type notation.<\/p>\n\n\n\n sudo nano \/etc\/apatche2\/sites-available\/example.conf<\/span><\/pre>\n\n\n\nOnce you\u2019ve opened the file for editing, add the following authentication parameters as shown below if not already present. You may need to add the <Directory \u201c\/path\/to\/html\u201d><\/em> segment if your configuration does not contain one. You can set the path to your webroot to enable authentication site-wide.<\/p>\n\n\n\n VirtualHost :80>\n ...\n <Directory \"\/var\/www\/html\">\n AuthName \"Restricted\"\n AuthType Basic\n AuthBasicProvider file\n AuthUserFile \"\/etc\/apache2\/.htpasswd\"\n Require valid-user\n ...\n <\/Directory><\/pre>\n\n\n\nAlternatively, if you want to only enable authentication for a specific folder, set the directory with the path to the folder containing your private files. Otherwise include the same parameters.<\/p>\n\n\n\n VirtualHost :80>\n ...\n <Directory \"\/var\/www\/html\/files<\/span>\"><\/pre>\n\n\n\nWhen done, save the file and exit the editor.<\/p>\n\n\n\n Then reload the webserver.<\/p>\n\n\n\n sudo systemctl reload apatche2<\/pre>\n\n\n\nDone! You should now be prompted for credentials when browsing to the password-protected URL.<\/p>\n\n\n\n Nginx<\/h3>\n\n\n\nWe\u2019ll use the htpasswd<\/em> installed above also with nginx web servers. Run the following command to generate a password file. Replace the username<\/span> with whatever you wish. When running the command, you will be asked to set the password, and enter it twice when prompted.<\/p>\n\n\n\n sudo htpasswd -c \/etc\/nginx\/.htpasswd username<\/span><\/pre>\n\n\n\nNew password:\nRe-type new password:\nAdding password for user username<\/pre>\n\n\n\nOnce you\u2019ve generated the password file, you\u2019ll need to set it in your web server configuration file. The file name will differ depending on your website but it\u2019s generally stored in \/etc\/nginx\/sites-available\/<\/tt> and ends in .conf<\/tt> file type notation.<\/p>\n\n\n\n sudo nano \/etc\/nginx\/sites-available\/example.conf<\/span><\/pre>\n\n\n\nWith the website configuration open for edit, set enable authentication by adding the two parameters as shown below. Adding these two lines directly to the server section will enable password protection for the whole site.<\/p>\n\n\n\n server {\n ...\n auth_basic \"Restricted access\";\n auth_basic_user_file \/etc\/nginx\/.htpasswd;\n ...\n<\/pre>\n\n\n\nAlternatively, you can include the authentication parameters within a location segment to set the password for a specific directory.<\/p>\n\n\n\n server {\n ...\n location \/files<\/span> {\n auth_basic \"Restricted access\";\n auth_basic_user_file \/etc\/nginx\/.htpasswd;\n }\n ...\n<\/pre>\n\n\n\nOnce done, save the file and exit the editor.<\/p>\n\n\n\n You can test that the syntax is correct before applying the changes by using the next command.<\/p>\n\n\n\n sudo nginx -t<\/pre>\n\n\n\nnginx: the configuration file \/etc\/nginx\/nginx.conf syntax is ok\nnginx: configuration file \/etc\/nginx\/nginx.conf test is successful<\/pre>\n\n\n\nIf you get a confirmation such as the one shown above, you are ready to enable the new configuration by reloading the nginx service.<\/p>\n\n\n\n sudo systemctl reload nginx<\/pre>\n\n\n\nThat\u2019s it! Your files are now set to require authentication to access and be safe from prying eyes.<\/p>\n\n\n\n Accessing password-protected files<\/h3>\n\n\n\nWhen fetching password-protected files, add your credentials at the beginning of the URL separated from the rest by an @ sign.<\/p>\n\n\n\n https:\/\/username:password@<\/span>example.com\/files\/system.img<\/pre>\n\n\n\nStorage Import should then be able to access your target file and begin uploading it.<\/p>\n\n\n\n Making use of new storage<\/h2>\n\n\n\nOnce your import has finished, you can put the new storage device to use the way you wish.<\/p>\n\n\n\n Storage image with a boot partition<\/h3>\n\n\n\nIf your storage image contains a boot partition, you can set it as the main device for a standalone cloud server.<\/p>\n\n\n\n Depending on your system storage and the previous networking setup, you may not have network access out of the box. You can use the web console at your UpCloud Control Panel or any VNC viewer to reach your cloud server<\/a> to restore connectivity.<\/p>\n\n\n\n The default network interfaces on our cloud servers include the following:<\/p>\n\n\n\n \nPublic IPv4 for internet access<\/li>\n\n\n\n Private utility network<\/li>\n\n\n\nPublic IPv6 network connection<\/li>\n<\/ul>\n\n\n\nIf you do not need all of the default network interfaces, you can detach unwanted networks to simplify your setup. Then configure the network connection<\/a> you want to use.<\/p>\n\n\n\n File storage<\/h3>\n\n\n\nStorage images that contain a file system can be mounted to any cloud server to access the files. Uploaded storage will work much the same as any other storage device allowing you to mount it at the directory point<\/a> you wish.<\/p>\n\n\n\n Installation media<\/h3>\n\n\n\nIf you uploaded installation media<\/a>, change the boot order to select CDROM as the first device and get started with the installation process at the next startup.<\/p>\n","protected":false},"featured_media":16836,"comment_status":"open","ping_status":"closed","template":"","community-category":[109,110],"class_list":["post-24884","tutorial","type-tutorial","status-publish","has-post-thumbnail","hentry","community-category-upcloud-services","community-category-storage"],"acf":[],"_links":{"self":[{"href":"https:\/\/studiogo.tech\/upcloudold\/wp-json\/wp\/v2\/tutorial\/24884","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/studiogo.tech\/upcloudold\/wp-json\/wp\/v2\/tutorial"}],"about":[{"href":"https:\/\/studiogo.tech\/upcloudold\/wp-json\/wp\/v2\/types\/tutorial"}],"replies":[{"embeddable":true,"href":"https:\/\/studiogo.tech\/upcloudold\/wp-json\/wp\/v2\/comments?post=24884"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/studiogo.tech\/upcloudold\/wp-json\/wp\/v2\/media\/16836"}],"wp:attachment":[{"href":"https:\/\/studiogo.tech\/upcloudold\/wp-json\/wp\/v2\/media?parent=24884"}],"wp:term":[{"taxonomy":"community-category","embeddable":true,"href":"https:\/\/studiogo.tech\/upcloudold\/wp-json\/wp\/v2\/community-category?post=24884"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}

Making use of new storage<\/h2>\n\n\n\n
Once your import has finished, you can put the new storage device to use the way you wish.<\/p>\n\n\n\n

File storage<\/h3>\n\n\n\n
Storage images that contain a file system can be mounted to any cloud server to access the files. Uploaded storage will work much the same as any other storage device allowing you to mount it at the directory point<\/a> you wish.<\/p>\n\n\n\n

Apache2<\/h3>\n\n\n\nGenerate a password file using the htpasswd<\/tt> command as shown below. Replace the username<\/span> with whatever you want to use. On running the command, you will be asked to set the password, and enter it twice when prompted.<\/p>\n\n\n\n

Making use of new storage<\/h2>\n\n\n\nOnce your import has finished, you can put the new storage device to use the way you wish.<\/p>\n\n\n\n

File storage<\/h3>\n\n\n\nStorage images that contain a file system can be mounted to any cloud server to access the files. Uploaded storage will work much the same as any other storage device allowing you to mount it at the directory point<\/a> you wish.<\/p>\n\n\n\n

Making use of new storage<\/h2>\n\n\n\n
Once your import has finished, you can put the new storage device to use the way you wish.<\/p>\n\n\n\n

File storage<\/h3>\n\n\n\n
Storage images that contain a file system can be mounted to any cloud server to access the files. Uploaded storage will work much the same as any other storage device allowing you to mount it at the directory point<\/a> you wish.<\/p>\n\n\n\n