docs: add guide to hosting on Netlify and CloudFlare (#1302)
This commit is contained in:
parent
a81e8742d1
commit
1f427e2538
59
docs/content/2.deployment/1.netlify.md
Normal file
59
docs/content/2.deployment/1.netlify.md
Normal file
|
@ -0,0 +1,59 @@
|
|||
# Netlify and Cloudflare
|
||||
|
||||
Want to host Elk for your Mastodon instance? You came to the right place!
|
||||
|
||||
For this guide we're going to use Netlify for hosting the app, and Cloudflare for key value storage. Both of which can be used on their free tiers if your instance is small.
|
||||
|
||||
## Forking Elk
|
||||
|
||||
In order to use Netlify with Elk, we'll need to fork the Elk repo.
|
||||
|
||||
Fork the repository from [https://github.com/elk-zone/elk](https://github.com/elk-zone/elk). Make sure you deselect "Copy the main branch only" if you want to use the stable `release` branch.
|
||||
![The settings to use for forking the Elk repository](/docs/images/selfhosting-guide/github-fork.png)
|
||||
|
||||
## Importing the Elk repo into Netlify
|
||||
|
||||
On the main page of your Netlify dashboard, press the "Import from GitHub" button. Point it to your Elk fork.
|
||||
|
||||
On the third page with Site settings, change the "Branch to deploy" to `release` if you wish. Press "Deploy site".
|
||||
|
||||
That's one step done! Keep the tab open while we hop over to CloudFlare for a bit.
|
||||
|
||||
## Setting up CloudFlare Workers KV
|
||||
|
||||
From your CloudFlare dashboard, open "Workers". If this is your first time opening this tab, CloudFlare will ask you to set up a free custom Cloudflare Workers subdomain. Follow the instructions.
|
||||
|
||||
Go to "KV" and create a new namespace.
|
||||
|
||||
Then go to "Overview" and click on API tokens. We want to create an API token that will let Elk modify our newly made Worker. Click on "Create token" and then in the Custom token section click "Get started".
|
||||
|
||||
The only permission that we'll need is to edit the Workers KV Storage.
|
||||
![The settings to use for the CloudFlare API token](/docs/images/selfhosting-guide/cf-api-token-settings.png)
|
||||
|
||||
Save the newly made token in a safe spot. Keep the tab open while we'll configure the environment variables on Netlify.
|
||||
|
||||
## Setting the environment variables on Netlify
|
||||
|
||||
On your project page, go to "Site settings", and open the "Environment variables" section.
|
||||
|
||||
There are 5 environment variables to add.
|
||||
|
||||
| Environment variable | What it is |
|
||||
|---|---|
|
||||
| NUXT_CLOUDFLARE_ACCOUNT_ID | This is your CloudFlare Account ID. You can find it in "Workers > Overview". |
|
||||
| NUXT_CLOUDFLARE_API_TOKEN | Put your CloudFlare API token here. |
|
||||
| NUXT_CLOUDFLARE_NAMESPACE_ID | This is your CloudFlare KV Namespace ID. You can find it in "Workers > KV". |
|
||||
| NUXT_STORAGE_DRIVER | Because we're using CloudFlare, we'll need to set this to `cloudflare`. |
|
||||
| NUXT_PUBLIC_DEFAULT_SERVER | This is the address of the Mastodon instance that will show up when a user visits your Elk deployment and is not logged in. If you don't make that variable, it will point to `m.webtoo.ls` by default. |
|
||||
|
||||
That's it! All that's left to do is...
|
||||
|
||||
## Deploy Elk!
|
||||
On your project page open the Deploys tab, click on "Trigger deploy" and "Deploy site". In a few minutes Elk should be up and running!
|
||||
|
||||
## Use a custom domain
|
||||
If you want to use a custom domain, go to "Domain settings" on your Netlify project page, and press "Add custom domain". If your domain is not bought from Netlify, it will ask you to add a CNAME record. Do that.
|
||||
|
||||
Once the custom domain is added, you'll need to add an SSL/TLS certificate. At the bottom of the page press "Verify DNS configuration" and if it succeeds, press "Provision certificate". If that fails, you may need to wait some time until your DNS propagetes.
|
||||
|
||||
And that's it! Enjoy your instance's Elk!
|
BIN
docs/public/images/selfhosting-guide/cf-api-token-settings.png
Normal file
BIN
docs/public/images/selfhosting-guide/cf-api-token-settings.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 33 KiB |
BIN
docs/public/images/selfhosting-guide/github-fork.png
Normal file
BIN
docs/public/images/selfhosting-guide/github-fork.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 27 KiB |
Loading…
Reference in a new issue