Viren070/guides
1
0
Fork 0
mirror of https://github.com/Viren070/guides.git synced 2025-12-01 23:16:16 +01:00
Code Issues Packages Projects Releases Wiki Activity

feat: update oracle guide with new images, simplified windows terminal profile guide, and added warning

Browse Source
This commit is contained in:
Viren070
2025-07-08 15:07:25 +01:00
parent 7952b57cc7
commit c00375d430
4 changed files with 97 additions and 97 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/selfhosting/oracle.mdx
+97 -97
View File
@@ -11,6 +11,8 @@ keywords: [viren070, guides, viren070's guides]
Oracle Cloud offers a Compute Instance with 4 OCPUs, 24GB RAM, and 200GB storage within their "Always Free" resources.
This guide will show you how to set that up.
Find the details and confirm the current offerings on the [Oracle Cloud Free Tier page](https://www.oracle.com/cloud/free/) and the [Resources](https://docs.oracle.com/en-us/iaas/Content/FreeTier/freetier_topic-Always_Free_Resources.htm) page.
A VPS can be used for a variety of purposes, such as hosting a website, running a game server, or even as a remote desktop.
You can even use it to host all your [Stremio](/stremio/) addons and a debrid media server.
@@ -18,6 +20,16 @@ You can even use it to host all your [Stremio](/stremio/) addons and a debrid me
To use the Oracle Cloud Free Tier, you need a valid credit/debit card. Virtual/Prepaid cards are not accepted.
:::
:::danger
Although it is impossible to get charged while on the Free tier, please keep in mind that if you upgrade to a Pay-As-You-Go (PAYG) account, you will be charged for any resources you use that are not covered by the Free Tier.
Therefore, it is imperative to ensure that you set your instance up exactly as described in this guide, and that you do not use any resources that are not covered by the Free Tier.
Make sure you do not have any extra instances, volumes etc. created at any given time. The free tier resources cover 200GB of total boot volume space, and exactly 1 A1 Flex instance with 4 OCPUs and 24GB RAM.
If you create any additional resources, you will be charged for them.
If you do set everything up correctly, the only thing you can be charged for is bandwidth. Ingress bandwidth is unlimited and free, but egress bandwidth is limited to 10TB per month. If you exceed this limit, you will be charged.
:::
## Setup
### Creating our VM instance
@@ -48,7 +60,9 @@ To use the Oracle Cloud Free Tier, you need a valid credit/debit card. Virtual/P
![Oracle Cloud Dashboard](/img/oracle/dashboard.png)
3. Give your instance a name.
#### Basic Information
3. Give your instance a name, and the compartment option can be left as is.
4. Configure the image and shape
@@ -59,58 +73,84 @@ To use the Oracle Cloud Free Tier, you need a valid credit/debit card. Virtual/P
2. Just below the image, you will see the `Shape` section. Click on `Change Shape` and select the `Ampere` series `VM.Standard.A1.Flex` shape. Set the OCPUs to 4, and the memory to 24GB.
![Change Shape](/img/oracle/select_shape.png)
5. Generate an SSH key pair. If you already have an SSH key pair, you can skip this step.
3. To proceed to the next step, click the 'Next' button at the bottom right corner of the page.
1. Open a terminal on your local machine.
2. Run the following command to generate an SSH key pair, replacing `your_email@example.com` with your email address.
#### Security
```bash
ssh-keygen -t ed25519 -C "your_email@example.com"
```
This section requires no adjustments, so we can skip it by clicking the 'Next' button at the bottom right corner of the page.
- When prompted for which file to save the key in, press `Enter` to save it in the default location. If you already have an SSH key pair, you can save it in a different location. But make sure to remember where you saved it.
- When prompted to enter a passphrase, you **should** enter one. You can generate a passphrase using a password manager like [Bitwarden](https://bitwarden.com/) or [Proton Pass](https://proton.me/pass).
#### Networking
<br/ >
:::info
On older systems, where the ed25519 algorithm is not supported, you can use the rsa algorithm:
5. Configure your VNIC
```bash
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
```
1. Give your VNIC a name.
2. Under `Primary Network`, select `Create new virtual cloud network`.
3. Under `Subnet`, select `Create new public subnet`.
:::
6. Generate an SSH key pair. If you already have an SSH key pair, you can skip this step.
3. We will now need to add our SSH key to our SSH agent. Before we do that, we need to start the SSH agent. Open a new **Administrator** PowerShell window and run the following commands:
```
Get-Service -Name ssh-agent | Set-Service -StartupType Automatic
Start-Service ssh-agent
```
4. Run the following command in your **non-administrator** terminal to add your SSH key to the SSH agent:
1. Open a terminal on your local machine.
2. Run the following command to generate an SSH key pair, replacing `your_email@example.com` with your email address.
```bash
ssh-add C:/Users/your_username/.ssh/id_ed25519
```
```bash
ssh-keygen -t ed25519 -C "your_email@example.com"
```
- If you saved your SSH key in a different location, replace `C:/Users/your_username/.ssh/id_ed25519` with the path to your SSH key.
- When prompted for which file to save the key in, press `Enter` to save it in the default location. If you already have an SSH key pair, you can save it in a different location. But make sure to remember where you saved it.
- When prompted to enter a passphrase, you **should** enter one. You can generate a passphrase using a password manager like [Bitwarden](https://bitwarden.com/) or [Proton Pass](https://proton.me/pass).
5. You will now have two files in your `~/.ssh` directory: `id_ed25519` and `id_ed25519.pub`. The `.pub` file is your public key, which you will need for the next step.
<br/ >
:::info
On older systems, where the ed25519 algorithm is not supported, you can use the rsa algorithm:
6. In the `Add SSH keys` section, click the `Upload public key files (.pub)` button and upload the `.pub` file you generated in the previous step.
```bash
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
```
7. Configure our boot volume.
:::
1. Scroll down to `Boot volume` and check the `Specify a custom boot volume size` box.
2. Set the boot volume size to 200.
3. Set the `Boot volume performance to `120`.
3. We will now need to add our SSH key to our SSH agent. Before we do that, we need to start the SSH agent. Open a new **Administrator** PowerShell window and run the following commands:
```
Get-Service -Name ssh-agent | Set-Service -StartupType Automatic
Start-Service ssh-agent
```
4. Run the following command in your **non-administrator** terminal to add your SSH key to the SSH agent:
:::note
At this point, you may see that you have an estimated cost which is not free.
This is because the cost estimator does not take into account the 200GB Free Tier discount.
You can confirm this at Oracle's [Cost Estimator](https://www.oracle.com/uk/cloud/costestimator.html) page.
:::
```bash
ssh-add C:/Users/your_username/.ssh/id_ed25519
```
8. Finally, click on `Create` to create your VM instance.
- If you saved your SSH key in a different location, replace `C:/Users/your_username/.ssh/id_ed25519` with the path to your SSH key.
5. You will now have two files in your `~/.ssh` directory: `id_ed25519` and `id_ed25519.pub`. The `.pub` file is your public key, which you will need for the next step.
7. In the `Add SSH keys` section, click the `Upload public key files (.pub)` button and upload the `.pub` file you generated in the previous step. Then, click `Next` again to proceed to the next step.
#### Storage
8. Configure our boot volume.
1. Click the switch on the `Specify a custom boot volume size and performance` option to enable it.
2. Set the `Boot volume size` to 200.
3. Set the `Boot volume performance to `120`.
4. Click on `Next` to proceed to the next step.
#### Review
9. Review your configuration thoroughly. The key points to check are
- The `Image` should be `Canonical Ubuntu 24.04`.
- The `Shape` should be `VM.Standard.A1.Flex` with 4 OCPUs and 24GB of memory.
- The `Boot volume size` should be a maximum 200GB.
- The `SSH keys` section should contain your public key.
:::note
If you click `View estimated cost`, you may see that the cost is not estimated to be free.
This is because the cost estimator does not take into account the 200GB Free Tier discount.
You can confirm this at Oracle's [Cost Estimator](https://www.oracle.com/uk/cloud/costestimator.html) page.
:::
10. Finally, click on `Create` to create your VM instance.
::::tip
You may encounter an `Out of capacity` error when creating your VM instance. This is because the free tier has a limited number of instances available:
@@ -119,7 +159,7 @@ You may encounter an `Out of capacity` error when creating your VM instance. Thi
You can try again later, or you can try creating the instance in a different `Availability Domain` by scrolling back up to the top to the `Placement` section.
You can also switch to a PAYG account, which will allow you to create instances without any restrictions. As long as you stay within the free tier limits, you won't be charged.
You can also set up a $1 budget alert to ensure you don't go over the free tier limits.
Setting up a $1 budget alert to ensure you get notified if you go over the free tier limits is recommended.
<details>
<summary>How to upgrade to a PAYG account</summary>
@@ -179,12 +219,12 @@ It can take up to 24 hours for the upgrade to take effect. You will receive an e
::::
9. Your instance will now begin provisioning. This can take a few minutes. Once it is done, make your way to the dashboard of your instance. You should
already be on the dashboard, but if you aren't, you can find it by clicking on the hamburger menu in the top left corner and scrolling down to `Compute` and then `Instances`.
11. Your instance will now begin provisioning. This can take a few minutes. You will be taken to the 'Work requests' tab where you will see the status of your instance creation.
Once it is complete, you will see the `State` of the `Create instance` operation change to `Succeeded`. You can then click on the `Details` tab to view the details of your instance.
### Connecting to our VPS
10. Copy the public IP address of your instance.
10. Following the previous step, you should be on the `Details` page of your instance. Copy the public IP address of your instance.
![Instance Dashboard](/img/oracle/instance_dashboard.png)
@@ -204,56 +244,14 @@ It can take up to 24 hours for the upgrade to take effect. You will receive an e
<div>
To do this:
1. Open Windows Terminal and click on the down arrow next to the tabs. Then, while holding down the `Shift` key, click on `Settings`.
2. This will open the `settings.json` file in your default text editor. It will look something like this:
```json
{
"$help": ...,
"$schema": ...,
"actions": ...,
...
"profiles": {
"defaults": {},
"list": [
...
]
}
}
```
3. Add the following profile to the `list` array in the `profiles` object, replacing `your_ip` with the public IP address of your instance:
```json
{
"closeOnExit": "never",
"name": "Oracle VPS",
"commandline": "ssh ubuntu@your_ip",
},
```
It should look something like this (the `...` represents other objects in the file, that are abstracted for brevity):
```json
{
"$help": ...,
"$schema": ...,
"actions": ...,
...
"profiles": {
"defaults": {},
"list": [
{
"closeOnExit": "never",
"name": "Oracle VPS",
"commandline": "ssh ubuntu@your_ip",
},
...
]
}
}
```
4. Save the file and close the text editor.
5. Close Windows Terminal and reopen it. When you click on the down arrow next to the tabs, you should see a new profile called `Oracle VPS`. Click on it to connect to your instance.
1. Open Windows Terminal and click on the down arrow next to the tabs. Then, click on `Settings`.
2. In the `Settings` window, Scroll all the way down to the bottom and click on `Add new profile`.
3. Click '+ New empty profile' and fill in the following details:
- `Name`: `Oracle VPS`
- `Command line`: `ssh ubuntu@your_ip`
- `Icon`: You can choose an icon if you want, or leave it as is.
4. Click on `Save` to save the profile.
5. Now, when you click on the arrow icon, you'll see the `Oracle VPS` profile in the list. You can click on it to connect to your instance without having to type the IP address every time.
</div>
</details>
:::
@@ -268,17 +266,19 @@ It can take up to 24 hours for the upgrade to take effect. You will receive an e
By default, all ports are closed on your Oracle VPS. You will need to open the ports you want to use.
1. Go to the dashboard of your instance.
2. Under `Primary VNIC`, click on the link next to `Subnet:`.
3. Under `Security Lists`, click on the `Default Security List for vcn-...`.
4. Click on `Add Ingress Rules`.
5. Fill in the following details:
2. Click on the `Networking` tab.
3. Click on the link next to `Subnet` (e.g. `subnet-20250708-1425`)
4. Go to the `Security` tab.
5. Click on the `Default Security List for vcn-...`.
6. Go to the `Security rules` tab and click on `Add Ingress Rules`.
7. Fill in the following details:
- `Source Type`: `CIDR`
- `Source CIDR`: `0.0.0.0/0`
- `IP Protocol`: `TCP`
- `Source Port Range`: `All`
- `Destination Port Range`: The port you want to open, such as `443` for HTTPS.
- `Description`: A description of the rule, such as `Allow HTTPS traffic`.
6. Click on `Add Ingress Rules`, or `Another Ingress Rule` if you want to add more rules.
8. Click on `Add Ingress Rules`, or `Another Ingress Rule` if you want to add more rules.
### Using SCP to transfer files
static/img/oracle/instance_dashboard.png
BIN
View File
Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 258 KiB

After

Width:  |  Height:  |  Size: 74 KiB

static/img/oracle/select_image.png
BIN
View File
Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 89 KiB

After

Width:  |  Height:  |  Size: 114 KiB

static/img/oracle/select_shape.png
BIN
View File
Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 113 KiB

After

Width:  |  Height:  |  Size: 144 KiB