From 91632cab51c76c487848179b1b74f3f4bbd50ddf Mon Sep 17 00:00:00 2001 From: Thomas Hintz Date: Mon, 15 Sep 2025 17:04:45 -0700 Subject: [PATCH] Updating services documentation. --- README.org | 63 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 63 insertions(+) diff --git a/README.org b/README.org index dd8a472..8bddeec 100644 --- a/README.org +++ b/README.org @@ -4,6 +4,69 @@ - [[https://www.docker.com/][docker]] - bash +** Services + +*** [[https://www.digitalocean.com/][DigitalOcean]] + +- Create a DigitalOcean account and sign in to it + +- [[https://cloud.digitalocean.com/account/api/tokens][Click "API" on sidebar]] + +- Click "generate a new token" + - enter a name (can be anything, just for you to remember) + - set expiration as you desire + - set the "scope" to "Full Access" + - save the generated token for placing in production.tfvars -> do_token + +*** [[https://www.cloudflare.com/][Cloudflare]] + +- Create a CloudFlare account and sign into it + +- Either register a new domain or if you already have a domain not being used you can continue with that + +- On sidebar to to "Manage Account" -> "Account API Tokens" + - Click "Create Token" + - Under "templates" click "edit zone dns" + - Under "Zone Resources", in the box labelled "Select..." select the domain you want to use + - Click "continue to summary" + - Click "create token" + - Copy the token for use later on for the "cloudflare_api_token" in config/production.tfvars + +- Click "Account Home" to go back to the top level + +- Click on the domain you are using + - This will show the "Overview" + - Scroll down until you see the API heading and copy the "Zone ID" and "Account ID" + + These will be used later on in config/production.tfvars for cloudflare_zone_id and cloudflare_account_id + +*** [[https://backblaze.com][Backblaze]] + +This is used automated for "off-site" backups / snapshots. + +- Create a Backblaze B2 account and sign in to it + +- Click "create a bucket" + - Give it a unique name (recommended something like [my-domain-com]-app-backups) but replace my-domain-com with your domain + - Files in bucket should be set to "Private" + - Leave "Default Encryption" as "disabled" (restic will encrypt the data) + - Leave "Object Lock" as disabled + +- Click on "Lifecycle Settings" under the newly created bucket + - Change to "Keep only the last version of the file" + - Click "Update Bucket" + +- Under the bucket details copy "Endpoint" for use later on in config/apps.config BACKBLAZE_BUCKET_URL + +- Click "Application Keys" + - Click "Add a new application key" + - "Name" can be whatever you want to remember it is a key for the backups for your apps + - Change "Allow access to buckets" to only the bucket you created in the previous step + - Leave "Type of Access" set to "Read and Write" + - Leave other options in their default values + - Click "Create new key" + - Copy/save the key for later use in config/apps.config BACKBLAZE_APPLICATION_KEY and the "keyID" for BACKBLAZE_KEY_ID + ** Configuration *** apps.config