The Mind
Back to all posts

Setting up Writebook for Technical Docs on Digital Ocean

Quick guide for setting up Writebook for Technical Documentation use cases

June 16, 2025 5 mins read

Prerequisites

You will need:

  • A valid domain name 
  • A VPS on a cloud Service Provider of your choice like Greenhost, Digital Ocean or even Linode Akamai
  • Writebook license- you can get it directly for free from ONCE. The sign up email contains your unique link that handles all set up tasks.

Sign up for Digital Ocean

I made sure to grab the $200 free credit from Digital Ocean, should give me enough free compute that should easily last me 60 days for other random experiments on Digital Ocean as well.

Creating a dedicated Project for my experiments 

Entered the needed details on the Create Project modal and pressed the create button. Always great to create Projects to stay organized.

Digital Ocean Project Creation

No need to move anything as I don’t have resources for now - so I skip this for now.

Skip Moving Resources

Our project is all set up now.

Project Setup Complete

Creating a Droplet

At the top menu on Digital Ocean, simply, click on Create > Droplets

Create Droplet Menu

Choosing VPS Location

Now we have the modal that allows us to create a Droplet and the first thing we decide on is the location of our server - I went with Amsterdam - because GDPR!Amsterdam Location Selection

Choosing Datacenter

For Datacenter, we leave it as the default 

Datacenter Default Selection

Choosing an Image for our VPS

Time to choose an image for our server - I have always been in love with using Ubuntu for production, so Ubuntu always. Always make sure to use LTS.

Ubuntu LTS Selection

Selecting VPS Specs

Time to select specs for our server, we only need about 2GB RAM for our Writebook installation - and that is exactly what I will get to save on compute credits for more experiments.

Server Specs 2GB RAM

Configuring Backups

We want backups for our server, so we get some - I get the daily backups

Daily Backups Configuration

I want backups to happen when I am asleep! 

Backup Schedule Settings

Configuring SSH

I set up the SSH key of my server and configure it on DO 

SSH Key Setup

Finalizing and Creating VPS

And we finalize details of the set up - we review key details then create the droplet 

Finalize Droplet Details

Once you click Create Droplet , the VPS will be set up with our configuration

VPS Created

Our VPS is now up and running - time to cook! 🧑🏾‍🍳

VPS Running Status

Domain set up 

This is a crucial step - it’s important to set up your domain/sub-domain and directly link it to your VPS

This is quite a simple step, all you have to do is go over to where you usually manage your domain, could be Godaddy, Namecheap or even Squarespace. Sign in and look for a link to manage the domain. 

Add A Record to point to your VPS

You need to add an A Record that points to the IP address of your VPS/Droplet - it will look something like this 

manual.yourdomain.com | A | IP Address of your VPS

Adding the domain to the VPS

Now on Digital Ocean, you’re technically not done - you need to manually add the VPS to the domain - click on create > Domains/DNS 

Create Domains DNS

Then add the A record you chose/set up and make sure you select the right project 

Add A Record Configuration

On the next page, Digital Ocean will generate Nameserver DNS details you should add to wherever you manage your DNS records. 

That’s it! Now it’s time to go and set up Writebook in the VPS. 

Setting up Writebook in VPS

SSH into VPS and run updates + updates

We can now SSH into our server!

SSH Connection to Server

First things first, run some updates & upgrades

System Update Command

System Upgrade Process

Let’s actually reboot our server 

Server Reboot Terminal

We do this via the UI (I do this on first reboots to allow me to track how long this process takes on average - I usually calculate time to live as a metric even on personal projects/experiments)

Reboot UI Option

Now turn it back on again

Turn On Server Button

Confirm we are up to date 

Confirm Updates Complete

Now let’s cook some more!

Configuring Writebook

First, as highlighted previously in the prerequisites, you need a licence to run Writebook - you can get it directly for free from ONCE 

Writebook Once License Page

Go through the checkout process to completion - you will get a confirmation email 

Confirmation Email Receipt

You will also get another follow up email with set up instructions - that breaks down how to set up

Now once we have our install link - simply go and ssh into server and paste the link 

Install Link in SSH

We enter the domain name we attached to our VPS

Enter Domain Name Prompt

It will run to completion and tell us this!

Installation Complete Message

That’s it, job is finished!