mirror of
https://github.com/immich-app/immich.git
synced 2025-06-06 23:24:50 -04:00
Created [Community] Immich OCI Free Tier ARM Ubuntu 22.04 VM Tutorial by Jay2 (markdown)
Alex
parent
a15361d660
commit
b995d68f61
@ -0,0 +1,233 @@
|
|||||||
|
|
||||||
|
This tutorial is intended for both Oracle Cloud and Linux command line beginners, all steps and commands will be included.
|
||||||
|
|
||||||
|
When you’ve finished these steps, you’ll have an always-free virtual machine that you can access from anywhere with a 2.4Ghz quad-core ARM64 CPU, 24GB RAM, 200GB SSD, and 4Gbps connectivity, 10TB per month outgoing traffic, and Unlimited incoming traffic.
|
||||||
|
|
||||||
|
## What You’ll Need:
|
||||||
|
* [PuTTY (free)](https://the.earth.li/~sgtatham/putty/latest/w64/putty-64bit-0.77-installer.msi)
|
||||||
|
* [Oracle Cloud Infrastructure (“OCI”) Account (Credit Card Required - You will never be billed if you follow this guide)](https://www.oracle.com/ca-en/cloud/free/)
|
||||||
|
|
||||||
|
## Steps:
|
||||||
|
1. Sign in to OCI and click the hamburger menu
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
2. Select ‘Compute’ and then ‘Instances’
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
3. Click ‘Create Instance’
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
4. On the ‘Create compute instance’ page, make the following changes:
|
||||||
|
* ‘Placement’
|
||||||
|
* Leave as default.
|
||||||
|
* ‘Image and shape’
|
||||||
|
* Click the ‘Edit’ button on the ‘Image’ section
|
||||||
|
* Click the "Change image" button
|
||||||
|
* Choose "Canonical Ubuntu"
|
||||||
|
* Click the ‘Select image’ button
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* Click the ‘Change Shape’ button on the ‘Shape’ section
|
||||||
|
* Click the‘ Change shape’ button
|
||||||
|
* Choose ‘Ampere’
|
||||||
|
* Select ‘VM.Standard.A1.Flex’
|
||||||
|
* Drag ‘Number of OCPUs slider to ‘4’
|
||||||
|
* Drag ‘Amount of memory (GB)’ slider to ‘24’
|
||||||
|
* Click ‘Select shape’ button
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* ‘Networking’
|
||||||
|
* Leave as default.
|
||||||
|
* ‘Add SSH keys’
|
||||||
|
* Click on the ‘Paste public keys’ radial button
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* Install PuTTY if you haven’t already and open ‘PuTTYGen’.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* Click the ‘Generate’ button and move the mouse randomly until the green bar is full.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* Select All of the text (right-click ‘Select All’) in the PuTTYGen ‘Public key for pasting…’ text box
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* Copy to clipboard (right-click ‘Copy’)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* Paste (right-click ‘Paste’) in to the ‘SSH keys’ text box on the OCI ‘Add SSH keys’ section
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* In ‘PuTTYGen’ window, click ‘Save private key’ button. Choose whatever file name you want and save this file in a safe place. PuTTYGen will ask you if you’re sure you want to save without a passphrase - choose ‘Yes’.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
5. ‘Boot Volume’
|
||||||
|
* Click ‘Specify a custom boot volume size’
|
||||||
|
* Enter ‘200’ in ‘Boot volume size (GB)’ text box
|
||||||
|
* Click ‘Create’ button
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
6. Wait 1-2 minutes for VM provisioning to complete. When complete, yellow provisioning box will turn green. Once green, you can proceed with next steps.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
7. In the ‘Primary VNIC’ section, click link beside ‘Subnet:’
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
8. In the ‘Security Lists’ section click the ‘Default Security List…’ link
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
9. Click ‘Add Ingress Rules’ button
|
||||||
|
|
||||||
|
10. Fill out the ‘Ingress Rule’ form:
|
||||||
|
* Stateless: Unchecked
|
||||||
|
* Source Type: CIDR
|
||||||
|
* Source CIDR: 0.0.0.0/0
|
||||||
|
* IP Protocol: TCP
|
||||||
|
* Source Port Range: [blank]
|
||||||
|
* Destination Port Range: 2283
|
||||||
|
* Description: Immich
|
||||||
|
|
||||||
|
11. Click ‘Add Ingress Rules’ button
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
12. Click hamburger menu > Compute > Instance
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
13. Select instance
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
14. Click the ‘Copy’ link beside "Public IP Address"
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
15. Open PuTTY
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
16. Paste Public IP Address into ‘Host Name’ text box
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
17. On left-hand side of PuTTY window expand ‘SSH’ menu and click ‘Auth’
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
18. Click ‘Browse’ button, browse to the location that you saved your private key file in PuTTYGen and click the open button
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
19. On left hand side of PuTTY window select ‘Session’, enter any name you’d like in to ‘Saved Sessions’ text box and click ‘Save’ button
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
20. Double click the new session and click ‘Accept’ on the PuTTY Security Alert prompt
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
21. log in as: ubuntu
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
22. Enter the following commands in the order listed. You must enter them 1 at a time. You can copy (highlight > right-click ‘Copy’) from this document and paste it into the PuTTY window (right-click). If at any point you are prompted with a bright pink ‘Package configuration’ screen, push tab-enter to select ‘Ok’ and continue with the following steps.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo -i
|
||||||
|
|
||||||
|
|
||||||
|
apt update
|
||||||
|
|
||||||
|
|
||||||
|
apt upgrade -y
|
||||||
|
|
||||||
|
|
||||||
|
apt install net-tools ca-certificates curl gnupg lsb-release
|
||||||
|
|
||||||
|
|
||||||
|
mkdir -p /etc/apt/keyrings
|
||||||
|
|
||||||
|
|
||||||
|
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
|
||||||
|
|
||||||
|
|
||||||
|
echo \
|
||||||
|
|
||||||
|
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
|
||||||
|
|
||||||
|
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
|
||||||
|
|
||||||
|
|
||||||
|
apt update
|
||||||
|
|
||||||
|
|
||||||
|
apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin -y
|
||||||
|
|
||||||
|
|
||||||
|
mkdir immich-main
|
||||||
|
|
||||||
|
|
||||||
|
mkdir immich-photos
|
||||||
|
|
||||||
|
|
||||||
|
cd immich-main
|
||||||
|
|
||||||
|
|
||||||
|
wget https://raw.githubusercontent.com/immich-app/immich/main/docker/docker-compose.yml
|
||||||
|
|
||||||
|
|
||||||
|
wget https://raw.githubusercontent.com/immich-app/immich/main/docker/.env.example
|
||||||
|
|
||||||
|
|
||||||
|
cp .env.example .env
|
||||||
|
|
||||||
|
|
||||||
|
nano .env
|
||||||
|
```
|
||||||
|
|
||||||
|
*Use arrow keys to navigate down to ‘Upload File Config’ section and set ‘UPLOAD_LOCATION’ to /root/immich-photos
|
||||||
|
*Navigate to ‘JWT SECRET’ section and set ‘JWT_SECRET’ to some random string of characters (see image below for example
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* Navigate to ‘WEB - Required’ section
|
||||||
|
* Open another PuTTY window, click on your saved session and click ‘Load’ button. Take note of the IP address in the ‘Host Name’ text box.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* Set ‘VITE_SERVER_ENDPOINT’ to http://<ip address>:2283/api (see pic for example)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
* Press ‘CTRL-X’ and then ‘Y’ and then ‘Enter’ to save
|
||||||
|
* Enter command: docker compose up -d
|
||||||
|
* Wait at least 2 minutes
|
||||||
|
* Close PuTTY
|
||||||
|
* Open Windows Browser and navigate to: http://<ip address>:2283
|
||||||
|
* Done! If you enjoy Immich please consider buying Alex a coffee :)
|
||||||
|
[https://www.buymeacoffee.com/altran1502](https://www.google.com/url?q=https://www.buymeacoffee.com/altran1502&sa=D&source=editors&ust=1659666519556192&usg=AOvVaw0TDie7KOtkBgzMIoCrAHDU)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Loading…
x
Reference in New Issue
Block a user