writefreely/README.md

 

---

 

WriteFreely is a beautifully pared-down blogging platform that's simple on the surface, yet powerful underneath.

It's designed to be flexible and share your writing widely, so it's built around plain text and can publish to the fediverse via ActivityPub. It's easy to install and lightweight.

Start a blog on our instance

Try the editor

Find another instance

Features

• Start a blog for yourself, or host a community of writers
• Form larger federated networks, and interact over modern protocols like ActivityPub
• Write on a dead-simple, distraction-free and super fast editor
• Publish drafts and let others proofread them by sharing a private link
• Build more advanced apps and extensions with the well-documented API

Quick start

Note

this is currently alpha software. We're quickly moving out of this v0.x stage, but while we're in it, there are no guarantees that this is ready for production use.

First, download the latest release for your OS. It includes everything you need to start your blog.

Now extract the files from the archive, change into the directory, and do the following steps:

# 1) Log into MySQL and run:
# CREATE DATABASE writefreely;
#
# 2) Configure your blog
./writefreely --config

# 3) Import the schema with:
./writefreely --init-db

# 4) Generate data encryption keys
./writefreely --gen-keys

# 5) Run
./writefreely

# 6) Check out your site at the URL you specified in the setup process
# 7) There is no Step 7, you're done!

For running in production, see our guide.

Development

Ready to hack on your site? Here's a quick overview.

Prerequisites

• Go 1.10+
• Node.js

Setting up

go get github.com/writeas/writefreely/cmd/writefreely

Configure your site, create your database, and import the schema as shown above. Then generate the remaining files you'll need:

make install # Generates encryption keys; installs LESS compiler
make ui      # Generates CSS (run this whenever you update your styles)
make run     # Runs the application

Using Docker

From the cloned git repository, you can quickly stand up a Write Freely instance with Docker and Docker Compose.

First, you'll need to change the password for MariaDB's root user in docker-compose.yml from changeme to something that is unique to your setup:

environment:
  - MYSQL_ROOT_PASSWORD=changeme

After that, you can spin up the containers and configure them:

# 1) Spin up the DB and Write Freely
docker-compose up -d

# 2) Connect to MariaDB container
docker-compose exec db /bin/sh

# 3) Log in to MariaDB, using the password you specified in docker-compose.yml
mysql -u root -p

# 4) Create the database for Write Freely
CREATE DATABASE writefreely;
exit

# 5) Migrate the database
mysql -u root -p writefreely < /tmp/schema.sql
exit

# 6) Generate the configuration and clean up
docker-compose run web writefreely --config
docker stop writefreely_web_run_1 && docker rm writefreely_web_run_1

Now you should be able to navigate to http://localhost:8080 and start blogging!

License

Licensed under the AGPL.