Update features list
And Quick Start intro
|16 hours ago|
|.github/ISSUE_TEMPLATE||1 month ago|
|author||4 days ago|
|cmd/writefreely||3 weeks ago|
|config||4 days ago|
|keys||1 month ago|
|less||3 weeks ago|
|page||1 month ago|
|pages||1 week ago|
|parse||1 month ago|
|static||4 days ago|
|templates||4 days ago|
|.dockerignore||3 weeks ago|
|.gitignore||1 week ago|
|.travis.yml||2 months ago|
|AUTHORS.md||2 weeks ago|
|CONTRIBUTING.md||1 month ago|
|Dockerfile||1 week ago|
|LICENSE||1 month ago|
|Makefile||6 days ago|
|README.md||15 hours ago|
|account.go||3 weeks ago|
|activitypub.go||2 weeks ago|
|admin.go||4 days ago|
|app.go||1 day ago|
|auth.go||1 month ago|
|cache.go||1 month ago|
|collections.go||3 weeks ago|
|config.ini.example||4 weeks ago|
|database.go||4 days ago|
|docker-compose.yml||4 weeks ago|
|docker-setup.sh||4 weeks ago|
|errors.go||1 month ago|
|export.go||3 weeks ago|
|feed.go||3 weeks ago|
|handle.go||3 weeks ago|
|hostmeta.go||1 month ago|
|instance.go||3 weeks ago|
|keys.go||1 month ago|
|nodeinfo.go||1 week ago|
|pad.go||1 week ago|
|pages.go||3 weeks ago|
|postrender.go||1 month ago|
|posts.go||1 week ago|
|read.go||4 days ago|
|request.go||1 month ago|
|routes.go||4 days ago|
|schema.sql||5 days ago|
|session.go||1 month ago|
|sitemap.go||3 weeks ago|
|sqlite.sql||5 days ago|
|templates.go||3 weeks ago|
|unregisteredusers.go||1 month ago|
|users.go||3 weeks ago|
|webfinger.go||1 month ago|
<a href="https://writefreely.org"><img src="https://writefreely.org/img/writefreely.svg" width="350px" alt="Write Freely" /></a>
<a href="https://github.com/writeas/writefreely/releases/"> <img src="https://img.shields.io/github/release/writeas/writefreely.svg" alt="Latest release" /> </a> <a href="https://goreportcard.com/report/github.com/writeas/writefreely"> <img src="https://goreportcard.com/badge/github.com/writeas/writefreely" alt="Go Report Card" /> </a> <a href="https://travis-ci.org/writeas/writefreely"> <img src="https://travis-ci.org/writeas/writefreely.svg" alt="Build status" /> </a> <a href="http://webchat.freenode.net/?channels=writefreely"> <img alt="#writefreely on freenode" src="https://img.shields.io/badge/freenode-%23writefreely-blue.svg" /> </a>
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 light enough to run on a Raspberry Pi.
WriteFreely has minimal requirements to get up and running — you only need to be able to run an executable.
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) Configure your blog ./writefreely --config # 2) (if you chose MySQL in the previous step) Log into MySQL and run: # CREATE DATABASE writefreely; # 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.
WriteFreely is available in these package repositories:
Ready to hack on your site? Here's a quick overview.
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
If you'd like to use Docker as a base for working on a site's styles and such, you can run the following from a Bash shell.
Note: This process is intended only for working on site styling. If you'd like to run Write Freely in production as a Docker service, it'll require a little more work.
docker-setup.sh script will present you with a few questions to set up
your dev instance. You can hit enter for most of them, except for "Admin username"
and "Admin password." You'll probably have to wait a few seconds after running
docker-compose up -d for the Docker services to come up before running the
docker-compose up -d ./docker-setup.sh
Now you should be able to navigate to http://localhost:8080 and start working!
When you're completely done working, you can run
docker-compose down to destroy
your virtual environment, including your database data. Otherwise,
will shut down your environment without destroying your data.
Write Freely doesn't yet provide an official Docker pathway to production. We're working on it, though!
Before contributing anything, please read our Contributing Guide. It describes the correct channels for submitting contributions and any potential requirements.
Licensed under the AGPL.