elk/docs/content/2.deployment/1.netlify.md
2023-07-25 07:15:07 +01:00

3.5 KiB

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. 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

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

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.
NUXT_PUBLIC_SINGLE_INSTANCE If enabled it will disable signing in to servers other than the server specified in NUXT_PUBLIC_DEFAULT_SERVER
NUXT_PUBLIC_PRIVACY_POLICY_URL This is the URL to a web page with information on your privacy policy.

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!